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.
Gestion de la réplication des tables S3
Après avoir configuré la réplication des tables S3, vous pouvez surveiller l'état des répliques pour vérifier ce qui est répliqué. Vous pouvez vérifier l'état de la réplication dans la console Amazon S3 depuis l'onglet Gestion de la table source, ou en utilisant le AWS CLI. Pour plus d'informations, voir Configuration de la réplication des tables S3 .Cette rubrique explique comment surveiller la réplication et comprendre les différentes valeurs d'état qui indiquent si la réplication est terminée, en cours ou a échoué.
Surveillance des emplacements de réplication
Les tâches de réplication s'exécutent en continu pour vos tables répliquées. Vous pouvez demander l'état de la réplication à l'aide de l' GetTableReplicationStatus API ou le consulter dans la console Amazon S3.
Pour obtenir l'état de la réplication à l'aide du AWS CLI
L'exemple suivant permet d'obtenir l'état de réplication à l'aide de l' GetTableReplicationStatusAPI.
aws s3tables get-table-replication-status \ --table-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket/table/sales-data
Sortie attendue :
{ "sourceTableARN": "arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket/table/sales-data", "destinations": [ { "replicationStatus": "COMPLETED", "destinationBucketARN": "arn:aws:s3tables:us-west-2:111122223333:bucket/amzn-s3-demo-table-bucket", "destinationTableARN": "arn:aws:s3tables:us-west-2:111122223333:bucket/amzn-s3-demo-table-bucket/table/sales-data", "lastSuccessfulReplicatedUpdate": { "metadataLocation": "latest_table_metadata.json", "timestamp": "2025-11-15T14:30:00Z" } }, { "replicationStatus": "PENDING", "destinationBucketARN": "arn:aws:s3tables:eu-west-1:111122223333:bucket/amzn-s3-demo-table-bucket-eu-bucket", "destinationTableARN": "arn:aws:s3tables:eu-west-1:111122223333:bucket/amzn-s3-demo-table-bucket-eu-bucket/table/sales-data", "lastSuccessfulReplicatedUpdate": { "metadataLocation": "latest_table_metadata.json", "timestamp": "2025-11-15T14:25:00Z" } } ] }
Pour plus d'informations, consultez https://docs.aws.amazon.com/cli/latest/reference/s3tables/get-table-replication-status.html get-table-replication-status dans la référence des commandes. AWS CLI
L'exemple suivant montre une destination avec le statut FAILED, qui inclut un failureMessage champ :
{ "replicationStatus": "FAILED", "destinationBucketARN": "arn:aws:s3tables:eu-west-1:444455556666:bucket/amzn-s3-demo-table-bucket-partner", "destinationTableARN": "arn:aws:s3tables:eu-west-1:444455556666:bucket/amzn-s3-demo-table-bucket-partner/table/sales-data", "failureMessage": "Insufficient permissions given to successfully complete replication." }
Note
La get-table-replication commande renvoie la configuration de réplication (rôle, règles et destinations). La get-table-replication-status commande renvoie l'état de la réplication (TERMINÉ, EN ATTENTE ou ÉCHEC), les dernières métadonnées répliquées et les messages d'erreur.
Comprendre la réponse
La réponse contient les éléments suivants :
-
SourceTableLearn — L'ARN de la table source en cours de réplication.
-
destinations : tableau d'objets d'état de destination, un pour chaque destination de réplication configurée. Chaque objet de destination contient :
-
ReplicationStatus — État de réplication actuel pour cette destination (TERMINÉ, EN ATTENTE ou ÉCHEC).
-
DestinationBucketArn — ARN du compartiment de table de destination.
-
DestinationTableLearn : ARN de la table de réplication dans le compartiment de destination.
-
last SuccessfulReplicatedUpdate — Informations sur la dernière réplication réussie :
-
MetadataLocation : nom du fichier de métadonnées Iceberg qui a été répliqué avec succès pour la dernière fois. Comparez cela à l'emplacement actuel des métadonnées de la table source pour déterminer si la réplication est à jour.
-
horodatage : heure à laquelle ce fichier de métadonnées a été répliqué vers la destination.
-
-
FailureMessage (présent uniquement lorsque le statut est FAILED) : message d'erreur détaillé expliquant pourquoi la réplication a échoué.
-
Valeurs d'état de réplication
La réplication peut avoir trois statuts possibles pour chaque destination :
-
TERMINÉ — Tous les instantanés de la table source ont été correctement répliqués vers la destination. Le dernier emplacement des métadonnées de la table source correspond à l'emplacement des dernières métadonnées répliquées.
-
EN ATTENTE — La réplication est en cours ou de nouveaux commits attendent d'être répliqués. L'emplacement des métadonnées le plus récent de la table source est différent de celui des dernières métadonnées répliquées.
-
ÉCHEC — La dernière tâche de réplication pour cette table a échoué. Aucune nouvelle mise à jour n'est répliquée.
Si une destination affiche le statut ÉCHEC, vérifiez le failureMessage champ pour plus de détails. Les causes courantes incluent des autorisations insuffisantes, un compartiment de destination introuvable ou des problèmes liés aux clés KMS. Une fois la cause première corrigée, le service réessaie automatiquement la réplication. Vous pouvez surveiller la restauration au fur et à mesure que l'état passe de FAILED à PENDING puis COMPLETED.
