DynamoDB 全域資料表版本

DynamoDB 全域資料表有兩種版本可用：全域資料表 2019.11.21 版 (目前版本) 和全域資料表 2017.11.29 版 (舊版)。建議您使用全域資料表 2019.11.21 版 (目前版本)，因為其比 2017.11.29 版 (舊版) 更易於使用、支援更多區域，且大多數的工作負載成本更低。

判斷全域資料表版本

使用 AWS CLI 判斷版本

識別全域資料表 2019.11.21 版 (目前版本) 複本

若要判斷資料表是否為全域資料表 2019.11.21 版 (目前版本) 複本，請針對資料表調用 describe-table 命令。如果輸出的 GlobalTableVersion 屬性含 "2019.11.21" 值，則資料表為 2019.11.21 版 (目前版本) 全域資料表複本。

describe-table 範例 CLI 命令：

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

(簡略版) 輸出的 GlobalTableVersion 屬性包含 "2019.11.21" 值，因此這個資料表是 2019.11.21 版 (目前版本) 全域資料表複本。

{
    "Table": {
        "AttributeDefinitions": [
            {
                "AttributeName": "id",
                "AttributeType": "S"
            },
            {
                "AttributeName": "name",
                "AttributeType": "S"
            }
        ],
        "TableName": "users",
        ...
        "GlobalTableVersion": "2019.11.21",
        "Replicas": [
            {
                "RegionName": "us-west-2",
                "ReplicaStatus": "ACTIVE",
            }
        ],
        ...
    }
}

識別全域資料表 2017.11.29 版 (舊版) 複本

全域資料表 2017.11.29 版 (舊版) 使用一組專用命令進行全域資料表管理。若要判斷資料表是否為全域資料表 2017.11.29 版 (舊版) 複本，請針對資料表調用 describe-global-table 命令。如果您收到成功回應，則資料表是 2017.11.29 版 (舊版) 全域資料表複本。如果 describe-global-table 命令傳回 GlobalTableNotFoundException 錯誤，則資料表不是 2017.11.29 版 (舊版) 複本。

describe-global-table 範例 CLI 命令：

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

命令傳回成功回應，因此這個資料表是 2017.11.29 版 (舊版) 全域資料表複本。

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

使用 DynamoDB 主控台判斷版本

若要識別全域資料表複本的版本，請執行下列動作：

舊版和目前版本之間的行為差異

下列清單說明全域資料表舊版和目前版本之間的行為差異。

升級到目前版本

全域資料表升級所需的許可

若要升級至 2019.11.21 版 (目前版本)，您必須擁有所有複本區域的 dynamodb:UpdateGlobalTableversion 許可。除了存取 DynamoDB 主控台和檢視資料表的必要許可，您還需要這些許可。

下列 IAM 政策會授予許可，將任何全域資料表更新至 2019.11.21 版 (目前版本)。

{
    "version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "dynamodb:UpdateGlobalTableversion",
            "Resource": "*"
        }
    ]
}

下列 IAM 政策會授予許可，只將 Music 全域資料表 (在兩個區域中具有複本) 升級為 2019.11.21 版 (目前版本)。

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

升級期間預期會發生的情況

升級前、中、後的 DynamoDB Streams 行為

升級到 2019.11.21 版(目前版本)

請執行下列步驟，使用 AWS 管理主控台 升級 DynamoDB 全域資料表版本。