UpdateTable - Amazon DynamoDB
설명요청응답특수 오류예제관련 작업

UpdateTable

중요

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

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

설명

주어진 테이블의 할당 처리량을 업데이트합니다. 테이블 처리량을 설정하면 성능을 관리하는 데 효과적이기 때문에 DynamoDB에서 프로비저닝 처리량 기능으로 지원되고 있습니다. 자세한 내용은 DynamoDB 프로비저닝된 용량 모드 단원을 참조하십시오.

프로비저닝 처리량 값은 Amazon DynamoDB의 서비스, 계정 및 테이블 할당량의 상한값과 하한값에 따라 높이거나 낮출 수 있습니다.

업데이트 작업이 성공하려면 테이블이 ACTIVE 상태이어야 합니다. UpdateTable은 비동기식 작업입니다. 즉, 작업 중에는 테이블이 UPDATING 상태가 됩니다. 테이블이 UPDATING 상태이더라도 할당 처리량은 호출 전과 같습니다. 새로운 할당 처리량 설정은 UpdateTable 작업이 끝나고 테이블이 ACTIVE 상태로 돌아온 후부터 적용됩니다.

요청

구문

// This header is abbreviated. 
// For a sample of a complete header, see DynamoDB 하위 수준 API.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.UpdateTable
content-type: application/x-amz-json-1.0

{"TableName":"Table1",
    "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15}
}
명칭 설명 필수
TableName

업데이트할 테이블 이름

타입: 문자열

예
ProvisionedThroughput

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

형식: 배열

예
ProvisionedThroughput :ReadCapacityUnits

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

Eventually consistent read 작업은 consistent read 작업에 비해 필요한 부하가 적습니다. 따라서 초당 consistent ReadCapacityUnits를 50으로 설정하면 초당 eventually consistent ReadCapacityUnits는 100이 됩니다.

형식: 숫자

예
ProvisionedThroughput :WriteCapacityUnits

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

형식: 숫자

예

응답

구문

HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
Content-Type: application/json
Content-Length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT

{"TableDescription":
    {"CreationDateTime":1.321657838135E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"AttributeValue1","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"AttributeValue2","AttributeType":"N"}},
    "ProvisionedThroughput":
        {"LastDecreaseDateTime":1.321661704489E9,
        "LastIncreaseDateTime":1.321663607695E9,
        "ReadCapacityUnits":5,
        "WriteCapacityUnits":10},
    "TableName":"Table1",
    "TableStatus":"UPDATING"}}
명칭 설명
CreationDateTime

테이블 생성 날짜

형식: 숫자
KeySchema

테이블의 기본 키(단순 또는 복합) 구조. HashKeyElement에서는 이름-값 페어가 필수이지만 RangeKeyElement에서는 선택 사항입니다(복합 기본 키의 경우에만 필요함). 최대 해시 키 크기는 2,048byte입니다. 최대 범위 키 크기는 1,024byte입니다. 두 키의 크기 제한은 별도로 적용됩니다(해시 + 범위 키 2,048 + 1,024 합산). 기본 키에 대한 자세한 내용은 프라이머리 키 단원을 참조하세요.

형식: HashKeyElement 맵, 또는 복합 기본 키의 HashKeyElement 및 RangeKeyElement
ProvisionedThroughput

LastIncreaseDateTime 값(해당되는 경우)과 LastDecreaseDateTime 값(해당되는 경우)을 포함하여 지정 테이블의 현재 처리량 설정,

형식: 배열

TableName

업데이트된 테이블 이름

타입: 문자열
TableStatus 현재 테이블 상태(CREATING, ACTIVE, DELETING 또는 UPDATING). UPDATING이 되어야 합니다.

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

타입: 문자열

특수 오류

Error 설명
ResourceNotFoundException 지정된 테이블을 찾을 수 없습니다.
ResourceInUseException 테이블이 ACTIVE 상태가 아닙니다.

예제

샘플 요청

// This header is abbreviated. 
// For a sample of a complete header, see DynamoDB 하위 수준 API.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.UpdateTable
content-type: application/x-amz-json-1.0

{"TableName":"comp1",
    "ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15}
}

샘플 응답

HTTP/1.1 200 OK
content-type: application/x-amz-json-1.0
content-length: 390
Date: Sat, 19 Nov 2011 00:46:47 GMT

{"TableDescription":
    {"CreationDateTime":1.321657838135E9,
    "KeySchema":
        {"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
        "RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
    "ProvisionedThroughput":
        {"LastDecreaseDateTime":1.321661704489E9,
        "LastIncreaseDateTime":1.321663607695E9,
        "ReadCapacityUnits":5,
        "WriteCapacityUnits":10},
    "TableName":"comp1",
    "TableStatus":"UPDATING"}
}