View a markdown version of this page

Mengelola replikasi Tabel S3 - Amazon Simple Storage Service
Memantau status replikasi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengelola replikasi Tabel S3

Setelah mengonfigurasi replikasi Tabel S3, Anda dapat memantau status replika untuk memverifikasi apa yang direplikasi. Anda dapat memeriksa status replikasi di konsol Amazon S3 pada tab Manajemen tabel sumber, atau dengan menggunakan AWS CLI. Untuk informasi selengkapnyaMenyiapkan replikasi Tabel S3, lihat Topik ini menjelaskan cara memantau replikasi dan memahami berbagai nilai status yang menunjukkan apakah replikasi selesai, sedang berlangsung, atau gagal.

Memantau status replikasi

Pekerjaan replikasi berjalan terus menerus untuk tabel yang direplikasi. Anda dapat menanyakan status replikasi dengan GetTableReplicationStatus API atau melihatnya di konsol Amazon S3.

Untuk mendapatkan status replikasi dengan menggunakan AWS CLI

Contoh berikut mendapatkan status replikasi menggunakan GetTableReplicationStatus API.


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

Keluaran yang diharapkan


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

Untuk informasi selengkapnya, lihat get-table-replication- status di Referensi Perintah. AWS CLI

Contoh berikut menunjukkan tujuan dengan status GAGAL, yang mencakup failureMessage bidang:


{
  "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."
}
catatan

Per get-table-replication intah mengembalikan konfigurasi replikasi (peran, aturan, dan tujuan). Per get-table-replication-status intah mengembalikan status replikasi (SELESAI, PENDING, atau GAGAL), metadata yang direplikasi terakhir, dan pesan kesalahan.

Memahami respon

Tanggapan berisi elemen-elemen berikut:

  • SourceTabLearn — ARN dari tabel sumber yang direplikasi.

  • destinasi — Sebuah array objek status tujuan, satu untuk setiap tujuan replikasi yang dikonfigurasi. Setiap objek tujuan berisi:

    • ReplicationStatus — Status replikasi saat ini untuk tujuan ini (SELESAI, TERTUNDA, atau GAGAL).

    • DestinationBucketarn — ARN dari bucket tabel tujuan.

    • DestinationTabLearn — ARN tabel replika di bucket tujuan.

    • terakhir SuccessfulReplicatedUpdate — Informasi tentang replikasi terbaru yang berhasil:

      • MetaDataLoc ation — Nama file metadata gunung es yang terakhir berhasil direplikasi. Bandingkan ini dengan lokasi metadata tabel sumber saat ini untuk menentukan apakah replikasi sudah mutakhir.

      • timestamp — Waktu ketika file metadata ini direplikasi ke tujuan.

    • failureMessage (hanya hadir saat status GAGAL) — Pesan kesalahan terperinci yang menjelaskan mengapa replikasi gagal.

Nilai status replikasi

Replikasi dapat memiliki tiga kemungkinan status untuk setiap tujuan:

  • SEL ESAI - Semua snapshot tabel sumber telah berhasil direplikasi ke tujuan. Lokasi metadata terbaru tabel sumber cocok dengan lokasi metadata yang direplikasi terakhir.

  • TER TUNDA — Replikasi sedang berlangsung atau commit baru sedang menunggu untuk direplikasi. Lokasi metadata terbaru tabel sumber berbeda dari lokasi metadata yang direplikasi terakhir.

  • GAG AL — Pekerjaan replikasi terakhir untuk tabel ini gagal. Tidak ada pembaruan baru yang direplikasi.

Jika tujuan menunjukkan status GAGAL, periksa failureMessage bidang untuk detailnya. Penyebab umum termasuk izin yang tidak mencukupi, bucket tujuan tidak ditemukan, atau masalah kunci KMS. Setelah Anda memperbaiki akar penyebab, layanan akan secara otomatis mencoba ulang replikasi. Anda dapat memantau pemulihan saat status transisi dari GAGAL ke PENDING ke SELESAI.