S3 Tables レプリケーションの管理 - Amazon Simple Storage Service

S3 Tables レプリケーションの管理

S3 Tables レプリケーションを設定したら、レプリカのステータスをモニタリングして、レプリケートされた内容を確認できます。レプリケーションステータスは、ソーステーブルの [管理] タブの Amazon S3 コンソールで、または AWS CLI を使用して確認できます。詳細については、「S3 Tables レプリケーションの設定」を参照してください。このトピックでは、レプリケーションをモニタリングし、レプリケーションが完了、進行中、または失敗したかどうかを示すさまざまなステータス値を理解する方法について説明します。

レプリケーションステータスのモニタリング

レプリケーションジョブは、レプリケートされたテーブルに対して継続的に実行されます。GetTableReplicationStatus API を使用してレプリケーションのステータスをクエリするか、Amazon S3 コンソールで表示できます。

AWS CLI を使用してレプリケーションのステータスを取得するには

次の例では、GetTableReplicationStatus API を使用してレプリケーションステータスを取得します。

aws s3tables get-table-replication-status \ --table-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket/table/sales-data

正常な出力:

{ "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" } } ] }

詳細については、「AWS CLI コマンドリファレンス」の「get-table-replication-status」を参照してください。

レスポンスを理解する

レスポンスには、次の要素が含まれます。

  • sourceTableARN – レプリケートされるソーステーブルの ARN。

  • 送信先 – 設定された各レプリケーション送信先に対応する送信先ステータスオブジェクトの配列。各送信先オブジェクトには以下が含まれます。

    • replicationStatus – この送信先の現在のレプリケーションステータス (COMPLETED、PENDING、または FAILED)。

    • destinationBucketARN – レプリケート先テーブルバケットの ARN。

    • destinationTableARN – レプリケート先バケット内のレプリカテーブルの ARN。

    • lastSuccessfulReplicatedUpdate – 最後に成功したレプリケーションに関する情報:

      • metadataLocation – 最後に正常にレプリケートされた Iceberg メタデータファイル名。これをソーステーブルの現在のメタデータの場所と比較して、レプリケーションが最新かどうかを判断します。

      • timestamp – このメタデータファイルが送信先にレプリケートされた時刻。

    • failureMessage (ステータスが FAILED の場合にのみ表示されます) – レプリケーションが失敗した理由を説明する詳細なエラーメッセージ。

レプリケーションステータス値

レプリケーションは、送信先ごとに 3 つのステータスが考えられます。

  • COMPLETED – すべてのソーステーブルスナップショットが送信先に正常にレプリケートされました。ソーステーブルの最新のメタデータの場所は、最後にレプリケートされたメタデータの場所と一致します。

  • PENDING – レプリケーションが進行中であるか、新しいコミットのレプリケートを待っています。ソーステーブルの最新のメタデータの場所は、最後にレプリケートされたメタデータの場所とは異なります。

  • FAILED – このテーブルの最後のレプリケーションジョブが失敗しました。新しい更新はレプリケートされません。