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

DynamoDB prend en charge à la fois l'exportation complète et l'exportation incrémentielle :

Prérequis

Activer PITR

Pour utiliser la fonctionnalité d'exportation vers S3, vous devez activer PITR sur votre table. Pour plus de détails sur l'activation du PITR, voir P oint-in-time recovery. 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'ExportTableToPointInTimeopération : la restauration instantanée n'est pas activée pour la table 'my-dynamodb-table».

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 AWS Identity and Access Management (IAM) doit vous permettre d'effectuer des actions S3 (s3:AbortMultipartUpload,s3:PutObject, ets3:PutObjectAcl) et l'action d'exportation DynamoDB (). dynamodb:ExportTableToPointInTime Voici un exemple de politique qui accordera à vos utilisateurs les autorisations nécessaires pour effectuer des exportations vers un compartiment S3.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowDynamoDBExportAction",
            "Effect": "Allow",
            "Action": "dynamodb:ExportTableToPointInTime",
            "Resource": "arn:aws:dynamodb:us-east-1:111122223333:table/my-table"
        },
        {
            "Sid": "AllowWriteToDestinationBucket",
            "Effect": "Allow",
            "Action": [
                "s3:AbortMultipartUpload",
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": "arn:aws:s3:::your-bucket/*"
        }
    ]
}

Si vous devez écrire dans un compartiment S3 qui se trouve dans un autre compte ou si vous n'êtes pas autorisé à écrire, le propriétaire du compartiment S3 doit ajouter une politique de compartiment pour vous permettre d'exporter depuis DynamoDB vers ce compartiment. Voici un exemple de politique concernant le compartiment S3 cible.

{
    "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:::awsexamplebucket1/*"
        }
    ]
}

La révocation de ces autorisations pendant une exportation entraînera la création de fichiers partiels.

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

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

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 entre deux sorties d'exportation. Un sous-ensemble d'articles peut être modifié par une opération de transaction reflétée dans l'exportation, tandis qu'un autre sous-ensemble de modifications dans la même transaction n'est pas reflété dans la même demande d'exportation. Cependant, les exportations sont cohérentes au final. Si une transaction est annulée lors d'une exportation, vous aurez le reste de la transaction lors de 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.

Obtenir des informations sur les exportations passées dans le AWS Management Console

Vous pouvez trouver des informations sur les tâches d'exportation que vous avez exécutées dans le passé en choisissant la section Exports vers S3 dans 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 dans l'onglet Exportations pour récupérer les informations relatives à cette exportation, y compris 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 de l' AWS CLI

L'exemple suivant montre comment utiliser le AWS CLI pour exporter une table existante nommée MusicCollection vers un compartiment S3 appeléddb-export-musiccollection.

aws dynamodb update-continuous-backups \
    --table-name MusicCollection \
    --point-in-time-recovery-specification PointInTimeRecoveryEnabled=True

Obtenir des informations sur les exportations passées dans le AWS CLI

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 à « failure_message et failure_reason ».

Dans l'exemple suivant, nous utilisons le paramètre factultatif table-arn pour répertorier uniquement les exportations d'une table spécifique.

aws dynamodb list-exports \
    --table-arn arn:aws:dynamodb:us-east-1:123456789012:table/ProductCatalog

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

aws dynamodb describe-export \
    --export-arn arn:aws:dynamodb:us-east-1:123456789012:table/ProductCatalog/export/01234567890123-a1b2c3d4

Demande d'une exportation à l'aide du kit SDK AWS

Utilisez ces extraits de code pour demander une exportation de table à l'aide du AWS SDK de votre choix.

Obtenir des informations sur les exportations passées à l'aide du AWS SDK

Utilisez ces extraits de code pour obtenir des informations sur les anciennes exportations de tables à l'aide du AWS SDK de votre choix.