기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
ExecuteScheduledQuery
이 API를 사용하여 예약된 쿼리를 수동으로 실행할 수 있습니다.
를 활성화한 경우 QueryInsights이 API는 Amazon SNS 알림의 일부로 실행한 쿼리와 관련된 인사이트 및 지표도 반환합니다.는 쿼리의 성능 조정을 QueryInsights 지원합니다. 에 대한 자세한 내용은 Amazon Timestream에서 쿼리 인사이트를 사용하여 쿼리 최적화를 QueryInsights참조하세요.
구문 요청
{
"ClientToken": "string",
"InvocationTime": number,
"QueryInsights": {
"Mode": "string"
},
"ScheduledQueryArn": "string"
}요청 파라미터
모든 작업에 공통되는 파라미터에 대한 내용은 공통 파라미터를 참조하십시오.
요청은 JSON 형식의 다음 데이터를 수락합니다.
- ClientToken
-
사용하지 않음
유형: 문자열
길이 제약 조건: 최소 길이는 32입니다. 최대 길이 128.
필수 여부: 아니요
- InvocationTime
-
UTC의 타임스탬프입니다. 쿼리는이 타임스탬프에서 호출된 것처럼 실행됩니다.
유형: 타임스탬프
필수 여부: 예
- QueryInsights
-
활성화에 대한 설정을 캡슐화합니다
QueryInsights.활성화하면 실행한 쿼리에 대한 Amazon SNS 알림의 일부로 인사이트와 지표가
QueryInsights반환됩니다.QueryInsights를 사용하여 쿼리 성능 및 비용을 조정할 수 있습니다.유형: ScheduledQueryInsights 객체
필수 여부: 아니요
- ScheduledQueryArn
-
예약된 쿼리의 ARN입니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이는 2,048.
필수 여부: 예
응답 요소
작업이 성공하면 서비스는 빈 HTTP 본문과 함께 HTTP 200 응답을 다시 보냅니다.
오류
모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하세요.
- AccessDeniedException
-
이 작업을 수행할 권한이 없습니다.
HTTP 상태 코드: 400
- InternalServerException
-
내부 서버 오류로 인해 서비스가이 요청을 완전히 처리할 수 없습니다.
HTTP 상태 코드: 400
- InvalidEndpointException
-
요청된 엔드포인트가 유효하지 않습니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
요청한 리소스를 찾을 수 없습니다.
HTTP 상태 코드: 400
- ThrottlingException
-
요청 제한 때문에 요청이 거부되었습니다.
HTTP 상태 코드: 400
- ValidationException
-
유효하지 않거나 잘못된 형식의 요청입니다.
HTTP 상태 코드: 400
예시
ENABLED_WITH_Word_RATECONTROL 모드에 대한 예약된 쿼리 알림 메시지
다음 예제에서는 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_Word_RATECONTROL 모드에 대한 실패 알림 메시지
다음 예제에서는 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": "my-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" } }
DISABLED 모드에 대한 실패 알림 메시지
다음 예제에서는 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": "my-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 중 하나에서이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
