# S3 Tables レプリケーションの管理
<a name="s3-tables-replication-managing"></a>

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

## レプリケーションステータスのモニタリング
<a name="s3-tables-replication-monitoring-status"></a>

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

### AWS CLI を使用してレプリケーションのステータスを取得するには
<a name="s3-tables-replication-status-cli"></a>

次の例では、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](https://docs.aws.amazon.com/cli/latest/reference/s3tables/get-table-replication-status.html)」を参照してください。

### レスポンスを理解する
<a name="s3-tables-replication-understanding-response"></a>

レスポンスには、次の要素が含まれます。
+ **sourceTableARN** – レプリケートされるソーステーブルの ARN。
+ **送信先** – 設定された各レプリケーション送信先に対応する送信先ステータスオブジェクトの配列。各送信先オブジェクトには以下が含まれます。
  + **replicationStatus** – この送信先の現在のレプリケーションステータス (COMPLETED、PENDING、または FAILED)。
  + **destinationBucketARN** – レプリケート先テーブルバケットの ARN。
  + **destinationTableARN** – レプリケート先バケット内のレプリカテーブルの ARN。
  + **lastSuccessfulReplicatedUpdate** – 最後に成功したレプリケーションに関する情報:
    + **metadataLocation** – 最後に正常にレプリケートされた Iceberg メタデータファイル名。これをソーステーブルの現在のメタデータの場所と比較して、レプリケーションが最新かどうかを判断します。
    + **timestamp** – このメタデータファイルが送信先にレプリケートされた時刻。
  + **failureMessage** (ステータスが FAILED の場合にのみ表示されます) – レプリケーションが失敗した理由を説明する詳細なエラーメッセージ。

### レプリケーションステータス値
<a name="s3-tables-replication-status-values"></a>

レプリケーションは、送信先ごとに 3 つのステータスが考えられます。
+ **COMPLETED** – すべてのソーステーブルスナップショットが送信先に正常にレプリケートされました。ソーステーブルの最新のメタデータの場所は、最後にレプリケートされたメタデータの場所と一致します。
+ **PENDING** – レプリケーションが進行中であるか、新しいコミットのレプリケートを待っています。ソーステーブルの最新のメタデータの場所は、最後にレプリケートされたメタデータの場所とは異なります。
+ **FAILED** – このテーブルの最後のレプリケーションジョブが失敗しました。新しい更新はレプリケートされません。