PrepareQuery - Amazon Timestream
구문 요청요청 파라미터응답 구문응답 요소오류참고

Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. 여기에서 자세히 알아보세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

PrepareQuery

나중에 실행할 수 있도록 Timestream에서 저장할 파라미터가 포함된 쿼리를 제출할 수 있는 동기식 작업입니다. Timestream은 ValidateOnly가 true로 설정된 이 작업의 사용만 지원합니다.

구문 요청

{
   "QueryString": "string",
   "ValidateOnly": boolean
}

요청 파라미터

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 공통 파라미터를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

QueryString

준비된 문으로 사용할 Timestream 쿼리 문자열입니다. 쿼리 문자열 @ 문자와 식별자로 파라미터 이름을 지정할 수 있습니다.

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이는 262144자입니다.

필수 여부: 예

ValidateOnly

이 값을 true로 설정하면 Timestream은 쿼리 문자열이 유효한 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"
}

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

Columns

제출된 쿼리 문자열의 SELECT 절 열 목록입니다.

타입: SelectColumn객체 배열

Parameters

제출된 쿼리 문자열에 사용되는 파라미터 목록입니다.

타입: ParameterMapping객체 배열

QueryString

준비하려는 쿼리 문자열입니다.

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이는 262144자입니다.

오류

모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하세요.

AccessDeniedException

계정 설정에 액세스하는 데 필요한 권한이 없습니다.

HTTP 상태 코드: 400

InternalServerException

요청 처리 중 내부 서버 오류가 발생했습니다.

HTTP 상태 코드: 400

InvalidEndpointException

요청된 엔드포인트가 잘못되었습니다.

HTTP 상태 코드: 400

ThrottlingException

과도한 요청으로 인해 요청이 제한되었습니다.

HTTP 상태 코드: 400

ValidationException

유효하지 않거나 잘못된 형식의 요청입니다.

HTTP 상태 코드: 400

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.