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á.
# Configurar a exportação em massa para todos os dados unificados do perfil de cliente
**nota**
Para concluir as etapas deste tópico, você precisa ter habilidades de desenvolvedor e ter experiência com o uso AWS KMS do Amazon S3.
Quando o Amazon Connect Customer Profiles cria um perfil de cliente unificado, ele aprimora e refina dados e informações brutos em um perfil mais preciso, combinando dados de fontes primárias e terceirizadas. O Customer Profiles também melhora a qualidade dos conjuntos de dados por meio da adição de novos dados. Você pode usar os conjuntos de dados aprimorados para casos de uso adicionais, como formular estratégias de marketing, vendas e atendimento ao cliente mais informadas e direcionadas. Por exemplo, talvez você queira aproveitar o perfil unificado do cliente para:
+ Auditar os dados do cliente que você tem na totalidade de um domínio.
+ Executar análises internas, por exemplo, para relatórios de vendas e marketing.
+ Exportar os dados para suas próprias ferramentas ou produtos de terceiros para personalizar anúncios e segmentar clientes.
Você pode exportar os dados do perfil do cliente unificados em massa para o Amazon S3 Para aproveitá-los em casos de uso adicionais. Este tópico explica como fazer isso.
**Topics**
+ [Etapa 1: Configurar uma chave do KMS e um bucket do S3](#enable-cpbulk-export)
+ [Etapa 2: Criar um trabalho de exportação em massa](#create-bulk-export-job)
+ [Etapa 3: Verificar o status de um trabalho de exportação em massa](#check-status-bulk-cp-export)
+ [Etapa 4: Visualizar os dados exportados no S3](#view-bulk-cp-export)
+ [Atualizar o trabalho de exportação em massa](#update-bulk-cp-export)
+ [Excluir ou cancelar o trabalho de exportação em massa (não compatível)](#delete-bulk-cp-export)
## Etapa 1: Configurar uma chave do KMS e um bucket do S3
Para habilitar a exportação em massa em domínio, você precisará configurar os seguintes recursos:
+ [Uma chave do KMS com uma política de recursos específica](#cp-kms)
+ [Um bucket do S3 de destino com uma política de recursos específica](#cp-s3-bulk). Não configure [listas de controle de acesso (ACLs)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acls.html) no bucket.
Essas etapas serão explicadas a seguir.
### Criar uma chave do KMS ou reutilizar uma chave do KMS existente
Para configurar uma chave KMS para exportação em massa, você deve criar ou reutilizar uma chave KMS existente que esteja na mesma AWS região do bucket do Amazon S3 que você planeja configurar como seu destino de exportação em massa. Você deve permitir que o AppIntegrations serviço Amazon Connect execute ações do KMS para a chave.
Adicione a seguinte declaração à **política de chave**.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "{{Enable AppIntegrations access to KMS key}}",
"Effect": "Allow",
"Principal": {
"AWS": [
"{{arn:aws:iam::{{111122223333}}:root}}"
],
"Service": [
"{{app-integrations.amazonaws.com}}"
]
},
"Action": [
"kms:Encrypt*",
"kms:Describe*",
"kms:Decrypt*",
"kms:GenerateDataKey*"
],
"Resource": "*"
}
]
}
```
------
### Configurar um bucket do S3 de destino
Você deve configurar um bucket novo ou existente na mesma AWS região da chave KMS e configurar uma política de recursos no bucket do S3.
Ao configurar o bucket, selecione **Criptografia com SSE-KMS** e use a mesma chave do KMS do procedimento anterior. Além disso, não habilite ACLs no bucket do S3.
Veja a seguir um exemplo de política de recursos.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "{{Allow AppIntegrations to write data to destination bucket}}",
"Effect": "Allow",
"Principal": {
"Service": [
"app-integrations.amazonaws.com"
]
},
"Action": [
"s3:GetObject",
"s3:ListBucket",
"s3:PutObject",
"s3:PutObjectAcl"
],
"Resource": [
"arn:aws:s3:::{{{{amzn-s3-demo-bucket1}}}}",
"arn:aws:s3:::{{{{amzn-s3-demo-bucket2}}}}/*"
],
"Condition": {
"StringEquals": {
"aws:SourceAccount": "{{AwsAccountId}}"
},
"ArnEquals": {
"aws:SourceArn": "arn:aws:*-*:{us-east-1}:{{AwsAccountId}}:data-integration/*"
}
}
}
]
}
```
------
## Etapa 2: Criar um trabalho de exportação em massa
Para criar um trabalho de exportação em massa, você invoca o seguinte Amazon Connect AppIntegrations APIs:
1. [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html): essa API cria uma integração com a fonte de dados (por exemplo, perfis de clientes).
1. [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html): essa API grava dados no destino (por exemplo, um bucket do S3) usando a fonte de dados.
A seguir estão mais informações sobre como chamá-los APIs.
### Criar uma integração de dados
Uma integração de dados representa a *fonte de dados* dos seus dados. Você pode chamar a [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html)API ou executar o comando [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html)CLI para criar uma integração de dados. Você deve fornecer um *tipo de objeto* e um *domínio* do Customer Profiles.
Se você quiser exportar vários tipos de objetos, precisará criar uma integração de dados separada para cada um. Por exemplo, se você quiser exportar objetos `_profile` e `_asset`, precisará criar duas integrações de dados separadas.
**nota**
Qualquer dado ingerido nos últimos 30 minutos não pode ser incluído na exportação.
O exemplo de código a seguir mostra como executar o comando da [create-data-integration](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration.html)CLI.
```
aws appintegrations create-data-integration \
--region "us-west-2" \
--name "{{bulk-export-job-01}}" \
--description "{{Data integration for _profile objects}}" \
--kms-key "{{arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012}}" \
--source-uri "{{AmazonConnect://AppIntegrations}}" \
--object-configuration '{{{"CustomerProfiles":{"domainName":["my-domain-pdx"],"objectType":["_profile"]}}}}'
```
O exemplo de código a seguir mostra como chamar a [CreateDataIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegration.html)API.
```
{
"Description": "{{Data integration for _profile objects}}",
"KmsKey": "{{arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012}}",
"Name": "{{unique-data-integration-name-01}}",
"SourceURI": "AmazonConnect://AppIntegrations",
"ObjectConfiguration": {
"CustomerProfiles": {
"domainName": [
"{{my-domain-pdx}}"
],
"objectType": [
"_profile"
]
}
}
}
```
### Criar uma associação de integração de dados
Uma associação de integração de dados representa o destino para onde você deseja exportar seus dados e um intervalo de tempo para escolher quais dados exportar. Você pode chamar a [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html)API ou executar o comando [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html)CLI para criar uma integração de dados. Use as propriedades `StartTime` e `EndTime` para configurar o intervalo de tempo. Esse intervalo de tempo corresponde a quando os objetos foram atualizados pela última vez no Customer Profiles.
O bucket do S3 de destino que você especificar pode ser apenas o nome do bucket ou pode incluir uma pasta adicional ou um prefixo do S3 para onde você deseja que os dados sejam exportados.
**nota**
Para obter a cota para **trabalhos de exportação simultânea em massa**, consulte [Connect Customer Cotas de serviço de perfis de clientes](amazon-connect-service-limits.md#customer-profiles-quotas). Depois que um trabalho de exportação em massa é concluído ou falha, ele não conta mais para a cota de simultaneidade.
O exemplo de código a seguir mostra como executar o comando da [create-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/create-data-integration-association.html)CLI.
```
aws appintegrations create-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "{{unique-data-integration-name-01}}" \
--destination-uri "{{s3://{{amzn-s3-demo-bucket1}}}}" \
--execution-configuration '{{{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}}}'
```
O exemplo de código a seguir mostra como chamar a [CreateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_CreateDataIntegrationAssociation.html)API.
```
{
"DataIntegrationIdentifier": "arn:aws:app-integrations:us-west-2:123456789012:data-integration/123456789012-1234-1234-123456789012",
"DestinationURI": "s3://amzn-s3-demo-bucket1",
"ExecutionConfiguration": {
"ExecutionMode": "ON_DEMAND",
"OnDemandConfiguration": {
"StartTime": "1713565000004",
"EndTime": "1713565000005"
}
}
}
```
## Etapa 3: Verificar o status de um trabalho de exportação em massa
Para ver o status do seu trabalho de exportação em massa, você pode chamar a [ListDataIntegrationAssociations](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_ListDataIntegrationAssociations.html)API ou executar o comando da [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html)CLI.
O exemplo de código a seguir mostra como executar o comando da [list-data-integration-associations](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/list-data-integration-associations.html)CLI.
```
aws appintegrations list-data-integration-associations \
--region "us-west-2" \
--data-integration-identifier "{{unique-data-integration-name-01}}"
```
## Etapa 4: Visualizar os dados exportados no S3
Quando a associação de integração de dados estiver `IN_PROGRESS`, você começará a ver os dados sendo copiados para o bucket do S3.
Os dados exportados são gravados usando a seguinte estrutura de caminho:
+ {BucketNameAndFolderName}
+ {AwsAccountId}
+ {DomainName}
+ {RequestTimestamp}
+ {lStartTime}-{EndTime}
+ {ObjectTypeName}
+
Veja a seguir um exemplo de um caminho:
`amzn-s3-demo-bucket1/123456789012/my-domain-pdx/20240607T175023/20240101T235959-20240430T235959/_profile/123456789012-1234-1234-123456789012`
## Atualizar o trabalho de exportação em massa
Depois que o trabalho for concluído, você poderá atualizar a associação de integração de dados com um horário de início e um horário de término de extração de dados diferentes. Isso cria um novo trabalho de exportação em massa. Talvez você queira fazer isso se tiver realizado uma exportação em massa no passado e quiser exportar somente os dados que foram atualizados desde a exportação anterior. Por exemplo, se seu último trabalho de exportação em massa foi há três meses, você pode atualizar a associação de integração de dados com um intervalo de tempo de três meses atrás até hoje.
Você pode chamar a [UpdateDataIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-app-integrations_UpdateDataIntegrationAssociation.html)API ou executar o comando da [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html)CLI para atualizar o trabalho de exportação.
O exemplo de código a seguir mostra como executar o comando da [update-data-integration-association](https://docs.aws.amazon.com/cli/latest/reference/appintegrations/update-data-integration-association.html)CLI.
```
aws appintegrations update-data-integration-association \
--region "us-west-2" \
--data-integration-identifier "{{unique-data-integration-name-01}}" \
--data-integration-association-identifier "{{arn:aws:app-integrations:us-west-2:123456789012:data-integration-association/123456789012-1234-1234-123456789012/123456789012-1234-1234-123456789012}}" \
--execution-configuration '{{{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}}}'
```
## Excluir ou cancelar o trabalho de exportação em massa (não compatível)
Não é possível excluir ou cancelar uma exportação em massa. Depois que um trabalho de exportação é concluído, ele não conta mais para a cota de exportação.