As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Gerando um conjunto de dados usando o AWS Marketplace Serviço de análise de comércio
Depois de se inscrever no AWS Marketplace Commerce Analytics Service, você pode acessar seus relatórios de uso, assinatura e cobrança por meio do e. AWS CLI AWS SDK para Java Os dados que você solicita usando as ferramentas do SDK são entregues a você Conta da AWS como conjuntos de dados. A maioria dos conjuntos de dados corresponde aos mesmos dados dos relatórios baseados em texto disponíveis no [Portal de gerenciamento do AWS Marketplace](https://us-east-1.console.aws.amazon.com/partnercentral/home). Para obter mais informações, consulte [Acessando dados de produtos e clientes com o AWS Marketplace Serviço de análise de comércio](commerce-analytics-service.md). Essas seções fornecem informações sobre parâmetros, respostas e saídas relacionadas aos conjuntos de dados gerados pelo Serviço de análise de comércio.
**Topics**
+ [Parâmetros do `GenerateDataSet`](#generate-data-set-parameters)
+ [Respostas](#responses)
+ [Saídas](#outputs)
## Parâmetros do `GenerateDataSet`
O AWS Marketplace Commerce Analytics Service expõe um método,`GenerateDataSet`, que você pode usar para solicitar que conjuntos de dados sejam publicados em seu bucket Amazon S3. A tabela a seguir relaciona os parâmetros de `GenerateDataSet`.
**Parâmetros do conjunto de dados**
| **Campo** | **Descrição** |
| --- | --- |
| Tipo do conjunto de dados | Esse conjunto de dados será retornado como resultado da solicitação. |
| Data da publicação do conjunto de dados | A data em que um conjunto de dados foi publicado.
Para conjuntos de dados diários, forneça uma data com granularidade em nível de dia para o dia desejado.
Para conjuntos de dados mensais, forneça uma data com granularidade em nível de mês para o mês desejado. O valor day é ignorado. |
| ARN do nome da função | O ARN da função com uma política de permissões anexada que fornece ao serviço acesso a seus recursos. |
| Nome do bucket do Amazon S3 de destino | O nome (o nome amigável, não o ARN) do bucket do Amazon S3 de destino. Seus conjuntos de dados serão publicados nesse local. |
| Prefixo do Amazon S3 de destino | (Opcional) O prefixo do Amazon S3 para o conjunto de dados publicado, semelhante a um caminho de diretório em sistemas de arquivos padrão.
Por exemplo, se o nome do bucket `mybucket` e o prefixo `myprefix/mydatasets` forem fornecidos, o arquivo de saída será publicado em `s3://amzn-s3-demo-bucket/myprefix/mydatasets/outputfile`.
Se a estrutura do diretório do prefixo não existir, ela será criada.
Se nenhum prefixo for fornecido, o conjunto de dados será publicado na raiz do bucket do Amazon S3. |
| ARN do tópico do SNS | O ARN do tópico do Amazon SNS que será notificado quando o conjunto de dados tiver sido publicado ou se ocorrer um erro. |
## Respostas
O AWS Marketplace Commerce Analytics Service retorna duas respostas. A primeira é síncrona, que é gerada imediatamente, e a segunda é assíncrona, que é gerada usando o Amazon SNS. A resposta síncrona é semelhante a este exemplo.
**Parâmetros do conjunto de dados**
| **Campo** | **Descrição** |
| --- | --- |
| Data Set Request ID (ID da solicitação do conjunto de dados) | Um identificador exclusivo que representa uma solicitação específica ao serviço. Esse identificador pode ser usado para correlacionar uma solicitação com notificações no tópico do Amazon SNS. |
A resposta assíncrona é publicada como um JSON-formatted documento no seu tópico do Amazon SNS e é semelhante a este exemplo.
**Parâmetros do conjunto de dados**
| **Campo** | **Descrição** |
| --- | --- |
| Data Set S3 Location (Local do S3 do conjunto de dados) | O nome do bucket e a chave do conjunto de dados entregue. |
| Data Set Meta Data S3 Location (Local do S3 dos metadados do conjunto de dados) | O nome do bucket e a chave do arquivo de metadados do conjunto de dados entregue. |
| Data Set Request ID (ID da solicitação do conjunto de dados) | Um identificador exclusivo que representa uma solicitação específica ao serviço. Esse identificador pode ser usado para correlacionar uma solicitação com notificações no tópico do Amazon SNS. |
| Bem-sucedida | "Verdadeiro" se a operação tiver sido bem-sucedida, caso contrário, "falso". |
| Mensagem | (Opcional) Se ocorrer um erro (por exemplo, "Sucesso" for "falso"), essa mensagem conterá informações sobre a falha. |
**Exemplo de resposta JSON-formatted assíncrona**
```
{
"dataSetS3Location":{
"bucketName":"demo-bucket",
"key":"demo-prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.csv"
},
"dataSetMetaDataS3Location":{
"bucketName":"demo-bucket",
"key":"demo-prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.meta.json"
},
"dataSetRequestId":"f65b7244-6862-11e5-80e2-c5127e17c023",
"success":true
}
```
## Saídas
Após uma solicitação bem-sucedida, o conjunto de dados solicitado será entregue para seu bucket do Amazon S3 como um arquivo .csv. Um arquivo de JSON-formatted metadados é publicado no mesmo local do arquivo do conjunto de dados. O arquivo de metadados fornece informações úteis sobre o conjunto de dados e os parâmetros da solicitação original. O arquivo de metadados tem o mesmo nome que o conjunto de dados no arquivo, mas termina com a extensão .meta.json. A tabela a seguir relaciona os campos de metadados no arquivo .csv.
**Campos de metadados**
| **Campo** | **Descrição** |
| --- | --- |
| Data Set Request ID (ID da solicitação do conjunto de dados) | Um identificador exclusivo que representa uma solicitação específica ao serviço. Esse identificador pode ser usado para correlacionar uma solicitação com notificações no tópico do Amazon SNS. |
| Intervalo de cobertura do conjunto de dados | Define o início date/time e o fim date/time da faixa de cobertura de dados. Essas datas estão no formato ISO 8601. |
| Parâmetros da solicitação do conjunto de dados | Os parâmetros de solicitação originais do método GenerateDataSet. |
| Data Set S3 Location (Local do S3 do conjunto de dados) | O nome do bucket e a chave do conjunto de dados entregue. |
| Data Set Meta Data S3 Location (Local do S3 dos metadados do conjunto de dados) | O nome do bucket e a chave do arquivo de metadados do conjunto de dados entregue. |
Veja a seguir um exemplo de conteúdo de JSON-formatted metadados.
```
{
"dataSetRequestId": "43d7137b-8a94-4042-a09d-c41e87f371c1",
"dataSetCoverageRange": {
"startDateTime": "2014-06-08T00:00:00.000Z",
"endDateTime": "2014-06-08T23:59:59.000Z"
},
"dataSetRequestParameters": {
"sellerAccountId": "123412341234",
"dataSetType": "customer_subscriber_hourly_monthly_subscriptions",
"dataSetPublicationDate": "2014-06-09T00:00:00.000Z",
"roleNameArn": "arn:aws:iam::123412341234:role/MarketplaceCommerceAnalyticsRole",
"destinationS3BucketName": "demo-bucket",
"destinationS3Prefix": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions",
"snsTopicArn": "arn:aws:sns:us-west-2:123412341234:demo-topic"
},
"dataSetS3Location": {
"bucketName": "demo-bucket",
"key": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.csv"
},
"dataSetMetaDataS3Location": {
"bucketName": "demo-bucket",
"key": "demo_prefix/customer_subscriber_hourly_monthly_subscriptions_2014-06-09.meta.json"
}
}
```
Para obter uma lista completa de conjuntos de dados disponíveis, inclusive datas de disponibilidade, consulte a [Documentação do SDK da AWS](https://docs.aws.amazon.com/cli/latest/reference/marketplacecommerceanalytics/generate-data-set.html#options).