백업에서 DynamoDB 테이블 복원 - Amazon DynamoDB
백업에서 테이블 복원(콘솔)백업에서 테이블 복원(AWS CLI)

백업에서 DynamoDB 테이블 복원

이 단원에서는 Amazon DynamoDB 콘솔 또는 AWS Command Line Interface(AWS CLI)를 사용하여 백업에서 테이블을 복원하는 방법을 설명합니다.

참고

AWS CLI를 사용하려면 먼저 구성을 해야 합니다. 자세한 내용은 DynamoDB 액세스 섹션을 참조하세요.

백업에서 테이블 복원(콘솔)

다음 절차는 Music 자습서에서 만든 MusicBackup 파일을 사용하여 DynamoDB 테이블 백업 테이블을 복원하는 방법을 보여 줍니다.

참고

이 절차는 MusicBackup 파일을 사용하여 이를 복원하기 전에 Music 테이블이 더 이상 존재하지 않음을 가정합니다.

백업에서 테이블을 복원하려면

  1. AWS Management Console에 로그인하고 https://console.aws.amazon.com/dynamodb/에서 DynamoDB 콘솔을 엽니다.

  2. 콘솔 왼쪽의 탐색 창에서 [Backups]를 선택합니다.

  3. 백업 목록에서 MusicBackup을 선택합니다.

    백업 목록과 백업 만들기 버튼의 스크린샷

  4. 복원을 선택합니다.

  5. Music​을 새 테이블 이름으로 입력합니다. 백업 이름과 기타 백업 세부 정보를 확인합니다. [Restore table]을 선택하여 복원 프로세스를 시작합니다.

    참고

    테이블을 동일한 AWS 리전 또는 백업이 속하는 리전과 다른 리전에 복원할 수 있습니다. 새로 복원된 테이블에 보조 인덱스가 생성되지 않도록 제외할 수도 있습니다. 또한 다른 암호화 모드를 지정할 수 있습니다.

    백업에서 복원된 테이블은 항상 DynamoDB Standard 테이블 클래스를 사용하여 생성됩니다.

    백업에서 테이블 복원 화면(백업 테이블 세부 정보 표시)의 스크린샷

    복원하는 테이블은 상태가 [Creating]으로 표시됩니다. 복원 프로세스가 완료되면 Music 테이블의 상태가 Active로 변경됩니다.

백업에서 테이블 복원(AWS CLI)

다음 단계에 따라 AWS CLI를 사용하여 DynamoDB 테이블 백업 자습서에서 만든 MusicBackup을 이용해 Music 테이블을 복원합니다.

백업에서 테이블을 복원하려면

  1. list-backups 명령을 사용하여 복원하려는 백업을 확인합니다. 이 예제에서는 MusicBackup를 사용합니다.

    aws dynamodb list-backups

    백업에 대한 자세한 정보를 보려면 describe-backup 명령을 사용합니다. 이전 단계의 backup-arn에서 입력을 볼 수 있습니다.

    aws dynamodb describe-backup \
--backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01489173575360-b308cd7d

  2. 백업에서 테이블을 복원합니다. 이 경우 MusicBackup은 Music 테이블을 동일한 AWS 리전으로 복원합니다.

    aws dynamodb restore-table-from-backup \
--target-table-name Music \
--backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01489173575360-b308cd7d

  3. 사용자 지정 테이블 설정을 통해 백업에서 테이블을 복원합니다. 이 경우 MusicBackup은 Music 테이블을 복원하고 복원된 테이블의 암호화 모드를 지정합니다.

    참고

    sse-specification-override 파라미터는 CreateTable 명령에 사용된 sse-specification-override 파라미터와 동일한 값을 사용합니다. 자세한 내용은 DynamoDB의 암호화된 테이블 관리을 참조하십시오.

    aws dynamodb restore-table-from-backup \
