表格存储提供了PutTimeseriesData接口用于批量写入时序数据。时序数据由时间线元数据和时序表数据组成。如果未预先新建时间线元数据,当写入时序数据时,系统会自动提取该时间线的元数据信息并自动构建索引。
在表格存储的时序模型中采用一张二维的时序表来存储时序数据。每行代表一个时间线在某个时间点的数据,该行的主键部分为时间线标识和时间戳,该行的数据列部分为该时间线在该时间戳下的数据点,可以有多个数据列。更多信息,请参见时序模型介绍。
注意事项
在写入时序数据时,请合理评估时序表的设计并关注时间线的总条数。如果表中存在大量的短时间线(即一条时间线下仅有一条或几条时序数据),则您可能会看到时序数据的元数据存储量偏大,因为目前表格存储会为每条时间线的元数据构建索引,按照每条时间线4 KB的大小计算元数据的总存储大小。
如果要删除时间线元数据,您可以使用时间线元数据生命周期实现由系统自动清理时间线元数据或者调用DeleteTimeseriesMeta接口进行手动删除。时间线的标识在SDK示例中为TimeseriesKey。
关于时序数据计费的更多信息,请参见时序模型计量计费。
功能概述
调用PutTimeseriesData接口批量写入时序数据,一次PutTimeseriesData操作支持写入多行时序数据。如果该行数据已存在,则先删除原行数据,再写入新行数据。
写入时序数据时,您必须指定时间线标识和时间线数据。如果未预先新建元数据,则系统会根据写入的数据自动提取元数据。
使用方式
您可以使用控制台、命令行工具或者SDK进行数据写入操作。
通过不同使用方式进行操作时支持的功能存在差异,请以实际为准。
写入时序数据前,您需要完成如下准备工作。
已完成时序表创建。具体操作,请参见时序表操作。
使用SDK方式进行操作时,还需要完成初始化Client。具体操作,请参见初始化OTSClient。
使用命令行工具方式进行操作前,还需要完成下载并启动命令行工具,然后配置接入实例信息。具体操作,请参见下载命令行工具和启动并配置接入实例。
使用控制台
使用命令行工具
使用SDK
常见问题
相关文档
如果要进行批量写入时序数据、一次写入多个表、统计写入状态等操作,您可以使用时序Writer实现数据写入。具体操作,请参见使用时序Writer写入时序数据。
写入时序数据后,您可以执行如下操作:
查询时序数据。具体操作,请参见查询时序数据。
为时序表创建映射关系后,使用SQL查询与分析时序数据。具体操作,请参见使用SQL查询时序数据。
如果要迁移MySQL数据源的数据到表格存储时序表中,您可以通过DataX工具实现数据迁移。具体操作,请参见使用DataX同步MySQL数据。
如果要迁移Kafka数据源的数据到表格存储时序表中,您可以通过Tablestore Sink Connector实现数据迁移。具体操作,请参见使用Tablestore Sink Connector同步Kafka数据。
说明在物联网存储场景中,您可以将Kafka数据、EMQX数据、物联网平台数据存储到表格存储时序表中。更多信息,请参见时序数据接入。
通过Flink计算与分析数据后,您可以使用Tablestore时序表存储输出结果。更多信息,请参见使用时序表存储Flink输出结果。
在某些场景下,如果希望将时序表中的时序数据迁移到另一个时序表中,您可以DataWorks数据集成服务实现。更多信息,请参见将表格存储时序表中数据同步到另一个时序表。
您可以管理时间线元数据,例如检索时间线、更新时间线元数据属性、删除时间线元数据等。具体操作,请参见管理时间线元数据。
如果要低成本存储数据以及快速查询与分析数据,您可以为时序表创建分析存储。更多信息,请参见时序分析存储概述。
如果要可视化展示时序数据,您可以通过对接Grafana实现。更多信息,请参见对接Grafana。