# 管理 S3 表类数据存储服务复制
<a name="s3-tables-replication-managing"></a>

在配置 S3 表类数据存储服务复制后，您可以监控副本状态以验证复制的内容。您可以在 Amazon S3 控制台的源表的**管理**选项卡中或使用 AWS CLI 查看复制状态。有关更多信息，请参阅[设置 S3 表类数据存储服务复制](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。
+ **destinations**：目标状态对象的数组，每个已配置的复制目标对应一个。每个目标对象都包含：
  + **replicationStatus**：此目标的当前复制状态（COMPLETED、PENDING 或 FAILED）。
  + **destinationBucketARN**：目标表存储桶的 ARN。
  + **destinationTableARN**：目标存储桶中副本表的 ARN。
  + **lastSuccessfulReplicatedUpdate**：有关最近成功的复制的信息：
    + **metadataLocation**：上次成功复制的 Iceberg 元数据文件名。将其与源表的当前元数据位置进行比较，以确定复制是否为最新。
    + **timestamp**：将此元数据文件复制到目标的时间。
  + **failureMessage**（仅在状态为 FAILED 时出现）：描述复制失败原因的详细错误消息。

### 复制状态值
<a name="s3-tables-replication-status-values"></a>

对于每个目标表，复制可能有三种状态：
+ **COMPLETED**：所有源表快照已成功复制到目标。源表的最新元数据位置与上次复制的元数据位置匹配。
+ **PENDING**：正在进行复制或正在等待复制新提交的内容。源表的最新元数据位置与上次复制的元数据位置不同。
+ **FAILED**：此表的最后一个复制作业失败。没有新的更新正在复制中。