View a markdown version of this page

Verwaltung der S3-Tables-Replikation - Amazon Simple Storage Service
Überwachung des Replikationsstatus

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwaltung der S3-Tables-Replikation

Nachdem Sie die S3-Tabellen-Replikation konfiguriert haben, können Sie den Replikatstatus überwachen, um zu überprüfen, was repliziert wurde. Sie können den Replikationsstatus in der Amazon S3-Konsole auf der Registerkarte Verwaltung der Quelltabelle überprüfen oder indem Sie die verwenden. AWS CLI Weitere Informationen finden Sie unter. Einrichtung der S3-Tabellen-Replikation In diesem Thema wird erklärt, wie Sie die Replikation überwachen und die verschiedenen Statuswerte verstehen, die angeben, ob die Replikation abgeschlossen ist, im Gange ist oder fehlgeschlagen ist.

Überwachung des Replikationsstatus

Replikationsaufträge für Ihre replizierten Tabellen werden kontinuierlich ausgeführt. Sie können den Status der Replikation mit der GetTableReplicationStatus API abfragen oder ihn in der Amazon S3-Konsole anzeigen.

Um den Status der Replikation abzurufen, verwenden Sie den AWS CLI

Im folgenden Beispiel wird der Replikationsstatus mithilfe der GetTableReplicationStatus API abgerufen.


aws s3tables get-table-replication-status \
    --table-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket/table/sales-data

Erwartete Ausgabe:


{
  "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"
      }
    }
  ]
}

Weitere Informationen finden Sie unter get-table-replication-status in der Befehlsreferenz. AWS CLI

Das folgende Beispiel zeigt ein Ziel mit dem Status FAILED, das ein Feld enthält: 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."
}
Anmerkung

Der get-table-replication Befehl gibt die Replikationskonfiguration (Rolle, Regeln und Ziele) zurück. Der get-table-replication-status Befehl gibt den Replikationsstatus (COMPLETED, PENDING oder FAILED), die letzten replizierten Metadaten und Fehlermeldungen zurück.

Die Antwort verstehen

Die Antwort enthält die folgenden Elemente:

  • sourceTabLearn — Der ARN der Quelltabelle, die repliziert wird.

  • Ziele — Eine Reihe von Zielstatusobjekten, eines für jedes konfigurierte Replikationsziel. Jedes Zielobjekt enthält:

    • ReplicationStatus — Der aktuelle Replikationsstatus für dieses Ziel (COMPLETED, PENDING oder FAILED).

    • destinationBucketArn — Der ARN des Zieltabellen-Buckets.

    • destinationTabLearn — Der ARN der Replikattabelle im Ziel-Bucket.

    • last SuccessfulReplicatedUpdate — Informationen zur letzten erfolgreichen Replikation:

      • metadataLocation — Der Name der Iceberg-Metadatendatei, die zuletzt erfolgreich repliziert wurde. Vergleichen Sie dies mit dem aktuellen Speicherort der Metadaten der Quelltabelle, um festzustellen, ob die Replikation aktuell ist.

      • Zeitstempel — Der Zeitpunkt, zu dem diese Metadatendatei auf das Ziel repliziert wurde.

    • FailureMessage (nur vorhanden, wenn der Status FAILED lautet) — Eine detaillierte Fehlermeldung, die beschreibt, warum die Replikation fehlgeschlagen ist.

Werte für den Replikationsstatus

Die Replikation kann für jedes Ziel drei mögliche Status haben:

  • ABGESCHLOSSEN — Alle Snapshots der Quelltabelle wurden erfolgreich auf das Ziel repliziert. Der aktuelle Metadatenspeicherort der Quelltabelle entspricht dem Speicherort der letzten replizierten Metadaten.

  • AUSSTEHEND — Die Replikation ist im Gange oder neue Commits warten darauf, repliziert zu werden. Der aktuelle Metadatenspeicherort der Quelltabelle unterscheidet sich vom Speicherort der letzten replizierten Metadaten.

  • FEHLGESCHLAGEN — Der letzte Replikationsjob für diese Tabelle ist fehlgeschlagen. Es werden keine neuen Updates repliziert.

Wenn ein Ziel den Status FAILED (FEHLGESCHLAGEN) anzeigt, überprüfen Sie das failureMessage Feld auf weitere Informationen. Zu den häufigsten Ursachen gehören unzureichende Berechtigungen, der Ziel-Bucket wurde nicht gefunden oder Probleme mit dem KMS-Schlüssel. Nachdem Sie die Grundursache behoben haben, versucht der Dienst automatisch erneut, ihn zu replizieren. Sie können die Wiederherstellung überwachen, während der Status von FAILED zu PENDING zu COMPLETED wechselt.