기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
PrepareQuery
나중에 실행할 수 있도록 Timestream에 저장할 파라미터가 있는 쿼리를 제출할 수 있는 동기식 작업입니다. Timestream은 로 ValidateOnly 설정된 이 작업만 사용할 수 있습니다true.
구문 요청
{
"QueryString": "string",
"ValidateOnly": boolean
}요청 파라미터
모든 작업에 공통되는 파라미터에 대한 내용은 공통 파라미터를 참조하십시오.
요청은 JSON 형식의 다음 데이터를 수락합니다.
- QueryString
-
준비된 문으로 사용할 Timestream 쿼리 문자열입니다. 쿼리 문자열
@문자와 식별자로 파라미터 이름을 지정할 수 있습니다.유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 262144자입니다.
필수 여부: 예
- ValidateOnly
-
이 값을 로 설정하면
trueTimestream은 쿼리 문자열이 유효한 Timestream 쿼리인지만 검증하고 나중에 사용할 수 있도록 준비된 쿼리를 저장하지 않습니다.타입: 부울
필수 항목 여부: 아니요
응답 구문
{
"Columns": [
{
"Aliased": boolean,
"DatabaseName": "string",
"Name": "string",
"TableName": "string",
"Type": {
"ArrayColumnInfo": {
"Name": "string",
"Type": "Type"
},
"RowColumnInfo": [
{
"Name": "string",
"Type": "Type"
}
],
"ScalarType": "string",
"TimeSeriesMeasureValueColumnInfo": {
"Name": "string",
"Type": "Type"
}
}
}
],
"Parameters": [
{
"Name": "string",
"Type": {
"ArrayColumnInfo": {
"Name": "string",
"Type": "Type"
},
"RowColumnInfo": [
{
"Name": "string",
"Type": "Type"
}
],
"ScalarType": "string",
"TimeSeriesMeasureValueColumnInfo": {
"Name": "string",
"Type": "Type"
}
}
}
],
"QueryString": "string"
}Response Elements
작업이 성공하면 서비스가 HTTP 200개의 응답을 다시 보냅니다.
다음 데이터는 서비스에서 JSON 형식으로 반환됩니다.
- Columns
-
제출된 쿼리 문자열의 SELECT 절 열 목록입니다.
유형: SelectColumn객체 어레이
- Parameters
-
제출된 쿼리 문자열에 사용되는 파라미터 목록입니다.
유형: ParameterMapping객체 어레이
- QueryString
-
준비하려는 쿼리 문자열입니다.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 262144자입니다.
Errors
모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하십시오.
- AccessDeniedException
-
이 작업을 수행할 권한이 없습니다.
HTTP 상태 코드: 400
- InternalServerException
-
내부 서버 오류로 인해 서비스가 이 요청을 완전히 처리할 수 없습니다.
HTTP 상태 코드: 400
- InvalidEndpointException
-
요청된 엔드포인트가 유효하지 않습니다.
HTTP 상태 코드: 400
- ThrottlingException
-
요청 제한 때문에 요청이 거부되었습니다.
HTTP 상태 코드: 400
- ValidationException
-
유효하지 않거나 잘못된 형식의 요청입니다.
HTTP 상태 코드: 400
참고
언어별 중 하나API에서 이를 사용하는 방법에 대한 자세한 내용은 다음을 AWS SDKs참조하세요.
