GlobalTableNotFoundException

TL;DR — DescribeGlobalTable / UpdateGlobalTable hanya melihat tabel global versi 2017.11.29 (Legacy). Tabel global yang dibangun pada versi 2019.11.21 (Saat Ini) — yang seharusnya Anda gunakan — dikelola sebagai tabel biasa dengan replika melalui DescribeTable / UpdateTable, dan API lama melaporkannya sebagai tidak ada. Periksa versi yang Anda gunakan sebelum berasumsi bahwa tabel tersebut hilang.

Apa artinya

GlobalTableNotFoundException: The specified global table does not exist.

# what the engine actually returns, reproduced against the live DynamoDB service:
GlobalTableNotFoundException: Global table not found: Global table with name: 'no-such-global-table' does not exist.

Mengapa itu terjadi

Tabel ini adalah tabel global versi saat ini (21.11.2019) — sejauh ini merupakan penyebab umum: API lama tidak mengindeksnya.
Tidak ada tabel global yang pernah dibuat dengan nama tersebut — tabel ada tetapi tidak memiliki replika, atau penyiapan replikasi gagal sebelumnya.
Wilayah Salah atau salah ketik nama — pendaftaran tabel global lama dicari berdasarkan nama persisnya.

Bagaimana cara memperbaikinya

Tentukan versinya:

aws dynamodb describe-table --table-name orders \
  --query 'Table.GlobalTableVersion'
# "2019.11.21" → use DescribeTable/UpdateTable, not the legacy APIs

Kelola replika versi saat ini melalui UpdateTable:
```
aws dynamodb update-table --table-name orders \
  --replica-updates '[{"Create": {"RegionName": "eu-west-1"}}]'
```
dan periksa dengan describe-table (bidang Replicas) bukan describe-global-table.
Pada perkakas lama? Jika Anda benar-benar mengoperasikan tabel global 2017.11.29, verifikasi nama dan Wilayah pendaftaran — dan rencanakan peningkatan ke 21.11.2019, yang direkomendasikan AWS untuk fleksibilitas dan biaya penulisan replikasi yang lebih rendah.
Membuat dari awal: buat tabel, lalu tambahkan replika melalui UpdateTable — jangan menggunakan CreateGlobalTable (lama) dalam kode baru.
Konfirmasi Wilayah pada setiap panggilan. API tabel global lama memiliki cakupan Wilayah; nama yang ada di us-east-1 mungkin tidak dapat diselesaikan dari eu-west-1.

Cek ukuran di DynoTable

DynoTable terhubung ke setiap Wilayah dari satu jendela — beralih dengan ⌘P dan buka nama tabel yang sama di setiap profil untuk melihat apakah ada replika dan menyajikan data. Sidebar tabel memperlihatkan metadata replikasi tanpa memanggil API tabel global lama.

Sebelum menambahkan replika, perkirakan biaya penulisan yang direplikasi dengan kalkulator harga. Konfigurasikan setiap Wilayah di bawah Pengaturan → Profil dan jalankan Uji Koneksi sebelum Anda menjalankan pembaruan replika UpdateTable. Lihat Menghubungkan ke AWS dan Instal. Jika perkakas lama memanggil DescribeGlobalTable, periksa GlobalTableVersion di DescribeTable terlebih dahulu — Tabel versi saat ini menampilkan 2019.11.21 dan harus dikelola melalui UpdateTable. API lama tidak dapat melihatnya meskipun replikasinya sehat. Tingkatkan perkakas untuk memanggil UpdateTable dengan ReplicaUpdates untuk tabel Versi saat ini, bukan CreateGlobalTable.

Sumber

Versi tabel global DynamoDB (diverifikasi 13-07-2026)
UpdateTable — Referensi Amazon DynamoDB API (diverifikasi 13-07-2026)

Kesalahan terkait

Ketidakcocokan versi tabel global — pemisahan dua generasi yang sama, dilakukan dari jalur peningkatan.
ReplicaNotFoundException — Wilayah bukan bagian dari grup replikasi.
ReplicaAlreadyExistsException — Wilayah sudah ada.
Pelajari: tabel global DynamoDB

Referensi

Terakhir diverifikasi 2026-07-13 berdasarkan dokumentasi resmi AWS yang ditautkan di atas.