--target-table-name Music \
--backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01581080476474-e177ebe2 \
--sse-specification-override Enabled=true,SSEType=KMS,KMSMasterKeyId=abcd1234-abcd-1234-a123-ab1234a1b234

    테이블을 백업이 속하는 다른 AWS 리전으로 복원할 수 있습니다.

    참고

    • 이 sse-specification-override 파라미터는 교차 리전 복원에는 필수지만 원본 테이블과 동일한 리전으로 복원하는 경우에는 선택 사항입니다.

    • 명령줄에서 교차 리전 복원을 수행할 때는 기본 AWS 리전을 원하는 대상 리전으로 설정해야 합니다. 자세한 내용은 AWS Command Line Interface 사용 설명서의 명령줄 옵션을 참조하세요.

    aws dynamodb restore-table-from-backup \
--target-table-name Music \
--backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01581080476474-e177ebe2 \
--sse-specification-override Enabled=true,SSEType=KMS

    복원된 테이블에 대한 결제 모드와 프로비저닝된 처리량을 재정의할 수 있습니다.

    aws dynamodb restore-table-from-backup \
--target-table-name Music \
--backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01489173575360-b308cd7d \
--billing-mode-override PAY_PER_REQUEST

    복원된 테이블에 일부 또는 전체 보조 인덱스가 생성되지 않도록 제외할 수 있습니다.

    참고

    복원된 테이블에 일부 또는 전체 보조 인덱스가 생성되지 않도록 제외하는 경우 복원이 보다 빠르고 비용 효율적일 수 있습니다.

    aws dynamodb restore-table-from-backup \
--target-table-name Music \
--backup-arn arn:aws:dynamodb:us-east-1:123456789012:table/Music/backup/01581081403719-db9c1f91 \
--global-secondary-index-override '[]' \
--sse-specification-override Enabled=true,SSEType=KMS
    참고

    제공된 보조 인덱스는 기존 인덱스와 일치해야 합니다. 복원 시 새 인덱스를 생성할 수 없습니다.

    다른 재정의 조합을 사용할 수 있습니다. 예를 들어, 다음과 같이 단일 글로벌 보조 인덱스를 사용하는 동시에 프로비저닝된 처리량을 변경할 수 있습니다.

    aws dynamodb restore-table-from-backup \
--target-table-name Music \
--backup-arn arn:aws:dynamodb:eu-west-1:123456789012:table/Music/backup/01581082594992-303b6239 \
--billing-mode-override PROVISIONED \
--provisioned-throughput-override ReadCapacityUnits=100,WriteCapacityUnits=100 \
--global-secondary-index-override IndexName=singers-index,KeySchema=["{AttributeName=SingerName,KeyType=HASH}"],Projection="{ProjectionType=KEYS_ONLY}",ProvisionedThroughput="{ReadCapacityUnits=5,WriteCapacityUnits=5}" \
--sse-specification-override Enabled=true,SSEType=KMS

복원을 확인하려면 describe-table 명령을 사용하여 Music 테이블을 명시합니다.

aws dynamodb describe-table --table-name Music

백업에서 복원하는 테이블은 상태가 [Creating]으로 표시됩니다. 복원 프로세스가 완료되면 Music 테이블의 상태가 Active로 변경됩니다.

중요

복원 진행 중에는 IAM 역할 정책을 수정하거나 삭제하지 마세요. 그럴 경우 예기치 않은 동작이 발생할 수 있습니다. 예를 들어 테이블 복원 중에 쓰기 권한을 삭제할 경우, 기본 RestoreTableFromBackup 작업에서, 복원된 데이터를 테이블에 쓸 수 없게 됩니다.

복원 작업이 완료된 후에는 IAM 역할 정책을 수정하거나 삭제해도 됩니다.

대상 복원 테이블에 액세스하기 위한 소스 IP 제한 관련 IAM 정책에서는 aws:ViaAWSService 키를 false로 설정하여 해당 제한이 보안 주체가 직접 수행한 요청에만 적용되도록 해야 합니다. 그러지 않으면 복원이 취소됩니다.

AWS 관리형 키 또는 고객 관리형 키로 백업이 암호화된 경우, 복원이 진행되는 동안 키를 비활성화하거나 삭제하지 마세요. 그렇지 않으면 복원에 실패합니다.

복원 작업이 완료된 후에는 복원된 테이블에 암호화된 키를 변경하거나 이전 키를 비활성화 또는 삭제할 수 있습니다.