Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. 여기에서 자세히 알아보세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
ExecuteScheduledQuery
이 API를 사용하여 예약된 쿼리를 수동으로 실행할 수 있습니다.
QueryInsights를 활성화한 경우 이 API는 Amazon SNS 알림의 일부로 실행한 쿼리와 관련된 인사이트 및 지표도 반환합니다. QueryInsights는 쿼리의 성능 튜닝을 지원합니다. QueryInsights에 대한 자세한 내용은 쿼리 인사이트를 사용하여 Amazon Timestream에서 쿼리 최적화를 참조하세요.
구문 요청
{
"ClientToken": "string",
"InvocationTime": number,
"QueryInsights": {
"Mode": "string"
},
"ScheduledQueryArn": "string"
}요청 파라미터
모든 작업에 공통되는 파라미터에 대한 자세한 설명은 공통 파라미터를 참조하세요.
요청은 JSON 형식으로 다음 데이터를 받습니다.
- ClientToken
-
사용하지 않음
유형: 문자열
길이 제약: 최소 길이는 32입니다. 최대 길이 128.
필수 여부: 아니요
- InvocationTime
-
UTC의 타임스탬프입니다. 쿼리는 이 타임스탬프에서 간접적으로 호출된 것처럼 실행됩니다.
유형: 타임스탬프
필수 항목 여부: 예
- QueryInsights
-
QueryInsights를 활성화하기 위한 설정을 캡슐화합니다.QueryInsights를 활성화하면 실행한 쿼리에 대한 Amazon SNS 알림의 일부로 인사이트와 지표가 반환됩니다.QueryInsights를 사용하여 쿼리 성능 및 비용을 조정할 수 있습니다.유형: ScheduledQueryInsights객체
필수 여부: 아니요
- ScheduledQueryArn
-
예약된 쿼리의 ARN입니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이는 2,048.
필수 항목 여부: 예
응답 요소
작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.
오류
모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하세요.
- AccessDeniedException
-
계정 설정에 액세스하는 데 필요한 권한이 없습니다.
HTTP 상태 코드: 400
- InternalServerException
-
요청 처리 중 내부 서버 오류가 발생했습니다.
HTTP 상태 코드: 400
- InvalidEndpointException
-
요청된 엔드포인트가 잘못되었습니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
요청한 리소스를 찾을 수 없습니다.
- ScheduledQueryArn
-
예약된 쿼리의 ARN입니다.
HTTP 상태 코드: 400
- ThrottlingException
-
과도한 요청으로 인해 요청이 제한되었습니다.
HTTP 상태 코드: 400
- ValidationException
-
유효하지 않거나 잘못된 형식의 요청입니다.
HTTP 상태 코드: 400
예
ENABLED_WITH_RATE_CONTROL 모드에 대한 예약된 쿼리 알림 메시지
다음 예제에서는 QueryInsights 파라미터의 ENABLED_WITH_RATE_CONTROL 모드에 대한 성공적인 예약 쿼리 알림 메시지를 보여줍니다.
"SuccessNotificationMessage": { "type": "MANUAL_TRIGGER_SUCCESS", "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-49c6ed55-c2e7-4cc2-9956-4a0ecea13420-80e05b035236a4c3", "scheduledQueryRunSummary": { "invocationEpochSecond": 1723710546, "triggerTimeMillis": 1723710547490, "runStatus": "MANUAL_TRIGGER_SUCCESS", "executionStats": { "executionTimeInMillis": 17343, "dataWrites": 1024, "bytesMetered": 0, "cumulativeBytesScanned": 600, "recordsIngested": 1, "queryResultRows": 1 }, "queryInsightsResponse": { "querySpatialCoverage": { "max": { "value": 1.0, "tableArn": "arn:aws:timestream:<Region>:<Account>:database/BaseDb/table/BaseTable", "partitionKey": [ "measure_name" ] } }, "queryTemporalRange": { "max": { "value": 2399999999999, "tableArn": "arn:aws:timestream:<Region>:<Account>:database/BaseDb/table/BaseTable" } }, "queryTableCount": 1, "outputRows": 1, "outputBytes": 59 } } }
DISABLED 모드에 대한 예약된 쿼리 알림 메시지
다음 예제에서는 QueryInsights 파라미터의 DISABLED 모드에 대한 성공적인 예약 쿼리 알림 메시지를 보여줍니다.
"SuccessNotificationMessage": { "type": "MANUAL_TRIGGER_SUCCESS", "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-fa109d9e-6528-4a0d-ac40-482fa05e657f-140faaeecdc5b2a7", "scheduledQueryRunSummary": { "invocationEpochSecond": 1723711401, "triggerTimeMillis": 1723711402144, "runStatus": "MANUAL_TRIGGER_SUCCESS", "executionStats": { "executionTimeInMillis": 17992, "dataWrites": 1024, "bytesMetered": 0, "cumulativeBytesScanned": 600, "recordsIngested": 1, "queryResultRows": 1 } } }
ENABLED_WITH_RATE_CONTROL 모드에 대한 실패 알림 메시지
다음 예제에서는 QueryInsights 파라미터의 ENABLED_WITH_RATE_CONTROL 모드에 대해 실패한 예약된 쿼리 알림 메시지를 보여줍니다.
"FailureNotificationMessage": { "type": "MANUAL_TRIGGER_FAILURE", "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d", "scheduledQueryRunSummary": { "invocationEpochSecond": 1727915513, "triggerTimeMillis": 1727915513894, "runStatus": "MANUAL_TRIGGER_FAILURE", "executionStats": { "executionTimeInMillis": 10777, "dataWrites": 0, "bytesMetered": 0, "cumulativeBytesScanned": 0, "recordsIngested": 0, "queryResultRows": 4 }, "errorReportLocation": { "s3ReportLocation": { "bucketName": "amzn-s3-demo-bucket", "objectKey": "4my-organization-f7a3c5d065a1a95e/1727915513/MANUAL/1727915513894/5e14b3df-b147-49f4-9331-784f749b68ae" } }, "failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details" } }
비활성화 모드에 대한 실패 알림 메시지
다음 예제에서는 QueryInsights 파라미터의 DISABLED 모드에 대해 실패한 예약된 쿼리 알림 메시지를 보여줍니다.
"FailureNotificationMessage": { "type": "MANUAL_TRIGGER_FAILURE", "arn": "arn:aws:timestream:<Region>:<Account>:scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d", "scheduledQueryRunSummary": { "invocationEpochSecond": 1727915194, "triggerTimeMillis": 1727915195119, "runStatus": "MANUAL_TRIGGER_FAILURE", "executionStats": { "executionTimeInMillis": 10777, "dataWrites": 0, "bytesMetered": 0, "cumulativeBytesScanned": 0, "recordsIngested": 0, "queryResultRows": 4 }, "errorReportLocation": { "s3ReportLocation": { "bucketName": "amzn-s3-demo-bucket", "objectKey": "4my-organization-b7e27a1d79be226d/1727915194/MANUAL/1727915195119/08dea9f5-9a0a-4e63-a5f7-ded23247bb98" } }, "failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details" } }
참고
언어별 AWS SDKs
