Gestion de la réplication des tables S3 - Amazon Simple Storage Service
Surveillance des emplacements de réplication

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 de la réplique pour vérifier ce qui est répliqué. Vous pouvez vérifier l'état de réplication dans la console Amazon S3, dans l'onglet Gestion de la table source, ou en utilisant le AWS CLI. Pour plus d'informations, consultez 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 connaître 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 get-table-replication-status dans la Référence des commandes de l’AWS CLI .

Comprendre la réponse

La réponse contient les éléments suivants :

  • SourceTabLearn — 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 — L'ARN du bucket de table de destination.

    • DestinationTableARN — L'ARN de la table de réplication dans le compartiment de destination.

    • lastSuccessfulReplicatedMise à jour : informations sur la dernière réplication réussie :

      • MetadataLocation — Nom du fichier de métadonnées Iceberg répliqué avec succès pour la dernière fois. Comparez cela avec l'emplacement actuel des métadonnées de la table source pour déterminer si la réplication est à jour.

      • timestamp — 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 au dernier emplacement des métadonnées répliquées.

  • EN ATTENTE — La réplication est en cours ou de nouveaux validations attendent d'être répliqués. Le dernier emplacement des métadonnées de la table source est différent du dernier emplacement des 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.