# Gerenciar a replicação de tabelas do S3
<a name="s3-tables-replication-managing"></a>

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](s3-tables-replication-setting-up.md). 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
<a name="s3-tables-replication-monitoring-status"></a>

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
<a name="s3-tables-replication-status-cli"></a>

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](https://docs.aws.amazon.com/cli/latest/reference/s3tables/get-table-replication-status.html) na *Referência de comandos da AWS CLI*.

### Como interpretar a resposta
<a name="s3-tables-replication-understanding-response"></a>

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 name="s3-tables-replication-status-values"></a>

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.