Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Gestione della replica delle tabelle S3
Dopo aver configurato la replica di S3 Tables, puoi monitorare lo stato della replica per verificare cosa viene replicato. Puoi controllare lo stato della replica nella console Amazon S3 nella ** scheda ** Gestione della tabella di origine o utilizzando. AWS CLI Per ulteriori informazioni, consulta [Configurazione della replica delle tabelle S3](s3-tables-replication-setting-up.md) .Questo argomento spiega come monitorare la replica e comprendere i diversi valori di stato che indicano se la replica è completata, in corso o non è riuscita.
## Monitoraggio dello stato di replica
I processi di replica vengono eseguiti continuamente per le tabelle replicate. Puoi interrogare lo stato della replica con l' GetTableReplicationStatus API o visualizzarlo nella console Amazon S3.
### Per ottenere lo stato della replica utilizzando AWS CLI
L'esempio seguente ottiene lo stato della replica utilizzando l' GetTableReplicationStatusAPI.
```
aws s3tables get-table-replication-status \
--table-arn arn:aws:s3tables:{{us-east-1}}:{{111122223333}}:bucket/{{amzn-s3-demo-table-bucket}}/table/{{sales-data}}
```
Output 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}}"
}
}
]
}
```
Per ulteriori informazioni, vedere [ get-table-replication-status ](https://docs.aws.amazon.com/cli/latest/reference/s3tables/get-table-replication-status.html) nel Command Reference. *AWS CLI *
L'esempio seguente mostra una destinazione con lo stato FAILED, che include un campo: `failureMessage`
```
{
"replicationStatus": "FAILED",
"destinationBucketARN": "arn:aws:s3tables:{{eu-west-1}}:{{444455556666}}:bucket/{{amzn-s3-demo-table-bucket-partner}}",
"destinationTableARN": "arn:aws:s3tables:{{eu-west-1}}:{{444455556666}}:bucket/{{amzn-s3-demo-table-bucket-partner}}/table/{{sales-data}}",
"failureMessage": "Insufficient permissions given to successfully complete replication."
}
```
**Nota**
Il `get-table-replication` comando restituisce la configurazione della replica (ruolo, regole e destinazioni). Il `get-table-replication-status` comando restituisce lo stato della replica (COMPLETED, PENDING o FAILED), gli ultimi metadati replicati e i messaggi di errore.
### Comprensione della risposta
La risposta contiene i seguenti elementi:
+ **SourceTabLearn**: l'ARN della tabella sorgente da replicare.
+ **destinazioni**: una serie di oggetti di stato di destinazione, uno per ogni destinazione di replica configurata. Ogni oggetto di destinazione contiene:
+ **ReplicationStatus**: lo stato di replica corrente per questa destinazione (COMPLETATO, IN SOSPESO o FALLITO).
+ **destinationBucketArn — L'ARN del bucket ** della tabella di destinazione.
+ **destinationTabLearn ** — L'ARN della tabella di replica nel bucket di destinazione.
+ **last SuccessfulReplicatedUpdate ** — Informazioni sulla replica riuscita più recente:
+ **MetadataLocation**: il nome del file di metadati Iceberg che è stato replicato con successo l'ultima volta. Confrontalo con l'attuale posizione dei metadati della tabella di origine per determinare se la replica è aggiornata.
+ **timestamp**: l'ora in cui questo file di metadati è stato replicato nella destinazione.
+ **failureMessage ** (presente solo quando lo stato è FAILED): un messaggio di errore dettagliato che descrive il motivo per cui la replica non è riuscita.
### Valori dello stato della replica
La replica può avere tre stati possibili per ciascuna destinazione:
+ **COMPLETATO**: tutte le istantanee della tabella di origine sono state replicate correttamente nella destinazione. L'ultima posizione dei metadati della tabella di origine corrisponde all'ultima posizione dei metadati replicati.
+ **IN SOSPESO**: la replica è in corso o nuovi commit sono in attesa di essere replicati. L'ultima posizione dei metadati della tabella di origine è diversa dall'ultima posizione dei metadati replicati.
+ **FALLITO**: l'ultimo processo di replica per questa tabella non è riuscito. Nessun nuovo aggiornamento viene replicato.
Se una destinazione mostra lo stato NON RIUSCITO, controlla il `failureMessage` campo per i dettagli. Le cause più comuni includono autorizzazioni insufficienti, bucket di destinazione non trovato o problemi chiave del KMS. Dopo aver risolto la causa principale, il servizio riprova automaticamente la replica. È possibile monitorare il ripristino man mano che lo stato passa da FALLITO a IN SOSPESO a COMPLETATO.