Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Demande d’exportation de table dans DynamoDB Les exportations de tables DynamoDB vous permettent d'exporter les données des tables vers un compartiment Amazon S3, ce qui vous permet d'effectuer des analyses et des requêtes complexes sur vos données à l'aide AWS d'autres services tels qu'Athena, AWS Glue Amazon AI SageMaker , Amazon EMR et. AWS Lake Formation Vous pouvez demander une exportation de table à l'aide de l' AWS Management Console AWS CLI API DynamoDB ou de l'API DynamoDB. **Note** Le demandeur paie les compartiments Amazon S3 qui ne sont pas pris en charge. DynamoDB prend en charge à la fois l’exportation complète et l’exportation incrémentielle : + Avec **les exportations complètes**, vous pouvez exporter un instantané complet de votre table à tout moment pendant la fenêtre de point-in-time restauration (PITR) vers votre compartiment Amazon S3. + Avec les **exportations incrémentielles**, vous pouvez exporter vers votre compartiment Amazon S3 les données de votre table DynamoDB qui ont été modifiées, mises à jour ou supprimées au cours d’une période spécifiée dans votre fenêtre PITR. **Topics** + [Conditions préalables](#S3DataExport_Requesting_Permissions) + [Demande d'exportation à l'aide du AWS Management Console](#S3DataExport_Requesting_Console) + [Pour en savoir plus sur les exportations passées, consultez le AWS Management Console](#S3DataExport_Requesting_Console_Details) + [Demande d'exportation à l'aide du AWS CLI et AWS SDKs](#S3DataExport_Requesting_CLI) + [Obtenir des informations sur les exportations passées à l'aide AWS CLI des AWS SDKs](#S3DataExport_Requesting_CLI_Details) ## Conditions préalables **Activer PITR** Pour utiliser la fonctionnalité d’exportation vers S3, vous devez activer la PITR sur votre table. Pour plus de détails sur l'activation du PITR, consultez la section [P oint-in-time recovery](PointInTimeRecovery_Howitworks.md). Si vous demandez l'exportation d'une table pour laquelle le PITR n'est pas activé, votre demande échouera avec un message d'exception : « Une erreur s'est produite (PointInTimeRecoveryUnavailableException) lors de l'appel de l'`ExportTableToPointInTime`opération : la restauration instantanée n'est pas activée pour la table 'my-dynamodb-table». Vous ne pouvez demander et exporter qu’à partir d’un point dans le temps correspondant à la PITR `RecoveryPeriodInDays` configurée. **Configuration des autorisations S3** Vous pouvez exporter vos données de table vers n’importe quel compartiment Amazon S3 dans lequel vous êtes autorisé à écrire. Il n'est pas nécessaire que le compartiment de destination se trouve dans la même AWS région ou qu'il ait le même propriétaire que le propriétaire de la table source. Votre politique Gestion des identités et des accès AWS (IAM) doit vous permettre d'effectuer des actions S3 (`s3:AbortMultipartUpload`,`s3:PutObject`, et`s3:PutObjectAcl`) et l'action d'exportation DynamoDB (). `dynamodb:ExportTableToPointInTime` Voici un exemple de stratégie qui accorde à vos utilisateurs les autorisations nécessaires pour effectuer des exportations vers un compartiment S3. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowDynamoDBExportAction", "Effect": "Allow", "Action": "dynamodb:ExportTableToPointInTime", "Resource": "arn:aws:dynamodb:us-east-1:111122223333:table/my-table" }, { "Sid": "AllowS3BucketWrites", "Effect": "Allow", "Action": [ "s3:AbortMultipartUpload", "s3:PutObject", "s3:PutObjectAcl" ], "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*" } ] } ``` ------ Si vous devez écrire dans un compartiment S3 qui se trouve dans un autre compte ou si vous n’êtes pas autorisé à y écrire, le propriétaire du compartiment S3 doit ajouter une stratégie de compartiment pour vous permettre d’exporter de DynamoDB vers ce compartiment. Voici un exemple de stratégie sur le compartiment S3 cible. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "ExampleStatement", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::123456789012:user/Dave" }, "Action": [ "s3:AbortMultipartUpload", "s3:PutObject", "s3:PutObjectAcl" ], "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*" } ] } ``` ------ La révocation de ces autorisations pendant une exportation entraînera la création de fichiers partiels. **Note** Si la table ou le compartiment vers lequel vous effectuez l’exportation est chiffré à l’aide de clés gérées par le client, les politiques associées à cette clé KMS doivent accorder à DynamoDB l’autorisation de l’utiliser. Cette autorisation est accordée par le biais de l'IAM User/Role qui déclenche la tâche d'exportation. Pour plus d’informations sur le chiffrement, notamment sur les bonnes pratiques en la matière, consultez [Comment DynamoDB utilise AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/services-dynamodb.html) et [Using a custom KMS key](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/encryption.howitworks.html#managed-key-customer-managed) (Utilisation d’une clé KMS personnalisée). ## Demande d'exportation à l'aide du AWS Management Console L’exemple suivant montre comment utiliser la console DynamoDB pour exporter une table existante nommée `MusicCollection`. **Note** Cette procédure part du principe que vous avez activé point-in-time la restauration. Pour l'activer pour la `MusicCollection` table, dans l'onglet **Vue d'ensemble** de la table, dans la section **Détails de la table**, choisissez **Activer** pour la **oint-in-timerestauration P.** **Pour demander une exportation de table** 1. Connectez-vous à la console DynamoDB AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/) 1. Dans le panneau de navigation sur le côté gauche de la console, choisissez **Exportations vers S3**. 1. Sélectionnez le bouton **Exporter vers S3**. 1. Choisissez une table source et un compartiment S3 de destination. Si le compartiment de destination appartient à votre compte, vous pouvez utiliser le bouton **Browse S3** (Parcourir S3) pour le trouver. Sinon, saisissez l’URL du compartiment à l’aide du `s3://bucketname/prefix format.`. Le **prefix** est un dossier facultatif qui vous permet de garder votre compartiment de destination organisé. 1. Choisissez **Exportation complète** ou **Exportation incrémentielle**. Une **exportation complète** sort l’instantané complet de votre table telle qu’elle était à l’instant spécifié. Une **exportation incrémentielle** sort les modifications apportées à votre table au cours de la période d’exportation spécifiée. Votre sortie est compactée de telle sorte qu’elle contienne uniquement l’état final de l’élément de la période d’exportation. L’élément n’apparaît qu’une seule fois dans l’exportation, même s’il a été mis à jour plusieurs fois au cours de la même période d’exportation. ------ #### [ Full export ] 1. Sélectionnez l’instant précis à partir duquel vous voulez que l’instantané complet de la table soit exporté. Cela peut être n’importe quel instant de la fenêtre PITR. Vous pouvez également sélectionner **Heure actuelle** pour exporter l’instantané le plus récent. 1. Pour **Format de fichier exporté**, choisissez entre **JSON DynamoDB** et **Amazon Ion**. Par défaut, votre table sera exportée au format JSON DynamoDB à partir de la dernière heure restaurable dans la fenêtre de restauration à un instant dans le passé, et chiffrée à l'aide d'une clé Amazon S3 (SSE-S3). Vous pouvez modifier ces paramètres d’exportation si nécessaire. **Note** Si vous choisissez de chiffrer votre exportation à l'aide d'une clé protégée par AWS Key Management Service (AWS KMS), la clé doit se trouver dans la même région que le compartiment S3 de destination. ------ #### [ Incremental export ] 1. Sélectionnez la **Période d’exportation** pour laquelle vous souhaitez exporter les données incrémentielles. Choisissez une heure de début dans la fenêtre PITR. La durée de la période d’exportation doit être au minimum de 15 minutes et ne pas dépasser 24 heures. L’heure de début de la période d’exportation est incluse et l’heure de fin est exclue. 1. Choisissez entre le **Mode absolu** et le **Mode relatif**. 1. Le **Mode absolu** exporte les données incrémentielles correspondant à la période que vous spécifiez. 1. Le **Mode relatif** exporte les données incrémentielles pour une période d’exportation relative à la date de soumission de votre tâche d’exportation. 1. Pour **Format de fichier exporté**, choisissez entre **JSON DynamoDB** et **Amazon Ion**. Par défaut, votre table sera exportée au format JSON DynamoDB à partir de la dernière heure restaurable dans la fenêtre de restauration à un instant dans le passé, et chiffrée à l'aide d'une clé Amazon S3 (SSE-S3). Vous pouvez modifier ces paramètres d’exportation si nécessaire. **Note** Si vous choisissez de chiffrer votre exportation à l'aide d'une clé protégée par AWS Key Management Service (AWS KMS), la clé doit se trouver dans la même région que le compartiment S3 de destination. 1. Pour **Type de vue d’exportation**, sélectionnez **Ancienne et nouvelle images** ou **Nouvelles images uniquement**. Nouvelle image indique l’état le plus récent de l’élément. Ancienne image indique l’état de l’élément juste avant les « date et heure de début » spécifiées. Le paramètre par défaut est **Ancienne et nouvelle images**. Pour en savoir plus sur les nouvelles et anciennes images, consultez [Sortie d’une exportation incrémentielle](S3DataExport.Output.md#incremental-export-output). ------ 1. Choisissez **Exporter** pour commencer. Les données exportées ne sont pas cohérentes du point de vue des transactions. Vos opérations de transaction peuvent être réparties sur deux sorties d’exportation. Il est possible qu’un sous-ensemble d’éléments modifiés par une opération de transaction apparaisse dans l’exportation, mais qu’un autre sous-ensemble de modifications relevant de la même transaction n’apparaisse pas dans la même demande d’exportation. Cependant, les exportations sont cohérentes au final. Si une transaction est divisée lors d’une exportation, la transaction restante sera intégrée à votre prochaine exportation contiguë, sans doublons. Les périodes de temps utilisées pour les exportations reposent sur une horloge système interne et peuvent varier d’une minute par rapport à l’horloge locale de votre application. ## Pour en savoir plus sur les exportations passées, consultez le AWS Management Console Vous pouvez trouver des informations sur les tâches d’exportation que vous avez exécutées antérieurement en choisissant la section **Exportations vers S3** de la barre latérale de navigation. Cette section contient la liste de toutes les exportations que vous avez créées au cours des 90 derniers jours. Sélectionnez l’ARN d’une tâche répertoriée sous l’onglet **Exportations** pour extraire les informations relatives à cette exportation, dont les paramètres de configuration avancés que vous avez choisis. Notez que, bien que les métadonnées de tâche d’exportation expirent après 90 jours et que les tâches plus anciennes ne figurent plus dans cette liste, les objets restent dans votre compartiment S3 aussi longtemps que leurs politiques de compartiment le permettent. DynamoDB ne supprime jamais aucun des objets qu’il crée dans votre compartiment S3 lors d’une exportation. ## Demande d'exportation à l'aide du AWS CLI et AWS SDKs Les exemples suivants montrent comment exporter une table existante vers un compartiment S3. **Note** Cette procédure part du principe que vous avez activé point-in-time la restauration. Pour l’activer pour la table `MusicCollection`, exécutez la commande suivante. ``` aws dynamodb update-continuous-backups \ --table-name MusicCollection \ --point-in-time-recovery-specification PointInTimeRecoveryEnabled=True ``` **Exportation complète** ------ #### [ AWS CLI ] **Note** Si vous demandez une exportation de table entre comptes, veillez à inclure l’option `--s3-bucket-owner`. ``` aws dynamodb export-table-to-point-in-time \ --table-arn arn:aws:dynamodb:us-west-2:111122223333:table/MusicCollection \ --s3-bucket ddb-export-musiccollection-9012345678 \ --s3-prefix 2020-Nov \ --export-format DYNAMODB_JSON \ --export-time 1604632434 \ --s3-bucket-owner 9012345678 \ --s3-sse-algorithm AES256 ``` ------ #### [ Python ] ``` import boto3 from datetime import datetime client = boto3.client('dynamodb') client.export_table_to_point_in_time( TableArn='arn:aws:dynamodb:us-east-1:111122223333:table/TABLE', ExportTime=datetime(2023, 9, 20, 12, 0, 0), S3Bucket='bucket', S3Prefix='prefix', S3SseAlgorithm='AES256', ExportFormat='DYNAMODB_JSON' ) ``` ------ #### [ Java ] ``` DynamoDbClient client = DynamoDbClient.create(); client.exportTableToPointInTime(b -> b .tableArn("arn:aws:dynamodb:us-east-1:111122223333:table/TABLE") .exportTime(Instant.parse("2023-09-20T12:00:00Z")) .s3Bucket("bucket") .s3Prefix("prefix") .s3SseAlgorithm(S3SseAlgorithm.AES256) .exportFormat(ExportFormat.DYNAMODB_JSON)); ``` ------ #### [ .NET ] ``` var client = new AmazonDynamoDBClient(); await client.ExportTableToPointInTimeAsync(new ExportTableToPointInTimeRequest { TableArn = "arn:aws:dynamodb:us-east-1:111122223333:table/TABLE", ExportTime = new DateTime(2023, 9, 20, 12, 0, 0, DateTimeKind.Utc), S3Bucket = "bucket", S3Prefix = "prefix", S3SseAlgorithm = S3SseAlgorithm.AES256, ExportFormat = ExportFormat.DYNAMODB_JSON }); ``` ------ #### [ JavaScript ] ``` import { DynamoDBClient, ExportTableToPointInTimeCommand } from "@aws-sdk/client-dynamodb"; const client = new DynamoDBClient(); await client.send(new ExportTableToPointInTimeCommand({ TableArn: "arn:aws:dynamodb:us-east-1:111122223333:table/TABLE", ExportTime: new Date("2023-09-20T12:00:00Z"), S3Bucket: "bucket", S3Prefix: "prefix", S3SseAlgorithm: "AES256", ExportFormat: "DYNAMODB_JSON" })); ``` ------ #### [ Go ] ``` cfg, _ := config.LoadDefaultConfig(context.TODO()) client := dynamodb.NewFromConfig(cfg) exportTime := time.Date(2023, 9, 20, 12, 0, 0, 0, time.UTC) client.ExportTableToPointInTime(context.TODO(), &dynamodb.ExportTableToPointInTimeInput{ TableArn: aws.String("arn:aws:dynamodb:us-east-1:111122223333:table/TABLE"), ExportTime: &exportTime, S3Bucket: aws.String("bucket"), S3Prefix: aws.String("prefix"), S3SseAlgorithm: types.S3SseAlgorithmAes256, ExportFormat: types.ExportFormatDynamodbJson, }) ``` ------ **Exportation incrémentielle** ------ #### [ AWS CLI ] ``` aws dynamodb export-table-to-point-in-time \ --table-arn arn:aws:dynamodb:REGION:ACCOUNT:table/TABLENAME \ --s3-bucket BUCKET --s3-prefix PREFIX \ --incremental-export-specification ExportFromTime=1693569600,ExportToTime=1693656000,ExportViewType=NEW_AND_OLD_IMAGES \ --export-type INCREMENTAL_EXPORT ``` ------ #### [ Python ] ``` import boto3 from datetime import datetime client = boto3.client('dynamodb') client.export_table_to_point_in_time( TableArn='arn:aws:dynamodb:us-east-1:111122223333:table/TABLE', IncrementalExportSpecification={ 'ExportFromTime': datetime(2023, 9, 20, 12, 0, 0), 'ExportToTime': datetime(2023, 9, 20, 13, 0, 0), 'ExportViewType': 'NEW_AND_OLD_IMAGES' }, ExportType='INCREMENTAL_EXPORT', S3Bucket='bucket', S3Prefix='prefix', S3SseAlgorithm='AES256', ExportFormat='DYNAMODB_JSON' ) ``` ------ #### [ Java ] ``` DynamoDbClient client = DynamoDbClient.create(); client.exportTableToPointInTime(b -> b .tableArn("arn:aws:dynamodb:us-east-1:111122223333:table/TABLE") .exportType(ExportType.INCREMENTAL_EXPORT) .incrementalExportSpecification(i -> i .exportFromTime(Instant.parse("2023-09-20T12:00:00Z")) .exportToTime(Instant.parse("2023-09-20T13:00:00Z")) .exportViewType(ExportViewType.NEW_AND_OLD_IMAGES)) .s3Bucket("bucket") .s3Prefix("prefix") .s3SseAlgorithm(S3SseAlgorithm.AES256) .exportFormat(ExportFormat.DYNAMODB_JSON)); ``` ------ #### [ .NET ] ``` var client = new AmazonDynamoDBClient(); await client.ExportTableToPointInTimeAsync(new ExportTableToPointInTimeRequest { TableArn = "arn:aws:dynamodb:us-east-1:111122223333:table/TABLE", ExportType = ExportType.INCREMENTAL_EXPORT, IncrementalExportSpecification = new IncrementalExportSpecification { ExportFromTime = new DateTime(2023, 9, 20, 12, 0, 0, DateTimeKind.Utc), ExportToTime = new DateTime(2023, 9, 20, 13, 0, 0, DateTimeKind.Utc), ExportViewType = ExportViewType.NEW_AND_OLD_IMAGES }, S3Bucket = "bucket", S3Prefix = "prefix", S3SseAlgorithm = S3SseAlgorithm.AES256, ExportFormat = ExportFormat.DYNAMODB_JSON }); ``` ------ #### [ JavaScript ] ``` import { DynamoDBClient, ExportTableToPointInTimeCommand } from "@aws-sdk/client-dynamodb"; const client = new DynamoDBClient(); await client.send(new ExportTableToPointInTimeCommand({ TableArn: "arn:aws:dynamodb:us-east-1:111122223333:table/TABLE", ExportType: "INCREMENTAL_EXPORT", IncrementalExportSpecification: { ExportFromTime: new Date("2023-09-20T12:00:00Z"), ExportToTime: new Date("2023-09-20T13:00:00Z"), ExportViewType: "NEW_AND_OLD_IMAGES" }, S3Bucket: "bucket", S3Prefix: "prefix", S3SseAlgorithm: "AES256", ExportFormat: "DYNAMODB_JSON" })); ``` ------ #### [ Go ] ``` cfg, _ := config.LoadDefaultConfig(context.TODO()) client := dynamodb.NewFromConfig(cfg) fromTime := time.Date(2023, 9, 20, 12, 0, 0, 0, time.UTC) toTime := time.Date(2023, 9, 20, 13, 0, 0, 0, time.UTC) client.ExportTableToPointInTime(context.TODO(), &dynamodb.ExportTableToPointInTimeInput{ TableArn: aws.String("arn:aws:dynamodb:us-east-1:111122223333:table/TABLE"), ExportType: types.ExportTypeIncrementalExport, IncrementalExportSpecification: &types.IncrementalExportSpecification{ ExportFromTime: &fromTime, ExportToTime: &toTime, ExportViewType: types.ExportViewTypeNewAndOldImages, }, S3Bucket: aws.String("bucket"), S3Prefix: aws.String("prefix"), S3SseAlgorithm: types.S3SseAlgorithmAes256, ExportFormat: types.ExportFormatDynamodbJson, }) ``` ------ **Note** Si vous choisissez de chiffrer votre exportation à l'aide d'une clé protégée par AWS Key Management Service (AWS KMS), la clé doit se trouver dans la même région que le compartiment S3 de destination. ## Obtenir des informations sur les exportations passées à l'aide AWS CLI des AWS SDKs Vous pouvez trouver des informations sur des demandes d’exportation que vous avez exécutées antérieurement à l’aide de la commande `list-exports`. Cette commande envoie la liste de toutes les exportations que vous avez effectuées au cours des 90 derniers jours. Notez que, bien que les métadonnées de tâche d’exportation expirent après 90 jours et que la commande `list-exports` ne renvoie plus les tâches plus anciennes, les objets restent dans votre compartiment S3 aussi longtemps que leurs politiques de compartiment le permettent. DynamoDB ne supprime jamais aucun des objets qu'il crée dans votre compartiment S3 lors d'une exportation. Les exportations ont le statut `PENDING` tant qu’elles n’ont pas abouti ou échoué. En cas de réussite, le statut passe à `COMPLETED`. En cas d’échec, le statut passe à `FAILED` avec un `failure_message` et un `failure_reason`. **Exportations de listes** ------ #### [ AWS CLI ] ``` aws dynamodb list-exports \ --table-arn arn:aws:dynamodb:us-east-1:111122223333:table/ProductCatalog ``` ------ #### [ Python ] ``` import boto3 client = boto3.client('dynamodb') print( client.list_exports( TableArn='arn:aws:dynamodb:us-east-1:111122223333:table/TABLE', ) ) ``` ------ #### [ Java ] ``` DynamoDbClient client = DynamoDbClient.create(); ListExportsResponse response = client.listExports(b -> b .tableArn("arn:aws:dynamodb:us-east-1:111122223333:table/TABLE")); response.exportSummaries().forEach(System.out::println); ``` ------ #### [ .NET ] ``` var client = new AmazonDynamoDBClient(); var response = await client.ListExportsAsync(new ListExportsRequest { TableArn = "arn:aws:dynamodb:us-east-1:111122223333:table/TABLE" }); response.ExportSummaries.ForEach(Console.WriteLine); ``` ------ #### [ JavaScript ] ``` import { DynamoDBClient, ListExportsCommand } from "@aws-sdk/client-dynamodb"; const client = new DynamoDBClient(); const response = await client.send(new ListExportsCommand({ TableArn: "arn:aws:dynamodb:us-east-1:111122223333:table/TABLE" })); console.log(response.ExportSummaries); ``` ------ #### [ Go ] ``` cfg, _ := config.LoadDefaultConfig(context.TODO()) client := dynamodb.NewFromConfig(cfg) response, _ := client.ListExports(context.TODO(), &dynamodb.ListExportsInput{ TableArn: aws.String("arn:aws:dynamodb:us-east-1:111122223333:table/TABLE"), }) fmt.Println(response.ExportSummaries) ``` ------ **Décrire l'exportation** ------ #### [ AWS CLI ] ``` aws dynamodb describe-export \ --export-arn arn:aws:dynamodb:us-east-1:111122223333:table/ProductCatalog/export/01695353076000-a1b2c3d4 ``` ------ #### [ Python ] ``` import boto3 client = boto3.client('dynamodb') print( client.describe_export( ExportArn='arn:aws:dynamodb:us-east-1:111122223333:table/TABLE/export/01695353076000-06e2188f', )['ExportDescription'] ) ``` ------ #### [ Java ] ``` DynamoDbClient client = DynamoDbClient.create(); DescribeExportResponse response = client.describeExport(b -> b .exportArn("arn:aws:dynamodb:us-east-1:111122223333:table/TABLE/export/01695353076000-06e2188f")); System.out.println(response.exportDescription()); ``` ------ #### [ .NET ] ``` var client = new AmazonDynamoDBClient(); var response = await client.DescribeExportAsync(new DescribeExportRequest { ExportArn = "arn:aws:dynamodb:us-east-1:111122223333:table/TABLE/export/01695353076000-06e2188f" }); Console.WriteLine(response.ExportDescription); ``` ------ #### [ JavaScript ] ``` import { DynamoDBClient, DescribeExportCommand } from "@aws-sdk/client-dynamodb"; const client = new DynamoDBClient(); const response = await client.send(new DescribeExportCommand({ ExportArn: "arn:aws:dynamodb:us-east-1:111122223333:table/TABLE/export/01695353076000-06e2188f" })); console.log(response.ExportDescription); ``` ------ #### [ Go ] ``` cfg, _ := config.LoadDefaultConfig(context.TODO()) client := dynamodb.NewFromConfig(cfg) response, _ := client.DescribeExport(context.TODO(), &dynamodb.DescribeExportInput{ ExportArn: aws.String("arn:aws:dynamodb:us-east-1:111122223333:table/TABLE/export/01695353076000-06e2188f"), }) fmt.Println(response.ExportDescription) ``` ------