Demande d’importation de table dans DynamoDB

L’importation DynamoDB vous permet d’importer depuis un compartiment Amazon S3 versune nouvelle table DynamoDB. Vous pouvez demander l’importation d’une table à l’aide de la console DynamoDB, de la CLI, ou de l’API CloudFormation ou DynamoDB.

Si vous souhaitez utiliser l’AWS CLI, vous devez d’abord la configurer. Pour en savoir plus, consultez Accès à DynamoDB.

Configuration des autorisations IAM

Vous pouvez importer des données à partir d’un compartiment Amazon S3 dans lequel vous êtes autorisé à lire. Le compartiment de destination ne doit pas nécessairement se trouver dans la même région ou avoir le même propriétaire que la table source. Votre AWS Identity and Access Management (IAM) doit inclure les actions pertinentes sur le compartiment Amazon S3 source et les autorisations CloudWatch requises pour fournir des informations de débogage. Un exemple de stratégie est illustré ci-dessous.

JSON

{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "AllowDynamoDBImportAction",
      "Effect": "Allow",
      "Action": [
        "dynamodb:ImportTable",
        "dynamodb:DescribeImport"
      ],
      "Resource": "arn:aws:dynamodb:us-east-1:111122223333:table/my-table*"
    },
    {
      "Sid": "AllowS3Access",
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:ListBucket"
      ],
      "Resource": [
        "arn:aws:s3:::your-bucket/*",
        "arn:aws:s3:::your-bucket"
      ]
    },
    {
      "Sid": "AllowCloudwatchAccess",
      "Effect": "Allow",
      "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:DescribeLogGroups",
        "logs:DescribeLogStreams",
        "logs:PutLogEvents",
        "logs:PutRetentionPolicy"
      ],
      "Resource": "arn:aws:logs:us-east-1:111122223333:log-group/aws-dynamodb/*"
    },
    {
      "Sid": "AllowDynamoDBListImports",
      "Effect": "Allow",
      "Action": "dynamodb:ListImports",
      "Resource": "*"
    }
  ]
}

Autorisations Amazon S3

Lorsque vous lancez une importation sur une source de compartiment Amazon S3 appartenant à un autre compte, assurez-vous que le rôle ou l’utilisateur a accès aux objets Amazon S3. Vous pouvez vérifier cela en exécutant la commande GetObject d’Amazon S3 et en utilisant les informations d’identification. Lors de l’utilisation de l’API, le paramètre propriétaire du compartiment Amazon S3 est défini par défaut sur l’ID de compte de l’utilisateur actuel. Pour les importations entre comptes, assurez-vous que ce paramètre est correctement renseigné avec l’ID de compte du propriétaire du compartiment. Le code suivant est un exemple de politique de compartiment Amazon S3 dans le compte source.

JSON

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {"Sid": "ExampleStatement",
            "Effect": "Allow",
            "Principal": {"AWS": "arn:aws:iam::123456789012:user/Dave"
            },
            "Action": [
                "s3:GetObject",
                "s3:ListBucket"
            ],
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*"
        }
    ]
}

AWS Key Management Service

Lors de la création de la nouvelle table pour l’importation, si vous sélectionnez une clé de chiffrement au repos qui n’appartient pas à DynamoDB, vous devez fournir les autorisations AWS KMS requises pour faire fonctionner une table DynamoDB chiffrée avec des clés gérées par le client. Pour plus d’informations, consultez Autoriser l’utilisation de votre clé AWS KMS. Si les objets Amazon S3 sont chiffrés avec des clés KMS de chiffrement côté serveur (SSE-KMS), assurez-vous que le rôle ou l’utilisateur à l’origine de l’importation a accès au déchiffrement à l’aide de la clé AWS KMS. Cette fonction ne prend pas en charge les objets Amazon S3 chiffrés avec des clés de chiffrement fournies par le client (SSE-C).

Autorisations CloudWatch

Le rôle ou l’utilisateur qui lance l’importation aura besoin des autorisations de création et de gestion pour le groupe de journaux et les flux de journaux associés à l’importation.

Demande d’exportation à l’aide de l’AWS Management Console

L’exemple suivant montre comment utiliser la console DynamoDB pour importer une table existante nommée MusicCollection.

Obtenir des détails sur des exportations passées dans la AWS Management Console

Vous pouvez trouver des informations sur les tâches d’importation que vous avez exécutées dans le passé en cliquant sur Import from S3 (Importer depuis S3) dans la barre latérale de navigation, puis en sélectionnant l’onglet Imports (Importations). Le panneau d’importation contient la liste de toutes les importations que vous avez effectuées au cours des 90 derniers jours. La sélection de l’ARN d’une tâche répertoriée sous l’onglet Imports (Importations) a pour effet d’afficher les informations relatives à cette importation, dont les paramètres de configuration avancés que vous avez choisis.

Demande d’exportation à l’aide de l’AWS CLI

L’exemple suivant importe des données au format CSV d’un compartiment S3 appelé bucket avec un préfixe dans une nouvelle table appelée target-table.

aws dynamodb import-table --s3-bucket-source S3Bucket=bucket,S3KeyPrefix=prefix \ 
            --input-format CSV --table-creation-parameters '{"TableName":"target-table","KeySchema":  \
            [{"AttributeName":"hk","KeyType":"HASH"}],"AttributeDefinitions":[{"AttributeName":"hk","AttributeType":"S"}],"BillingMode":"PAY_PER_REQUEST"}' \ 
            --input-format-options '{"Csv": {"HeaderList": ["hk", "title", "artist", "year_of_release"], "Delimiter": ";"}}'

Obtenir des détails sur des importations passées dans la AWS CLI

Vous pouvez trouver des informations sur des tâches d’importation que vous avez exécutées dans le passé à l’aide de la commande list-imports. Cette commande envoie la liste de toutes les importations que vous avez effectuées au cours des 90 derniers jours. Notez que, bien que les métadonnées de tâche d’importation expirent après 90 jours et que les tâches plus anciennes ne figurent plus dans cette liste, DynamoDB ne supprime aucun des objets de votre compartiment Amazon S3 ou de la table créée lors de l’importation.

aws dynamodb list-imports

Pour extraire des informations détaillées sur une tâche d’importation spécifique, dont ses paramètres de configuration avancés, utilisez la commande describe-import.

aws dynamodb describe-import \
    --import-arn arn:aws:dynamodb:us-east-1:123456789012:table/ProductCatalog/exp