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 \
--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 Management Console을 사용하여 DynamoDB 글로벌 테이블의 버전을 업그레이드하려면 다음 단계를 수행하세요.