중요
이 단원에서 언급되는 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
|
테이블의 기본 키(단순 또는 복합) 구조. 형식: |
ProvisionedThroughput
|
지정 테이블의 처리량으로서 ReadCapacityUnits 값과 WriteCapacityUnits 값으로 구성됩니다. DynamoDB 프로비저닝된 용량 모드 섹션을 참조하세요. |
ProvisionedThroughput :
ReadCapacityUnits |
DynamoDB가 다른 작업과 로드 밸런스를 맞출 때까지 지정 테이블에서 사용되는 형식: 숫자 |
ProvisionedThroughput :
WriteCapacityUnits |
DynamoDB가 다른 작업과 로드 밸런스를 맞출 때까지 지정 테이블에서 사용되는 형식: 숫자 |
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"
}