管理 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 中繼資料檔案名稱。將此與來源資料表的目前中繼資料位置進行比較，以判斷複寫是否為最新狀態。

      • 時間戳記 – 此中繼資料檔案複寫至目的地的時間。

    • failureMessage （僅在狀態為 FAILED 時才存在） – 說明複寫失敗原因的詳細錯誤訊息。

複寫狀態值

每個目的地的複寫可以有三種可能的狀態：

  • 已完成 – 所有來源資料表快照已成功複寫至目的地。來源資料表的最新中繼資料位置符合上次複寫的中繼資料位置。

  • 擱置中 – 複寫正在進行中，或新的遞交正在等待複寫。來源資料表的最新中繼資料位置與上次複寫的中繼資料位置不同。

  • 失敗 – 此資料表的最後一個複寫任務失敗。沒有正在複寫的新更新。