View a markdown version of this page

Gestione della replica delle tabelle S3 - Amazon Simple Storage Service
Monitoraggio dello stato di replica

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 .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 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.