Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# DynamoDB versi tabel global
Ada dua versi tabel global DynamoDB yang tersedia: Tabel Global versi 2019.11.21 (Saat Ini) dan tabel Global versi 2017.11.29 (Legacy). Kami merekomendasikan penggunaan Tabel Global versi 2019.11.21 (Saat Ini), karena lebih mudah digunakan, didukung di lebih banyak Wilayah, dan biaya lebih rendah untuk sebagian besar beban kerja dibandingkan dengan versi 2017.11.29 (Legacy).
## Menentukan versi tabel global
### Menentukan versi menggunakan AWS CLI
#### Mengidentifikasi versi 2019.11.21 (Saat ini) replika tabel global
Untuk menentukan apakah tabel adalah replika versi tabel global 2019.11.21 (Saat ini), panggil perintah untuk tabel`describe-table`. Jika output berisi `GlobalTableVersion` atribut dengan nilai “2019.11.21", tabelnya adalah replika tabel global versi 2019.11.21 (Saat ini).
Contoh perintah CLI untuk: `describe-table`
```
aws dynamodb describe-table \
--table-name users \
--region us-east-2
```
Output (ringkasan) berisi `GlobalTableVersion` atribut dengan nilai “2019.11.21", jadi tabel ini adalah replika tabel global versi 2019.11.21 (Saat ini).
```
{
"Table": {
"AttributeDefinitions": [
{
"AttributeName": "id",
"AttributeType": "S"
},
{
"AttributeName": "name",
"AttributeType": "S"
}
],
"TableName": "users",
...
"GlobalTableVersion": "2019.11.21",
"Replicas": [
{
"RegionName": "us-west-2",
"ReplicaStatus": "ACTIVE",
}
],
...
}
}
```
#### Mengidentifikasi replika tabel global versi 2017.11.29 (Legacy)
Versi tabel global 2017.11.29 (Legacy) menggunakan serangkaian perintah khusus untuk manajemen tabel global. Untuk menentukan apakah tabel adalah replika tabel global versi 2017.11.29 (Legacy), panggil perintah untuk tabel tersebut. `describe-global-table` Jika Anda menerima respons yang berhasil, tabel adalah replika tabel global versi 2017.11.29 (Legacy). Jika `describe-global-table` perintah mengembalikan `GlobalTableNotFoundException` kesalahan, tabel bukan replika versi 2017.11.29 (Legacy).
Contoh perintah CLI untuk: `describe-global-table`
```
aws dynamodb describe-global-table \
--table-name users \
--region us-east-2
```
Perintah mengembalikan respons yang berhasil, jadi tabel ini adalah replika tabel global versi 2017.11.29 (Legacy).
```
{
"GlobalTableDescription": {
"ReplicationGroup": [
{
"RegionName": "us-west-2"
},
{
"RegionName": "us-east-2"
}
],
"GlobalTableArn": "arn:aws:dynamodb::123456789012:global-table/users",
"CreationDateTime": "2025-06-10T13:55:53.630000-04:00",
"GlobalTableStatus": "ACTIVE",
"GlobalTableName": "users"
}
}
```
### Menentukan versi menggunakan DynamoDB Console
Untuk mengidentifikasi versi replika tabel global, lakukan hal berikut:
1. [Buka konsol DynamoDB di rumah. https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/home)
1. Di panel navigasi di sisi kiri konsol, pilih **Tabel**.
1. Pilih tabel yang ingin Anda identifikasi untuk versi tabel global.
1. Pilih tab **Tabel Global**.
Bagian *Ringkasan* menampilkan versi tabel global yang digunakan.
## Perbedaan perilaku antara versi Legacy dan Current
Daftar berikut menjelaskan perbedaan perilaku antara versi Legacy dan Current dari tabel global.
+ versi 2019.11.21 (Saat ini) mengkonsumsi lebih sedikit kapasitas tulis untuk beberapa operasi DynamoDB dibandingkan dengan versi 2017.11.29 (Legacy), dan oleh karena itu, lebih hemat biaya bagi sebagian besar pelanggan. Perbedaan untuk operasi DynamoDB ini adalah sebagai berikut:
+ [PutItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_PutItem.html)Memanggil item 1KB di Wilayah dan mereplikasi ke Wilayah lain membutuhkan 2 r WRUs per wilayah untuk 2017.11.29 (Warisan), tetapi hanya 1 rWRU untuk 2019.11.21 (Saat Ini).
+ Memanggil [UpdateItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateItem.html)item 1KB membutuhkan 2 r WRUs di Wilayah sumber dan 1 RwRU per Wilayah tujuan untuk 2017.11.29 (Warisan), tetapi hanya 1 rWRU untuk Wilayah sumber dan tujuan untuk 2019.11.21 (Saat Ini).
+ Memanggil [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html)item 1KB membutuhkan 1 rWRU di Wilayah sumber dan 2 r WRUs per Wilayah tujuan untuk 2017.11.29 (Warisan), tetapi hanya 1 rWRU untuk Wilayah sumber atau tujuan untuk 2019.11.21 (Saat Ini).
Tabel berikut menunjukkan konsumsi RwRU tabel 2017.11.29 (Legacy) dan 2019.11.21 (Saat Ini) untuk item 1KB di dua Wilayah.
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/V2globaltables_versions.html)
+ versi 2017.11.29 (Legacy) hanya tersedia di 11. Region AWS Namun, versi 2019.11.21 (Saat ini) tersedia di semua. Region AWS
+ Anda membuat tabel global versi 2017.11.29 (Legacy) dengan terlebih dahulu membuat satu set tabel Regional kosong, lalu memanggil [CreateGlobalTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateGlobalTable.html)API untuk membentuk tabel global. Anda membuat tabel global versi 2019.11.21 (Saat ini) dengan menjalankan [UpdateTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html)API untuk menambahkan replika ke tabel Regional yang ada.
+ versi 2017.11.29 (Legacy) mengharuskan Anda untuk mengosongkan semua replika dalam tabel sebelum menambahkan replika di Wilayah baru (termasuk selama pembuatan). versi 2019.11.21 (Saat ini) mendukung Anda untuk menambah dan menghapus replika ke Wilayah pada tabel yang sudah berisi data.
+ versi 2017.11.29 (Legacy) menggunakan kumpulan bidang APIs kontrol khusus berikut untuk mengelola replika:
+ [CreateGlobalTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateGlobalTable.html)
+ [DescribeGlobalTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeGlobalTable.html)
+ [DescribeGlobalTableSettings](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeGlobalTableSettings.html)
+ [ListGlobalTables](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ListGlobalTables.html)
+ [UpdateGlobalTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateGlobalTable.html)
+ [UpdateGlobalTableSettings](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateGlobalTableSettings.html)
versi 2019.11.21 (Saat ini) menggunakan [DescribeTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeTable.html)dan [UpdateTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html) APIs untuk mengelola replika.
+ versi 2017.11.29 (Legacy) menerbitkan dua catatan DynamoDB Streams untuk setiap penulisan. versi 2019.11.21 (Saat ini) hanya menerbitkan satu catatan DynamoDB Streams untuk setiap penulisan.
+ versi 2017.11.29 (Legacy) mengisi dan memperbarui`aws:rep:deleting`,`aws:rep:updateregion`, dan `aws:rep:updatetime` atribut. versi 2019.11.21 (Saat ini) tidak mengisi atau memperbarui atribut ini.
+ versi 2017.11.29 (Legacy) tidak menyinkronkan pengaturan di seluruh replika. versi 2019.11.21 (Saat ini) menyinkronkan [Menggunakan time to live (TTL) di DynamoDB](TTL.md) pengaturan TTL di seluruh replika.
+ versi 2017.11.29 (Legacy) tidak mereplikasi penghapusan TTL ke replika lain. versi 2019.11.21 (Saat ini) mereplikasi penghapusan TTL ke semua replika.
+ versi 2017.11.29 (Legacy) tidak menyinkronkan pengaturan penskalaan [otomatis di seluruh replika. versi 2019.11.21 (Saat ini) menyinkronkan pengaturan penskalaan otomatis](AutoScaling.md) di seluruh replika.
+ versi 2017.11.29 (Legacy) tidak menyinkronkan pengaturan [indeks sekunder global (GSI) di seluruh replika. versi 2019.11.21 (Saat ini)](GSI.md) menyinkronkan pengaturan GSI di seluruh replika.
+ versi 2017.11.29 (Legacy) tidak menyinkronkan [enkripsi pada pengaturan istirahat di seluruh replika. versi 2019.11.21 (Saat ini) menyinkronkan enkripsi pada pengaturan istirahat](encryption.usagenotes.md) di seluruh replika.
+ versi 2017.11.29 (Legacy) menerbitkan metrik. versi 2019.11.21 (Saat ini) tidak mempublikasikan `PendingReplicationCount` metrik ini.
## Upgrade ke versi saat ini
### Izin yang diperlukan untuk peningkatan tabel global
Untuk meningkatkan ke versi 2019.11.21 (Saat ini), Anda harus memiliki `dynamodb:UpdateGlobalTableversion` izin di semua Wilayah dengan replika. Izin ini diperlukan selain izin yang diperlukan untuk mengakses konsol DynamoDB dan tabel tampilan.
Kebijakan IAM berikut memberikan izin untuk memutakhirkan tabel global apa pun ke versi 2019.11.21 (Saat Ini).
```
{
"version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "dynamodb:UpdateGlobalTableversion",
"Resource": "*"
}
]
}
```
Kebijakan IAM berikut memberikan izin untuk memutakhirkan hanya tabel `Music` global dengan replika di dua Wilayah ke versi 2019.11.21 (Saat Ini).
```
{
"version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "dynamodb:UpdateGlobalTableversion",
"Resource": [
"arn:aws:dynamodb::123456789012:global-table/Music",
"arn:aws:dynamodb:ap-southeast-1:123456789012:table/Music",
"arn:aws:dynamodb:us-east-2:123456789012:table/Music"
]
}
]
}
```
### Apa yang diharapkan selama upgrade
+ Semua replika tabel global akan terus memproses lalu lintas baca dan tulis saat meningkatkan.
+ Proses upgrade membutuhkan antara beberapa menit hingga beberapa jam tergantung pada ukuran tabel dan jumlah replika.
+ Selama proses upgrade, nilai [TableStatus](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TableDescription.html#DDB-Type-TableDescription-TableStatus)akan berubah dari `ACTIVE` ke`UPDATING`. Anda dapat melihat status tabel dengan menjalankan [DescribeTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeTable.html)API, atau dengan tampilan **Tabel di konsol DynamoDB**.
+ Penskalaan otomatis tidak akan menyesuaikan pengaturan kapasitas yang disediakan untuk tabel global saat tabel sedang ditingkatkan. Kami sangat menyarankan Anda mengatur tabel ke mode kapasitas [sesuai permintaan](capacity-mode.md#capacity-mode-on-demand) selama peningkatan.
+ Jika Anda memilih untuk menggunakan mode kapasitas [yang disediakan dengan](provisioned-capacity-mode.md) penskalaan otomatis selama peningkatan, Anda harus meningkatkan throughput baca dan tulis minimum pada kebijakan Anda untuk mengakomodasi peningkatan lalu lintas yang diharapkan untuk menghindari pembatasan selama peningkatan.
+ `ReplicationLatency`Metrik dapat melaporkan lonjakan latensi sementara atau menghentikan pelaporan data metrik selama proses peningkatan. Lihat,[ReplicationLatency](metrics-dimensions.md#ReplicationLatency), untuk informasi lebih lanjut.
+ Ketika proses upgrade selesai, status tabel Anda akan berubah menjadi`ACTIVE`.
### Perilaku DynamoDB Streams sebelum, selama, dan setelah peningkatan
- ****Masukkan atau Perbarui****
- **Wilayah Replika:** **Sumber** / **Perilaku sebelum upgrade:** Populasi stempel waktu terjadi menggunakan. [UpdateItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateItem.html) / **Perilaku selama peningkatan:** Populasi stempel waktu terjadi menggunakan. [PutItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_PutItem.html) / **Perilaku setelah peningkatan:** Tidak ada stempel waktu yang terlihat pelanggan yang dihasilkan.
- **Perilaku sebelum upgrade:** Dua catatan Streams dihasilkan. Catatan pertama berisi atribut tertulis pelanggan. Catatan kedua berisi aws:rep:\* atribut. / **Perilaku selama peningkatan:** Dua catatan Streams dihasilkan. Catatan pertama berisi atribut tertulis pelanggan. Catatan kedua berisi aws:rep:\* atribut. / **Perilaku setelah peningkatan:** Catatan Streams tunggal dihasilkan yang berisi atribut yang ditulis pelanggan.
- **Perilaku sebelum upgrade:** Dua r WCUs dikonsumsi untuk setiap pelanggan menulis. / **Perilaku selama peningkatan:** Dua r WCUs dikonsumsi untuk setiap pelanggan menulis. / **Perilaku setelah peningkatan:** Satu RWCu dikonsumsi untuk setiap pelanggan menulis.
- **Perilaku sebelum upgrade:** ReplicationLatencydan PendingReplicationCount metrik dipublikasikan di CloudWatch. / **Perilaku selama peningkatan:** ReplicationLatencydan PendingReplicationCount metrik dipublikasikan di CloudWatch. / **Perilaku setelah peningkatan:** ReplicationLatencymetrik diterbitkan di CloudWatch.
- **Wilayah Replika:** **Destinasi** / **Perilaku sebelum upgrade:** Replikasi terjadi dengan menggunakan PutItem. / **Perilaku selama peningkatan:** Replikasi terjadi dengan menggunakan PutItem. / **Perilaku setelah peningkatan:** Replikasi terjadi dengan menggunakan PutItem.
- **Perilaku sebelum upgrade:** Catatan Streams tunggal dihasilkan, yang berisi atribut yang ditulis pelanggan dan atribut. aws:rep:\* / **Perilaku selama peningkatan:** Catatan Streams tunggal dihasilkan, yang berisi atribut yang ditulis pelanggan dan atribut. aws:rep:\* / **Perilaku setelah peningkatan:** Rekaman Streams tunggal dihasilkan, yang berisi atribut yang ditulis pelanggan saja dan tidak ada atribut replikasi.
- **Perilaku sebelum upgrade:** Satu RWCu dikonsumsi jika item tersebut ada di Wilayah tujuan. Dua r WCUs dikonsumsi jika item tidak ada di Wilayah tujuan. / **Perilaku selama peningkatan:** Satu RWCu dikonsumsi jika item tersebut ada di Wilayah tujuan. Dua r WCUs dikonsumsi jika item tidak ada di Wilayah tujuan. / **Perilaku setelah peningkatan:** Satu RWCu dikonsumsi untuk setiap pelanggan menulis.
- **Perilaku sebelum upgrade:** ReplicationLatencydan PendingReplicationCount metrik dipublikasikan di CloudWatch. / **Perilaku selama peningkatan:** ReplicationLatencydan PendingReplicationCount metrik dipublikasikan di CloudWatch. / **Perilaku setelah peningkatan:** ReplicationLatencymetrik diterbitkan di CloudWatch.
- ****Hapus****
- **Wilayah Replika:** **Sumber** / **Perilaku sebelum upgrade:** Hapus item apa pun dengan stempel waktu yang lebih kecil menggunakan. [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html) / **Perilaku selama peningkatan:** Hapus item apa pun dengan stempel waktu yang lebih kecil menggunakan. DeleteItem / **Perilaku setelah peningkatan:** Hapus item apa pun dengan stempel waktu yang lebih kecil menggunakan. DeleteItem
- **Perilaku sebelum upgrade:** Catatan Streams tunggal dihasilkan, yang berisi atribut yang ditulis pelanggan dan atribut. aws:rep:\* / **Perilaku selama peningkatan:** Catatan Streams tunggal dihasilkan, yang berisi atribut yang ditulis pelanggan dan atribut. aws:rep:\* / **Perilaku setelah peningkatan:** Rekaman Streams tunggal dihasilkan, yang berisi atribut yang ditulis pelanggan.
- **Perilaku sebelum upgrade:** Satu RWCu dikonsumsi untuk setiap penghapusan pelanggan. / **Perilaku selama peningkatan:** Satu RWCu dikonsumsi untuk setiap penghapusan pelanggan. / **Perilaku setelah peningkatan:** Satu RWCu dikonsumsi untuk setiap penghapusan pelanggan.
- **Perilaku sebelum upgrade:** ReplicationLatencydan PendingReplicationCount metrik dipublikasikan di CloudWatch. / **Perilaku selama peningkatan:** ReplicationLatencydan PendingReplicationCount metrik dipublikasikan di CloudWatch. / **Perilaku setelah peningkatan:** ReplicationLatencymetrik diterbitkan di CloudWatch.
- **Wilayah Replika:** **Destinasi** / **Perilaku sebelum upgrade:** Penghapusan dua fase terjadi:[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/amazondynamodb/latest/developerguide/V2globaltables_versions.html) / **Perilaku selama peningkatan:** Menghapus item menggunakan DeleteItem. / **Perilaku setelah peningkatan:** Menghapus item menggunakan DeleteItem.
- **Perilaku sebelum upgrade:** Dua catatan Streams dihasilkan. Catatan pertama berisi perubahan ke aws:rep:deleting bidang. Catatan kedua berisi atribut yang ditulis pelanggan dan atribut. aws:rep:\* / **Perilaku selama peningkatan:** Rekaman Stream tunggal dihasilkan, yang berisi atribut yang ditulis pelanggan. / **Perilaku setelah peningkatan:** Rekaman Stream tunggal dihasilkan, yang berisi atribut yang ditulis pelanggan.
- **Perilaku sebelum upgrade:** Dua r WCUs dikonsumsi untuk setiap penghapusan pelanggan. / **Perilaku selama peningkatan:** Satu RWCu dikonsumsi untuk setiap penghapusan pelanggan. / **Perilaku setelah peningkatan:** Satu RWCu dikonsumsi untuk setiap penghapusan pelanggan.
- **Perilaku sebelum upgrade:** ReplicationLatencydan PendingReplicationCount metrik dipublikasikan di CloudWatch. / **Perilaku selama peningkatan:** ReplicationLatencymetrik diterbitkan di CloudWatch. / **Perilaku setelah peningkatan:** ReplicationLatencymetrik diterbitkan di CloudWatch.
### Memutakhirkan ke versi 2019.11.21 (Saat ini)
Lakukan langkah-langkah berikut untuk memutakhirkan versi tabel global DynamoDB Anda menggunakan. Konsol Manajemen AWS
**Untuk meningkatkan tabel global ke versi 2019.11.21 (Saat ini)**
1. [Buka konsol DynamoDB di rumah. https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/home)
1. Di panel navigasi di sisi kiri konsol, pilih **Tabel, lalu pilih tabel** global yang ingin Anda tingkatkan ke versi 2019.11.21 (Saat Ini).
1. Pilih tab **Tabel Global**.
1. Pilih **Perbarui versi**.
1. Baca dan setujui persyaratan baru, lalu pilih **Perbarui versi**.
1. Setelah proses pemutakhiran selesai, versi tabel global yang muncul di konsol berubah menjadi **2019.11.21**.