

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á.

# Acessar feeds de dados
<a name="data-feed-accessing"></a>

Com AWS Marketplace, você pode usar dados como um mecanismo para enviar informações estruturadas e atualizadas sobre produtos e clientes dos sistemas AWS Marketplace para os buckets do Amazon S3 para ETL (extração, transformação e carregamento) entre ferramentas de inteligência de negócios de propriedade do vendedor. É necessário configurar o ambiente para receber feeds de dados em um bucket criptografado do Amazon S3. Este tópico mostra como acessar e cancelar a assinatura dos feeds de dados.

**Topics**
+ [Acesse um feed de dados](#data-feed-accessing-procedure)
+ [Políticas de feed de dados](#data-feed-policies)
+ [Cancelar assinatura dos feeds de dados](#data-feed-unsubscribing)

## Acesse um feed de dados
<a name="data-feed-accessing-procedure"></a>

1. Aloque um engenheiro de dados ou inteligência de negócios com experiência em SQL e ETL (extrair, transformar, carregar). Essa pessoa também precisa de experiência na configuração de APIs.

1. Configure um bucket do Amazon Simple Storage Service e uma assinatura dos feeds de dados. Use o ID da conta de vendedor da AWS associado às listas de produtos do Marketplace. Para fazer isso, você pode [assistir a este vídeo do YouTube](https://www.youtube.com/watch?v=heCsZdOT-hw) ou seguir as etapas abaixo.

   O vídeo e as etapas explicam como usar um [modelo CloudFormation](https://s3.amazonaws.com/aws-marketplace-reports-resources/DataFeedsResources.yaml) que ajuda a simplificar a configuração.

   1. Abra um navegador da Web, faça login no [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management/) e, em seguida, acesse [Configurar o armazenamento de dados do cliente](https://aws.amazon.com/marketplace/management/reports/data-feed-configuration).

   1. Escolha **Criar recursos com o modelo do CloudFormation** para abrir o modelo no console do CloudFormation em outra janela.

   1. No modelo, especifique o seguinte e escolha **Próximo**:
      + Nome da pilha: a coleção de recursos que você está criando para habilitar o acesso a feeds de dados.
      + Nome do bucket do Amazon S3: o bucket para armazenar feeds de dados.
      + (Opcional) Nome de tópico do Amazon SNS: o tópico para receber notificações no bucket do Amazon Simple Storage Service.

   1. Na página **Revisar** confirme suas entradas e escolha **Criar pilha**. Isso abrirá uma nova página com o status e os detalhes do CloudFormation.

   1. Na guia **Recursos**, copie os nomes de recurso da Amazon (ARNs) para os seguintes recursos da página do CloudFormation nos campos da página [Configurar armazenamento de dados](https://aws.amazon.com/marketplace/management/reports/data-feed-configuration) do AWS Marketplace:
      + Bucket do Amazon S3 para armazenar feeds de dados
      + Chave AWS KMS para criptografar o bucket do Amazon S3
      + (Opcional) Tópico do Amazon SNS para receber notificações quando a AWS fornece novos dados para o bucket do Amazon S3

   1. Na página **Configurar armazenamento de dados do cliente**, escolha **Enviar**.

   1. (Opcional) Edite as políticas criadas pelo modelo do CloudFormation. Consulte [Políticas de feed de dados](#data-feed-policies) para obter mais detalhes.

      Agora você está inscrito em feeds de dados. Na próxima vez que os feeds de dados forem gerados, será possível acessar os dados.

1. Use uma operação ETL (extrair, transformar, carregar) para conectar os feeds de dados ao seu data warehouse ou banco de dados relacional.
**nota**  
As ferramentas de dados têm capacidades diferentes. Você deve envolver um engenheiro de business intelligence ou engenheiro de dados para configurar a integração de acordo com os recursos da sua ferramenta.

1. Para executar ou criar consultas SQL, configure os feeds de dados para impor chaves primárias e estrangeiras em sua ferramenta de dados. Cada feed de dados representa uma tabela exclusiva, e você deve configurar todos os feeds de dados no esquema de dados com os relacionamentos da entidade. Para obter mais informações sobre tabelas e relacionamentos entre entidades, consulte [Visão geral das tabelas de feed de dados](data-feed-joining.md) neste guia.

1. Configure o Amazon Simple Notification Service para atualizar automaticamente seu data warehouse ou banco de dados relacional. Você pode configurar notificações do Amazon SNS para enviar alertas quando os dados de cada feed exclusivo são entregues a um bucket do Amazon S3. Essas notificações podem ser aproveitadas para atualizar automaticamente o data warehouse do vendedor quando novos dados são recebidos por meio de feeds de dados, se a ferramenta de dados do vendedor suportar esse recurso. Para instruções, consulte [Conceitos básicos do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.

   Exemplo de notificação:

   ```
   {
           "mainExecutionId": "1bc08b11-ab4b-47e1-866a-9c8f38423a98",
           "executionId": "52e862a9-42d2-41e0-8010-810af84d39b1",
           "subscriptionId": "27ae3961-b13a-44bc-a1a7-365b2dc181fd",
           "processedFiles": [],
           "executionStatus": "SKIPPED",
           "errors": [],
           "feedType": "[data feed name]"
           }
   ```

   As notificações podem ter os seguintes status `executionStatus`:
   + `SKIPPED`: o vendedor não tem dados novos para o dia.
   + `COMPLETED`: entregamos o feed com novos dados.
   + `FAILED`: a entrega do feed tem um problema.

1. Valide a configuração executando consultas SQL. Você pode usar os [exemplos de consultas neste guia](https://docs.aws.amazon.com/marketplace/latest/userguide/data-feed-full-examples.html) ou as consultas no GitHub, em [ https://github.com/aws-samples/aws-marketplace-api-samples/tree/main/seller-data-feeds/queries](https://github.com/aws-samples/aws-marketplace-api-samples/tree/main/seller-data-feeds/queries).
**nota**  
Os exemplos de consultas neste guia foram escritos para AWS Athena. Talvez seja necessário modificar as consultas para uso com suas ferramentas.

1. Determine onde os usuários corporativos desejam consumir dados. Por exemplo, você pode:
   + Exporte dados.csv do seu data warehouse ou banco de dados SQL.
   + Conecte seus dados a uma ferramenta de visualização, como PowerBI ou Tableau.
   + Mapeie dados para seu CRM, ERP ou ferramentas financeiras, como Salesforce, Infor ou Netsuite.

Para obter mais informações sobre modelos do CloudFormation, consulte [Trabalhar com modelos do CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html) no *Guia do usuário do AWS CloudFormation*.

## Políticas de feed de dados
<a name="data-feed-policies"></a>

Quando o bucket do Amazon S3 é criado pelo modelo do CloudFormation, ele cria políticas de acesso anexadas a esse bucket, à chave AWS KMS e ao tópico do Amazon SNS. As políticas permitem que o serviço de relatórios do AWS Marketplace grave no bucket e no tópico do SNS com as informações do feed de dados. Cada política terá uma seção como a seguinte (este exemplo é do bucket do Amazon S3).

```
        {
            "Sid": "AwsMarketplaceDataFeedsAccess",
            "Effect": "Allow",
            "Principal": {
                "Service": "reports.marketplace.amazonaws.com"
            },
            "Action": [
                "s3:ListBucket",
                "s3:GetObject",
                "s3:PutObject",
                "s3:GetEncryptionConfiguration",
                "s3:GetBucketAcl",
                "s3:PutObjectAcl"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket",
                "arn:aws:s3:::amzn-s3-demo-bucket/*"
            ]
        },
```

Nessa política, AWS Marketplace usa o principal do serviço `reports.marketplace.amazonaws.com` usa para enviar dados para o bucket do Amazon S3. Você especificou o *amzn-s3-demo-bucket* no modelo do CloudFormation.

Quando o serviço de relatórios do AWS Marketplace chama o Amazon S3, o AWS KMS ou o Amazon SNS, ele fornece o ARN dos dados que pretende gravar no bucket. Para garantir que os únicos dados gravados no bucket sejam dados gravados em seu nome, você pode especificar `aws:SourceArn` na condição da política. No exemplo a seguir, você deve substituir *account-id* pelo ID da Conta da AWS.

```
        {
           "Sid": "AwsMarketplaceDataFeedsAccess",
           "Effect": "Allow",
           "Principal": {
                "Service": "reports.marketplace.amazonaws.com"
            },
            "Action": [
                "s3:ListBucket",
                "s3:GetObject",
                "s3:PutObject",
                "s3:GetEncryptionConfiguration",
                "s3:GetBucketAcl",
                "s3:PutObjectAcl"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket",
                "arn:aws:s3:::amzn-s3-demo-bucket/*"
            ,
            "Condition": {
                "StringEquals": {
                        "aws:SourceAccount": "account-id",
                        "aws:SourceArn": ["arn:aws:marketplace::account-id:AWSMarketplace/SellerDataSubscription/DataFeeds_V1",
                        "arn:aws:marketplace::account-id:AWSMarketplace/SellerDataSubscription/Example-Report"]
                        }
                }
        },
```

## Cancelar assinatura dos feeds de dados
<a name="data-feed-unsubscribing"></a>

Abra um navegador da Web e faça login no [Portal de gerenciamento do AWS Marketplace](https://aws.amazon.com/marketplace/management/). Em seguida, acesse a [página Fale conosco](https://aws.amazon.com/marketplace/management/contact-us/) para enviar uma solicitação de cancelamento de assinatura à equipe de operações do vendedor do AWS Marketplace. A solicitação de cancelamento de assinatura pode levar até 10 dias úteis para ser processada.