쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

DeleteTable

포커스 모드
DeleteTable - Amazon DynamoDB
중요

이 단원에서 언급되는 API 버전 2011-12-05는 사용 중단되었으며 새 애플리케이션에 사용해서는 안 됩니다.

현재 하위 수준 API에 대한 설명서는 Amazon DynamoDB API 참조 섹션을 참조하세요.

설명

DeleteTable 작업은 테이블과 테이블에 속한 모든 항목을 삭제합니다. DeleteTable 요청 이후 DynamoDB가 삭제를 완료할 때까지 지정한 테이블은 DELETING 상태가 됩니다. 테이블을 삭제하려면 해당 테이블 상태가 ACTIVE이어야 합니다. 테이블이 CREATING 또는 UPDATING 상태인 경우에는 DynamoDB가 ResourceInUseException 오류를 반환합니다. 그리고 지정한 테이블이 존재하지 않는 경우에는 DynamoDB가 ResourceNotFoundException을 반환합니다. 테이블이 이미 DELETING 상태라면 어떠한 오류도 반환되지 않습니다.

참고

DynamoDB는 테이블 삭제가 완료될 때까지는 DELETING 상태인 테이블에서 GetItem, PutItem 등의 데이터 플레인 작업 요청을 계속 허용할 수 있습니다.

테이블은 요청을 실행하는 AWS 계정 및 요청을 수신하는 AWS 리전(예: dynamodb.us-west-1.amazonaws.com)과 관련된 테이블에서 고유해야 합니다. 각 DynamoDB 엔드포인트는 완전히 독립적입니다. 예를 들어, dynamodb.us-west-2.amazonaws.com 및 dynamodb.us-west-1.amazonaws.com에 "MyTable"이라는 테이블이 각각 있는 경우 해당 테이블은 완전히 독립적이며 데이터를 공유하지 않습니다. 즉, 한 테이블을 삭제해도 다른 테이블이 삭제되지 않습니다.

DescribeTables 작업을 사용하여 테이블 상태를 확인합니다.

요청

구문

// This header is abbreviated. // For a sample of a complete header, see DynamoDB 하위 수준 API. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.DeleteTable content-type: application/x-amz-json-1.0 {"TableName":"Table1"}
명칭 설명 필수
TableName

삭제할 테이블 이름

유형: 문자열

응답

구문

HTTP/1.1 200 OK x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 311 Date: Sun, 14 Aug 2011 22:56:22 GMT {"TableDescription": {"CreationDateTime":1.313362508446E9, "KeySchema": {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"}, "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}}, "ProvisionedThroughput":{"ReadCapacityUnits":10,"WriteCapacityUnits":10}, "TableName":"Table1", "TableStatus":"DELETING" } }
명칭 설명
TableDescription 테이블 속성에 대한 컨테이너
CreationDateTime

테이블 생성 날짜

형식: 숫자

KeySchema

테이블의 기본 키(단순 또는 복합) 구조. HashKeyElement에서는 이름-값 페어가 필수이지만 RangeKeyElement에서는 선택 사항입니다(복합 기본 키의 경우에만 필요함). 기본 키에 대한 자세한 내용은 프라이머리 키 단원을 참조하세요.

형식: HashKeyElement 맵, 또는 복합 기본 키의 HashKeyElementRangeKeyElement

ProvisionedThroughput 지정 테이블의 처리량으로서 ReadCapacityUnits 값과 WriteCapacityUnits 값으로 구성됩니다. DynamoDB 프로비저닝된 용량 모드 섹션을 참조하세요.
ProvisionedThroughput: ReadCapacityUnits

DynamoDB가 다른 작업과 로드 밸런스를 맞출 때까지 지정 테이블에서 사용되는 ReadCapacityUnits의 초당 최소 수입니다.

형식: 숫자

ProvisionedThroughput: WriteCapacityUnits

DynamoDB가 다른 작업과 로드 밸런스를 맞출 때까지 지정 테이블에서 사용되는 WriteCapacityUnits의 초당 최소 수입니다.

형식: 숫자

TableName

삭제된 테이블 이름

유형: 문자열

TableStatus 현재 테이블 상태(DELETING) 이후 삭제된 테이블에 대해 요청을 실행하면 resource not found가 반환됩니다.

DescribeTables 작업을 사용하여 테이블 상태를 확인합니다.

유형: 문자열

특수 오류

Error 설명
ResourceInUseException 테이블이 CREATING 또는 UPDATING 상태이면 삭제할 수 없습니다.

샘플 요청

// This header is abbreviated. For a sample of a complete header, see DynamoDB 하위 수준 API. POST / HTTP/1.1 x-amz-target: DynamoDB_20111205.DeleteTable content-type: application/x-amz-json-1.0 content-length: 40 {"TableName":"favorite-movies-table"}

샘플 응답

HTTP/1.1 200 OK x-amzn-RequestId: 4HONCKIVH1BFUDQ1U68CTG3N27VV4KQNSO5AEMVJF66Q9ASUAAJG content-type: application/x-amz-json-1.0 content-length: 160 Date: Sun, 14 Aug 2011 17:20:03 GMT {"TableDescription": {"CreationDateTime":1.313362508446E9, "KeySchema": {"HashKeyElement":{"AttributeName":"name","AttributeType":"S"}}, "TableName":"favorite-movies-table", "TableStatus":"DELETING" }

이 페이지에서

프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.