スケジュールされたクエリのエラーレポート - Amazon Timestream
理由場所形式エラーのタイプ例

Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、こちらを参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

スケジュールされたクエリのエラーレポート

このセクションでは、スケジュールされたクエリを実行してエラーが発生した場合に Timestream for LiveAnalytics によって生成されるエラーレポートの場所、形式、生成される理由について説明します。

スケジュールされたクエリのエラーレポートが生成される理由

エラーレポートは、回復可能なエラーに対して生成されます。エラーレポートは、回復不可能なエラーに対しては生成されません。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/<InvocationTime>/<Auto or Manual>/<Actual Trigger Time>

Auto は、スケジュールされたクエリが Timestream for LiveAnalytics によって自動的にスケジュールされたことを示します。Manual は、スケジュールされたクエリを Amazon Timestream for LiveAnalytics Query の ExecuteScheduledQuery API アクションを介してユーザーが手動でトリガーしたことを示します。ExecuteScheduledQuery の詳細については、「ExecuteScheduledQuery」を参照してください。

スケジュールされたクエリのエラーレポートの形式

エラーレポートは次の JSON 形式で生成されます。

{
    "reportId": <String>,            // A unique string ID for all error reports belonging to a particular scheduled query run
    "errors": [ <Error>, ... ],      // One or more errors
}

スケジュールされたクエリのエラーのタイプ

Error オブジェクトのタイプは次の 3 つのいずれかになります。

  • レコード取り込みエラー

    {
    "reason": <String>,              // The error message String
    "records": [ <Record>, ... ],    // One or more rejected records )
}

  • 行の解析および検証エラー

    {
    "reason": <String>,        // The error message String
    "rawLine": <String>,       // [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": <String>,        // 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
                }
            ]
        }
    ]
}