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 – このテーブルの最後のレプリケーションジョブが失敗しました。新しい更新はレプリケートされません。