DynamoDB 全局表版本

DynamoDB 全局表有两个版本可用：全局表版本 2019.11.21（当前版）和全局表版本 2017.11.29（旧版）。我们建议使用全局表版本 2019.11.21（当前版），因为相比 2017.11.29（旧版），它更易于使用、在更多区域中受支持，并且对于大部分工作负载而言更具有成本效益。

确定全局表的版本

使用 AWS CLI 确定版本

确定版本 2019.11.21（当前版）全局表副本

要确定表是否为全局表版本 2019.11.21（当前版）副本，请对该表调用 describe-table 命令。如果输出包含值为“2019.11.21”的 GlobalTableVersion 属性，则该表为版本 2019.11.21（当前版）全局表副本。

describe-table 的示例 CLI 命令：

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

（删节）输出包含值为“2019.11.21”的 GlobalTableVersion 属性，因此该表为版本 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 \
--global-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 全局表版本。