计划查询错误报告 - Amazon Timestream
原因位置格式错误类型示例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

从2025年6月20日起，亚马逊Timestream版 LiveAnalytics 将不再向新客户开放。如果您想使用亚马逊 Timestream LiveAnalytics，请在该日期之前注册。现有客户可以继续照常使用该服务。有关更多信息，请参阅 Amazon Timestream 以了解 LiveAnalytics 可用性变更。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

计划查询错误报告

本节介绍运行计划查询遇到错误时由 Timestream 生成的错误报告的位置、格式和原因 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 自动安排的预定查询， LiveAnalytics 并Manual表示用户通过 Amazon Timestre LiveAnalytics am 中的 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对象可以是以下三种类型之一：

  • 记录摄取错误

    {
    "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
                }
            ]
        }
    ]
}