Exportação dos dados de treinamento em um conjunto de dados para o Amazon S3

Depois de importar dados para um conjunto de dados do Amazon Personalize, você pode exportar os dados para um bucket do Amazon S3. É possível exportar dados para verificar e inspecionar os dados que o Amazon Personalize usa para gerar recomendações, visualizar os eventos de interação com itens registrados anteriormente em tempo real ou realizar análises off-line nos dados.

Você pode optar por exportar somente os dados que você importou em massa (importados usando uma tarefa de importação do conjunto de dados do Amazon Personalize), somente os dados que você importou individualmente (registros importados usando o console ou operações PutEvents, PutUsers ou PutItems), ou ambos.

Para registros que correspondam exatamente a todos os campos, o Amazon Personalize exporta apenas um registro. Se dois registros tiverem a mesma ID, mas um ou mais campos forem diferentes, o Amazon Personalize incluirá ou removerá os registros dependendo dos dados que você escolher exportar:

Para exportar um conjunto de dados, crie uma tarefa de exportação do conjunto de dados. Um trabalho de exportação de conjunto de dados é uma ferramenta de exportação de registros que envia os registros em um conjunto de dados para um ou mais CSV arquivos em um bucket do Amazon S3. O CSV arquivo de saída inclui uma linha de cabeçalho com nomes de colunas que correspondem aos campos no esquema do conjunto de dados.

Requisitos de permissões de tarefa para exportação de conjuntos de dados

Para exportar um conjunto de dados, o Amazon Personalize precisa de permissão para adicionar arquivos ao seu bucket do Amazon S3. Para conceder permissões, anexe uma nova política AWS Identity and Access Management (IAM) à sua função de serviço Amazon Personalize que conceda à função permissão para usar as ListBucket ações PutObject e em seu bucket, e anexe uma política de bucket ao seu bucket Amazon S3 de saída que conceda ao princípio do Amazon Personalize permissão para usar as ações e. PutObject ListBucket

Se você usar AWS Key Management Service (AWS KMS) para criptografia, deverá conceder permissão ao Amazon Personalize e à sua função de serviço Amazon IAM Personalize para usar sua chave. Para obter mais informações, consulte Como conceder permissão ao Amazon Personalize para usar sua chave AWS KMS.

Política de perfil de serviço para exportar um conjunto de dados

O exemplo de política a seguir concede ao seu perfil de serviço do Amazon Personalize permissão para usar as ações PutObject e ListBucket. Substitua amzn-s3-demo-bucket pelo nome de seu bucket de saída. Para obter informações sobre como anexar políticas a uma função IAM de serviço, consulteComo anexar uma política do Amazon S3 ao seu perfil de serviço do Amazon Personalize.

{
    "Version": "2012-10-17",
    "Id": "PersonalizeS3BucketAccessPolicy",
    "Statement": [
        {
            "Sid": "PersonalizeS3BucketAccessPolicy",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket",
                "arn:aws:s3:::amzn-s3-demo-bucket/*"
            ]
        }
    ]
}

Política de bucket do Amazon S3 para exportar um conjunto de dados

O exemplo de política a seguir concede ao Amazon Personalize permissão para usar as ações PutObject e ListBucket no bucket do Amazon S3. Substitua amzn-s3-demo-bucket pelo nome do seu bucket. Para obter informações sobre como adicionar uma política de bucket do Amazon S3 a um bucket, consulte Adicionar uma política de bucket usando o console do Amazon S3 no Guia do usuário do Amazon Simple Storage Service.

{
    "Version": "2012-10-17",
    "Id": "PersonalizeS3BucketAccessPolicy",
    "Statement": [
        {
            "Sid": "PersonalizeS3BucketAccessPolicy",
            "Effect": "Allow",
            "Principal": {
                "Service": "personalize.amazonaws.com"
            },
            "Action": [
                "s3:PutObject",
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket",
                "arn:aws:s3:::amzn-s3-demo-bucket/*"
            ]
        }
    ]
}

Criação de um trabalho de exportação de conjunto de dados

Você pode criar um trabalho de exportação de conjunto de dados com o console Amazon Personalize AWS Command Line Interface ,AWS CLI() ou. AWS SDKs

aws personalize create-dataset-export-job \
  --job-name job name \
  --dataset-arn dataset ARN \
  --job-output "{\"s3DataDestination\":{\"kmsKeyArn\":\"kms key ARN\",\"path\":\"s3://amzn-s3-demo-bucket/folder-name/\"}}" \
  --role-arn role ARN \
  --ingestion-mode PUT

{
  "datasetExportJobArn": "arn:aws:personalize:us-west-2:acct-id:dataset-export-job/DatasetExportJobName"
}

aws personalize describe-dataset-export-job \
  --dataset-export-job-arn dataset export job ARN