Gestione della replica di S3 Tables - 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 di S3 Tables

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 oppure utilizzando il. 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 lavori di replica vengono eseguiti continuamente per le tabelle replicate. Puoi interrogare lo stato della replica con l' GetTableReplicationStatus API o visualizzarla 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, consulta get-table-replication-status nella documentazione di riferimento dei comandi della AWS CLI .

Comprendere la risposta

La risposta contiene i seguenti elementi:

  • SourceTabLearn: l'ARN della tabella di origine da replicare.

  • destinazioni: una matrice di oggetti di stato della destinazione, uno per ogni destinazione di replica configurata. Ogni oggetto di destinazione contiene:

    • ReplicationStatus — Lo stato di replica corrente per questa destinazione (COMPLETATA, PENDING o FAILED).

    • destinationBucketARN — L'ARN del bucket della tabella di destinazione.

    • DestinationTabLearn — L'ARN della tabella di replica nel bucket di destinazione.

    • lastSuccessfulReplicatedAggiornamento: 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 è FAILURE): 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 ogni destinazione:

  • COMPLETATA: 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 replicata.

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

  • FALLITO: l'ultimo processo di replica per questa tabella non è riuscito. Non viene replicato nessun nuovo aggiornamento.