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

Versi tabel global DynamoDB

Ada dua versi tabel global DynamoDB yang tersedia: Tabel Global versi 2019.11.21 (Saat ini) dan tabel global versi 2017.11.29 (Legacy). Sebaiknya gunakan 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 replika tabel global versi 2019.11.21 (Saat ini)

Untuk menentukan apakah tabel adalah replika tabel global versi 2019.11.21 (Current), panggil describe-table perintah untuk tabel. Jika output berisi GlobalTableVersion atribut dengan nilai “2019.11.21", tabel adalah replika tabel global versi 2019.11.21 (Current).

Contoh perintah CLI untuk: describe-table

aws dynamodb describe-table \
--table-name users \
--region us-east-2

Output (diringkas) 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)

Tabel global versi 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 describe-global-table perintah untuk tabel. Jika Anda menerima respons yang berhasil, tabel tersebut adalah replika tabel global versi 2017.11.29 (Legacy). Jika describe-global-table perintah mengembalikan GlobalTableNotFoundException kesalahan, tabel tersebut bukan replika versi 2017.11.29 (Legacy).

Contoh perintah CLI untuk: describe-global-table

aws dynamodb describe-global-table \
--global-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 Konsol DynamoDB

Untuk mengidentifikasi versi replika tabel global, lakukan hal berikut:

Perbedaan perilaku antara versi Legacy dan Current

Daftar berikut menjelaskan perbedaan perilaku antara versi Legacy dan Current dari tabel global.

Upgrade ke versi saat ini

Izin yang diperlukan untuk peningkatan tabel global

Untuk memutakhirkan 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 melihat tabel.

Kebijakan IAM berikut memberikan izin untuk memutakhirkan tabel global 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 peningkatan

Perilaku DynamoDB Streams sebelum, selama, dan setelah peningkatan

Memutakhirkan ke versi 2019.11.21 (Saat ini)

Lakukan langkah-langkah berikut untuk memutakhirkan versi tabel global DynamoDB menggunakan. Konsol Manajemen AWS