管理 S3 表类数据存储服务复制 - Amazon Simple Storage Service
监控复制状态

管理 S3 表类数据存储服务复制

在配置 S3 表类数据存储服务复制后，您可以监控副本状态以验证复制的内容。您可以在 Amazon S3 控制台的源表的管理选项卡中或使用 AWS CLI 查看复制状态。有关更多信息，请参阅设置 S3 表类数据存储服务复制。本主题介绍如何监控复制和了解指示复制已完成、正在进行或已失败的不同状态值。

监控复制状态

所复制表的复制作业会持续运行。您可以使用 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。

  • destinations：目标状态对象的数组，每个已配置的复制目标对应一个。每个目标对象都包含：

    • replicationStatus：此目标的当前复制状态（COMPLETED、PENDING 或 FAILED）。

    • destinationBucketARN：目标表存储桶的 ARN。

    • destinationTableARN：目标存储桶中副本表的 ARN。

    • lastSuccessfulReplicatedUpdate：有关最近成功的复制的信息：

      • metadataLocation：上次成功复制的 Iceberg 元数据文件名。将其与源表的当前元数据位置进行比较，以确定复制是否为最新。

      • timestamp：将此元数据文件复制到目标的时间。

    • failureMessage（仅在状态为 FAILED 时出现）：描述复制失败原因的详细错误消息。

复制状态值

对于每个目标表，复制可能有三种状态：

  • COMPLETED：所有源表快照已成功复制到目标。源表的最新元数据位置与上次复制的元数据位置匹配。

  • PENDING：正在进行复制或正在等待复制新提交的内容。源表的最新元数据位置与上次复制的元数据位置不同。

  • FAILED：此表的最后一个复制作业失败。没有新的更新正在复制中。