Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. [여기](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)에서 자세히 알아보세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 예약된 쿼리 오류 보고서
이 섹션에서는 예약된 쿼리를 실행하여 오류가 발생할 때 Timestream for LiveAnalytics에서 생성된 오류 보고서의 위치, 형식 및 이유를 설명합니다.
**Topics**
+ [이유](#scheduled-queries-error-report-reasons)
+ [Location](#scheduled-queries-error-report-location)
+ [형식](#scheduled-queries-error-report-format)
+ [오류 유형](#scheduled-queries-error-report-error-types)
+ [예제](#scheduled-queries-error-report-example)
## 예약된 쿼리 오류는 이유를 보고합니다.
복구 가능한 오류에 대한 오류 보고서가 생성됩니다. 복구할 수 없는 오류에 대해서는 오류 보고서가 생성되지 않습니다. Timestream for LiveAnalytics는 복구할 수 없는 오류가 발생할 때 예약된 쿼리를 자동으로 비활성화할 수 있습니다. 다음이 포함됩니다.
+ `AssumeRole` 장애
+ 고객 관리형 KMS 키가 지정될 때 KMS와 통신할 때 발생하는 모든 4xx 오류
+ 예약된 쿼리가 실행될 때 발생하는 모든 4xx 오류
+ 쿼리 결과를 수집하는 동안 발생한 모든 4xx 오류
복구할 수 없는 오류의 경우 Timestream for LiveAnalytics는 복구할 수 없는 오류 메시지와 함께 실패 알림을 보냅니다. 예약된 쿼리가 비활성화되었음을 나타내는 업데이트 알림도 전송됩니다.
## 예약된 쿼리 오류 보고서 위치
예약된 쿼리 오류 보고서 위치에는 다음과 같은 이름 지정 규칙이 있습니다.
```
s3://customer-bucket/customer-prefix/
```
다음은 예약된 쿼리 ARN의 예입니다.
```
arn:aws:timestream:us-east-1:000000000000:scheduled-query/test-query-hd734tegrgfd
```
```
s3://customer-bucket/customer-prefix/test-query-hd734tegrgfd///
```
*자동*은 Timestream for LiveAnalytics에서 자동으로 예약된 쿼리를 나타내고 *수동*은 Amazon Timestream for LiveAnalytics 쿼리의 `ExecuteScheduledQuery` API 작업을 통해 사용자가 수동으로 트리거한 예약된 쿼리를 나타냅니다. `ExecuteScheduledQuery`에 대한 자세한 내용은 [ExecuteScheduledQuery](https://docs.aws.amazon.com/timestream/latest/developerguide/API_query_ExecuteScheduledQuery.html)를 참조하세요.
## 예약된 쿼리 오류 보고서 형식
오류 보고서의 JSON 형식은 다음과 같습니다.
```
{
"reportId": , // A unique string ID for all error reports belonging to a particular scheduled query run
"errors": [ , ... ], // One or more errors
}
```
## 예약된 쿼리 오류 유형
`Error` 객체는 다음 세 가지 유형 중 하나일 수 있습니다.
+ 레코드 수집 오류
```
{
"reason": , // The error message String
"records": [ , ... ], // One or more rejected records )
}
```
+ 행 구문 분석 및 검증 오류
```
{
"reason": , // The error message String
"rawLine": , // [Optional] The raw line String that is being parsed into record(s) to be ingested. This line has encountered the above-mentioned parse error.
}
```
+ 일반 오류
```
{
"reason": , // The error message
}
```
## 예약된 쿼리 오류 보고서 예제
다음은 수집 오류로 인해 생성된 오류 보고서의 예입니다.
```
{
"reportId": "C9494AABE012D1FBC162A67EA2C18255",
"errors": [
{
"reason": "The record timestamp is outside the time range [2021-11-12T14:18:13.354Z, 2021-11-12T16:58:13.354Z) of the memory store.",
"records": [
{
"dimensions": [
{
"name": "dim0",
"value": "d0_1",
"dimensionValueType": null
},
{
"name": "dim1",
"value": "d1_1",
"dimensionValueType": null
}
],
"measureName": "random_measure_value",
"measureValue": "3.141592653589793",
"measureValues": null,
"measureValueType": "DOUBLE",
"time": "1637166175635000000",
"timeUnit": "NANOSECONDS",
"version": null
},
{
"dimensions": [
{
"name": "dim0",
"value": "d0_2",
"dimensionValueType": null
},
{
"name": "dim1",
"value": "d1_2",
"dimensionValueType": null
}
],
"measureName": "random_measure_value",
"measureValue": "6.283185307179586",
"measureValues": null,
"measureValueType": "DOUBLE",
"time": "1637166175636000000",
"timeUnit": "NANOSECONDS",
"version": null
},
{
"dimensions": [
{
"name": "dim0",
"value": "d0_3",
"dimensionValueType": null
},
{
"name": "dim1",
"value": "d1_3",
"dimensionValueType": null
}
],
"measureName": "random_measure_value",
"measureValue": "9.42477796076938",
"measureValues": null,
"measureValueType": "DOUBLE",
"time": "1637166175637000000",
"timeUnit": "NANOSECONDS",
"version": null
},
{
"dimensions": [
{
"name": "dim0",
"value": "d0_4",
"dimensionValueType": null
},
{
"name": "dim1",
"value": "d1_4",
"dimensionValueType": null
}
],
"measureName": "random_measure_value",
"measureValue": "12.566370614359172",
"measureValues": null,
"measureValueType": "DOUBLE",
"time": "1637166175638000000",
"timeUnit": "NANOSECONDS",
"version": null
}
]
}
]
}
```