Administración de la replicación de tablas de S3 - Amazon Simple Storage Service
Supervisión de estado de replicación

Administración de la replicación de tablas de S3

Después de configurar la replicación de tablas de S3, puede supervisar el estado de la réplica para comprobar qué está replicado. Puede comprobar el estado de la replicación en la consola de Amazon S3, en la pestaña Administración de la tabla de origen o mediante la AWS CLI. Para obtener más información, consulte Configuración de la replicación de tablas de S3. Este tema explica cómo supervisar la replicación y comprender los diferentes valores de estado que indican si la replicación se ha completado, está en curso o ha producido un error.

Supervisión de estado de replicación

Los trabajos de replicación se ejecutan de forma continua para las tablas replicadas. Para consultar el estado de la replicación, puede usar la API GetTableReplicationStatus o puede verlo en la consola de Amazon S3.

Obtención del estado de la replicación mediante la AWS CLI

En el ejemplo siguiente se obtiene el estado de la replicación mediante la API GetTableReplicationStatus.


aws s3tables get-table-replication-status \
    --table-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket/table/sales-data

Resultado previsto:


{
  "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"
      }
    }
  ]
}

Para obtener más información, consulte get-table-replication-status en la Referencia de comandos de la AWS CLI.

Interpretación de la respuesta

La respuesta contiene los componentes siguientes:

  • sourceTableARN: el ARN de la tabla de origen que se está replicando.

  • destinos: una matriz de objetos de estado de destino, uno para cada destino de replicación configurado. Cada objeto de destino contiene:

    • replicationStatus: el estado de replicación actual de este destino (COMPLETADO, PENDIENTE o ERRÓNEO).

    • destinationBucketARN: el ARN del bucket de tablas de destino.

    • destinationTableARN: el ARN de la tabla de réplica en el bucket de destino.

    • lastSuccessfulReplicatedUpdate: información sobre la replicación exitosa más reciente:

      • metadataLocation: el nombre del archivo de metadatos de Iceberg que se replicó correctamente por última vez. Compárelo con la ubicación actual de los metadatos de la tabla de origen para determinar si la replicación está actualizada.

      • marca temporal: la hora en que este archivo de metadatos se replicó en el destino.

    • failureMessage (solo está presente cuando el estado es ERRÓNEO): un mensaje de error detallado que describe por qué se ha producido un error en la replicación.

Valores de estado de la replicación

La replicación puede tener tres estados posibles para cada destino:

  • COMPLETADA: todas las instantáneas de la tabla de origen se han replicado correctamente en el destino. La ubicación de metadatos más reciente de la tabla de origen coincide con la última ubicación de metadatos replicada.

  • PENDIENTE: la replicación está en curso o hay nuevas confirmaciones a la espera de replicación. La ubicación de metadatos más reciente de la tabla de origen difiere de la última ubicación de metadatos replicada.

  • ERROR: se produjo un error en el último trabajo de replicación de esta tabla. No se está replicando ninguna actualización nueva.