使用自定义复合分区键进行 LiveAnalytics 架构验证的时间流 - Amazon Timestream
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

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

使用自定义复合分区键进行 LiveAnalytics 架构验证的时间流

Timestream 中的架构验证 LiveAnalytics 有助于确保输入到数据库中的数据符合指定的架构,从而最大限度地减少摄取错误并提高数据质量。特别是,当采用客户定义的分区键以优化查询性能时,架构验证特别有用。

使用客户定义的分区 LiveAnalytics 键进行架构验证的时间流是什么?

用于 LiveAnalytics 架构验证的时间流是一项功能,它可以根据预定义的架构验证输入到 LiveAnalytics表的时间流中的数据。此架构定义了数据模型,包括要插入的记录的分区键、数据类型和约束。

使用客户定义的分区键时,架构验证变得更加重要。分区键允许您指定分区键,该分区键决定了您的数据在 Timestream 中的存储方式。 LiveAnalytics通过使用自定义分区键对照架构验证传入的数据,您可以强制执行数据一致性,尽早发现错误,并提高存储在 Timestream 中的数据的整体质量。 LiveAnalytics

如何使用 Timestream 通过自定义复合分区键进行 LiveAnalytics 架构验证

要使用 Timestream 对自定义复合分区键进行 LiveAnalytics 架构验证,请执行以下步骤:

想一想你的查询模式会是什么样子:要正确选择和定义 Timestream LiveAnalytics 表的架构,你应该从查询要求开始。

指定自定义复合分区键:创建表时,请指定自定义分区键。此键决定将用于对表数据进行分区的属性。您可以在维度键和度量键之间进行选择以进行分区。维度键根据维度名称对数据进行分区,而度量键则根据度量名称对数据进行分区。

设置强制级别:为了确保正确的数据分区以及随之而来的好处,Amazon Timestream for 允许您 LiveAnalytics 为架构中的每个分区键设置强制级别。强制级别决定了载入记录时分区键维度是必填的还是可选的。你可以在两个选项之间进行选择:REQUIRED,这意味着分区键必须存在于摄取的记录中;和OPTIONAL,这意味着分区键不必存在。建议您在使用客户定义的分区时使用REQUIRED强制级别,以确保对数据进行正确分区,并充分利用此功能。此外,您可以在架构创建后随时更改强制级别配置,以适应您的数据摄取要求。

摄取数据:将数据提取到 Timestream for LiveAnalytics 表时,架构验证过程将使用自定义复合分区键对照定义的架构检查记录。如果记录不符合架构,则 Timestream LiveAnalytics 将返回验证错误。

处理验证错误:如果出现验证错误,Timestream for LiveAnalytics 将返回 a ValidationException 或 aRejectedRecordsException,具体取决于错误的类型。请务必在应用程序中处理这些异常并采取适当的措施,例如修复错误的记录并重试摄取。

更新强制级别:如有必要,您可以在创建表后使用UpdateTable操作更新分区键的强制级别。但是,需要注意的是,分区键配置的某些方面(例如名称和类型)在创建表后无法更改。如果将强制级别从更改REQUIREDOPTIONAL,则无论是否存在选择为客户定义的分区键的属性,所有记录都将被接受。相反,如果将强制级别从OPTIONAL更改为REQUIRED,则对于不符合此条件的记录,可能会开始看到 4xx 写入错误。因此,在创建表时,必须根据数据的分区要求为您的用例选择适当的实施级别。

何时使用 Timestream 对自定义复合分区键进行 LiveAnalytics 架构验证

在数据一致性、质量和优化分区至关重要的场景中,应使用使用自定义复合分区键进行 LiveAnalytics 架构验证的时间流。通过在数据摄取期间强制使用架构,您可以防止可能导致错误分析或丢失宝贵见解的错误和不一致。

与批量加载任务的交互

在设置批量加载任务以使用客户定义的分区键将数据导入表时,有几种情况可能会影响该过程:

  1. 如果将强制级别设置为OPTIONAL,则如果在配置作业期间未映射分区键,则在创建流程期间,控制台上将显示警报。使用 API 或 CLI 时不会出现此警报。

  2. 如果将强制级别设置为REQUIRED,则除非将分区键映射到源数据列,否则作业创建将被拒绝。

  3. 如果在创建任务REQUIRED后将强制级别更改为,则该作业将继续执行,但是任何没有正确映射分区键的记录都将被拒绝,并出现 4xx 错误。

与计划查询的交互

在设置计划查询作业以计算聚合、汇总和其他形式的预处理数据并将其存储到具有客户定义分区键的表中时,有几种情况可能会影响该过程:

  1. 如果将强制级别设置为OPTIONAL,则如果在配置作业期间未映射分区键,则会显示警报。使用 API 或 CLI 时不会出现此警报。

  2. 如果将强制级别设置为REQUIRED,则除非将分区键映射到源数据列,否则作业创建将被拒绝。

  3. 如果在任务创建REQUIRED后将强制级别更改为,并且计划查询结果不包含分区键维度,则该作业的所有后续迭代都将失败。