기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
SendCommand
Amazon QLDB 원장에 명령을 보냅니다.
참고
이 API와 직접 상호 작용하는 대신 QLDB 드라이버 또는 QLDB 쉘을 사용하여 원장에서 데이터 트랜잭션을 실행하는 것이 좋습니다.
-
AWS SDK로 작업하는 경우 QLDB 드라이버를 사용하십시오. 드라이버는 이 QLDB 세션 데이터 API 위에 높은 수준의 추상화 계층을 제공하고 사용자를 대신하여
SendCommand
작업을 관리합니다. 지원되는 프로그래밍 언어에 대한 자세한 내용과 목록은 Amazon QLDB 개발자 가이드의 드라이버 시작하기를 참조하세요. -
AWS Command Line Interface (AWS CLI) 로 작업하는 경우 QLDB 셸을 사용하십시오. 쉘은 QLDB 드라이버를 사용하여 원장과 상호 작용하는 명령줄 인터페이스입니다. 자세한 설명은 Accessing Amazon QLDB using the QLDB shell 섹션을 참조하세요.
구문 요청
{
"AbortTransaction": {
},
"CommitTransaction": {
"CommitDigest": blob
,
"TransactionId": "string
"
},
"EndSession": {
},
"ExecuteStatement": {
"Parameters": [
{
"IonBinary": blob
,
"IonText": "string
"
}
],
"Statement": "string
",
"TransactionId": "string
"
},
"FetchPage": {
"NextPageToken": "string
",
"TransactionId": "string
"
},
"SessionToken": "string
",
"StartSession": {
"LedgerName": "string
"
},
"StartTransaction": {
}
}
요청 파라미터
모든 작업에서 사용하는 파라미터에 대한 자세한 내용은 범용 파라미터를 참조하세요.
요청은 JSON 형식으로 다음 데이터를 받습니다.
- AbortTransaction
-
현재 트랜잭션을 중지하는 명령입니다.
타입: AbortTransactionRequest 객체
필수 여부: 아니요
- CommitTransaction
-
지정된 트랜잭션을 체결하는 명령입니다.
타입: CommitTransactionRequest 객체
필수 여부: 아니요
- EndSession
-
현재 세션을 종료하는 명령입니다.
타입: EndSessionRequest 객체
필수 여부: 아니요
- ExecuteStatement
-
지정된 트랜잭션에서 문을 실행하는 명령입니다.
타입: ExecuteStatementRequest 객체
필수 여부: 아니요
- FetchPage
-
페이지를 가져오는 명령입니다.
타입: FetchPageRequest 객체
필수 여부: 아니요
- SessionToken
-
현재 명령의 세션 토큰을 지정합니다. 세션 토큰은 세션 수명 내내 일정합니다.
세션 토큰을 가져오려면
StartSession
명령을 실행합니다. 이SessionToken
는 현재 세션 중에 실행되는 모든 후속 명령에 필요합니다.타입: 문자열
길이 제약: 최소 길이는 4입니다. 최대 길이는 1024입니다.
패턴:
^[A-Za-z-0-9+/=]+$
필수 여부: 아니요
- StartSession
-
새 세션을 시작하는 명령입니다. 응답의 일부로 세션 토큰을 얻습니다.
타입: StartSessionRequest 객체
필수 여부: 아니요
- StartTransaction
-
새 트랜잭션을 시작하는 명령입니다.
타입: StartTransactionRequest 객체
필수 항목 여부: 아니요
응답 구문
{
"AbortTransaction": {
"TimingInformation": {
"ProcessingTimeMilliseconds": number
}
},
"CommitTransaction": {
"CommitDigest": blob,
"ConsumedIOs": {
"ReadIOs": number,
"WriteIOs": number
},
"TimingInformation": {
"ProcessingTimeMilliseconds": number
},
"TransactionId": "string"
},
"EndSession": {
"TimingInformation": {
"ProcessingTimeMilliseconds": number
}
},
"ExecuteStatement": {
"ConsumedIOs": {
"ReadIOs": number,
"WriteIOs": number
},
"FirstPage": {
"NextPageToken": "string",
"Values": [
{
"IonBinary": blob,
"IonText": "string"
}
]
},
"TimingInformation": {
"ProcessingTimeMilliseconds": number
}
},
"FetchPage": {
"ConsumedIOs": {
"ReadIOs": number,
"WriteIOs": number
},
"Page": {
"NextPageToken": "string",
"Values": [
{
"IonBinary": blob,
"IonText": "string"
}
]
},
"TimingInformation": {
"ProcessingTimeMilliseconds": number
}
},
"StartSession": {
"SessionToken": "string",
"TimingInformation": {
"ProcessingTimeMilliseconds": number
}
},
"StartTransaction": {
"TimingInformation": {
"ProcessingTimeMilliseconds": number
},
"TransactionId": "string"
}
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- AbortTransaction
-
중단된 트랜잭션의 세부 정보를 포함합니다.
타입: AbortTransactionResult 객체
- CommitTransaction
-
커밋된 트랜잭션의 세부 정보를 포함합니다.
타입: CommitTransactionResult 객체
- EndSession
-
종료된 세션의 세부 정보를 포함합니다.
타입: EndSessionResult 객체
- ExecuteStatement
-
실행된 명령문의 세부 정보를 포함합니다.
타입: ExecuteStatementResult 객체
- FetchPage
-
가져온 페이지의 세부 정보를 포함합니다.
타입: FetchPageResult 객체
- StartSession
-
세션 토큰이 포함된 시작된 세션의 세부 정보를 포함합니다. 이
SessionToken
는 현재 세션 중에 실행되는 모든 후속 명령에 필요합니다.타입: StartSessionResult 객체
- StartTransaction
-
시작된 트랜잭션의 세부 정보를 포함합니다.
타입: StartTransactionResult 객체
Errors
모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하십시오.
- BadRequestException
-
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
HTTP 상태 코드: 400
- CapacityExceededException
-
요청이 원장의 처리 용량을 초과할 때 반환됩니다.
HTTP 상태 코드: 400
- InvalidSessionException
-
제한 시간이 초과되었거나 만료되어 세션이 더 이상 존재하지 않는 경우 반환됩니다.
HTTP 상태 코드: 400
- LimitExceededException
-
활성 세션 수와 같은 리소스 제한을 초과할 경우 반환됩니다.
HTTP 상태 코드: 400
- OccConflictException
-
OCC(낙관적 동시성 제어)의 검증 단계에서 실패로 인해 트랜잭션을 저널에 기록할 수 없을 때 반환됩니다.
HTTP 상태 코드: 400
- RateExceededException
-
요청율이 허용된 처리량을 초과할 때 반환됩니다.
HTTP 상태 코드: 400
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.