本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 管理 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 中繼資料檔案名稱。將此與來源資料表目前的中繼資料位置進行比較，以判斷複寫是否為最新狀態。
    + **時間戳記** – 此中繼資料檔案複寫至目的地的時間。
  + **failureMessage** （僅在狀態為 FAILED 時才存在） – 說明複寫失敗原因的詳細錯誤訊息。

### 複寫狀態值
<a name="s3-tables-replication-status-values"></a>

每個目的地的複寫可以有三種可能的狀態：
+ **已完成** – 所有來源資料表快照已成功複寫至目的地。來源資料表的最新中繼資料位置符合上次複寫的中繼資料位置。
+ **擱置中** – 複寫正在進行中，或新的遞交正在等待複寫。來源資料表的最新中繼資料位置與上次複寫的中繼資料位置不同。
+ **失敗** – 此資料表的最後一個複寫任務失敗。沒有正在複寫的新更新。