Gerenciar a replicação de tabelas do S3 - Amazon Simple Storage Service
Monitorar os estados de replicação

Gerenciar a replicação de tabelas do S3

Após a configuração da replicação de tabelas do S3, é possível monitorar o status da réplica para verificar o que foi replicado. Você pode verificar o status da replicação no console do Amazon S3 na guia Gerenciamento da tabela de origem ou usando a AWS CLI. Para ter mais informações, consulte Configurar a replicação de tabelas do S3. Esse tópico explica como monitorar a replicação e entender os diferentes valores de status que indicam se a replicação foi concluída, está em andamento ou falhou.

Monitorar os estados de replicação

Os trabalhos de replicação são executados continuamente para as tabelas replicadas. É possível consultar o status da replicação com a API GetTableReplicationStatus ou visualizá-lo no console do Amazon S3.

Como obter o status da replicação usando a AWS CLI

O exemplo a seguir obtém o status de replicação usando a 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

Saída esperada:


{
  "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 ter mais informações, consulte get-table-replication-status na Referência de comandos da AWS CLI.

Como interpretar a resposta

A resposta contém os seguintes elementos:

  • sourceTableARN: o ARN da tabela de origem que está sendo replicada.

  • destinations: uma matriz de objetos de status de destino, um para cada destino de replicação configurado. Cada objeto de destino contém:

    • replicationStatus: o status atual da replicação desse destino (COMPLETED, PENDING ou FAILED).

    • destinationBucketARN: o ARN do bucket da tabela de destino.

    • destinationTableARN: o ARN do bucket da tabela de réplica no bucket de destino.

    • lastSuccessfulReplicatedUpdate: informações sobre a replicação bem-sucedida mais recente:

      • metadataLocation: o nome do arquivo de metadados do Iceberg que foi replicado com êxito pela última vez. Compare isso com o local atual dos metadados da tabela de origem para determinar se a replicação está atualizada.

      • timestamp: a hora em que esse arquivo de metadados foi replicado para o destino.

    • failureMessage (presente somente quando o status é FAILED): uma mensagem de erro detalhada descrevendo por que a replicação falhou.

Valores de status da replicação

A replicação pode ter três status possíveis para cada destino:

  • COMPLETED: todos os snapshots da tabela de origem foram replicados com êxito no destino. O local mais recente dos metadados da tabela de origem corresponde ao local dos metadados da última replicação.

  • PENDING: a replicação está em andamento ou novas replicações confirmadas estão aguardando para serem replicadas. O local mais recente dos metadados da tabela de origem difere do local dos metadados da última replicação.

  • FAILED: a última tarefa de replicação dessa tabela falhou. Nenhuma nova atualização está sendo replicada.