全部产品
Search
文档中心

表格存储:时序表操作

更新时间:Apr 03, 2025

时序模型通过时序表存储时间序列数据,单表能提供高并发写入和查询以及PB级海量数据的低成本存储。本文将为您介绍如何创建和管理时序表。

注意事项

  • 单个实例中最多可以创建64张表,限制值包含数据表、二级索引表、时序表、Lastpoint索引表和分析存储的数量。更多使用限制介绍,请参见时序模型使用限制

    说明

    由于时序表包含时间线元数据表和时间线数据表,因此一个时序表将占用两个表的名额。

  • 目前支持时序模型功能的地域包括华东1(杭州)、华东2(上海)、华北2(北京)、华北3(张家口)、华北6(乌兰察布)、华南1(深圳)、西南1(成都)、中国香港、日本(东京)、新加坡、马来西亚(吉隆坡)、印度尼西亚(雅加达)、德国(法兰克福)、英国(伦敦)、美国(硅谷)、美国(弗吉尼亚)、沙特(利雅得)

  • 支持自定义时间线标识和配置作为主键的数据字段、Lastpoint索引和时序分析存储功能的地域有华东1(杭州)、华东2(上海)、华北2(北京)和华北3(张家口)。

功能介绍

时序表支持的功能请参见下表。

功能

描述

创建时序表

在创建时序表时,您需要指定与时序表及时间线元数据相关的配置信息。此外,还可以根据业务需求,自定义时间线标识以及作为主键的数据字段、创建分析存储以及创建Lastpoint索引。

更新时序表

修改指定时序表的配置信息(例如数据生命周期)和时间线元数据配置信息(例如时间线元数据生命周期、时间线元数据属性列是否允许更新)。

列出时序表

查询当前实例下所有时序表的名称以及配置信息。

查询时序表描述信息

查询时序表的配置信息(例如数据生命周期)、时序表状态及时间线元数据配置信息(例如时间线元数据生命周期、时间线元数据属性列是否允许更新)。

删除时序表

删除指定的时序表。

操作步骤

创建时序表

通过控制台执行以下操作创建时序表。

  1. 进入实例管理页面。

    1. 登录表格存储控制台

    2. 在页面上方,选择资源组和地域。

    3. 概览页面,单击实例别名或在实例操作列单击实例管理

  2. 实例详情页签,单击时序表列表页签。

  3. 时序表列表页签,单击创建时序表

    说明

    您也可以单击一键生成样例,创建一张测试表以及样例数据来快速体验功能。对于新建的测试表,系统将执行一些初始化操作,因此需要等待约几十秒才能看到时间线。

  4. 创建时序表对话框,按照如下说明配置时序表信息。

    参数

    描述

    时序表名称

    时序表的名称,用于在实例中唯一标识一张时序表。

    • 时序表的命名规则为由大小写字母、数字或下划线(_)组成,且只能以字母或下划线(_)开头,长度在1~128个字符之间。

    • 时序表的名称不得与当前实例中已存在的数据表、二级索引表和其他时序表的名称相同。

    数据生命周期

    时序表中数据的过期时间,单位为秒。数据生命周期取值最小为86400秒(1天),也可以设置为-1(永不过期)。

    当系统判断当前时间减去用户传入数据列的时间已经超过设置的数据生命周期时,系统会自动清理超过数据生命周期的数据。

    说明

    在时序表中,系统判断数据产生时间以用户传入的时间列为准,并非数据写入表中的时间。

    时间线标识

    说明

    只有打开自定义时间线标识和主键开关时,需要配置该选项。

    时间线标识默认由度量名称、数据源和标签组成,您可以通过自定义时间线标识实现按照业务实际需要定义时间线标识。

    • 自定义时间线标识字段名称必须由小写字母、数字和下划线组成,且不能以数字开头。长度为1~128个字节。

    • 自定义时间线标识字段数量上限为6。

    通过单击添加时间线标识,您可以添加多个自定义时间线标识字段;单击自定义时间线标识字段后的fig_20221020_delete图标,可以删除不需要的字段。

    重要

    时序表创建完成后不可变更自定义时间线标识字段,请谨慎操作。

    作为主键的数据字段

    说明

    只有打开自定义时间线标识和主键开关时,需要配置该选项。

    当实际业务中存在时间线标识和时间点相同,但是时序数据不同的数据存储需求时,您可以通过为时序表配置作为主键的数据字段来实现。

    • 作为主键的数据字段名称必须由小写字母、数字和下划线组成,且不能以数字开头。长度为1~128个字节。

    • 作为主键的数据字段数量上限为4。

    • 作为主键的数据字段,数据类型可选为字符串整型

    通过单击添加主键字段,您可以添加多个作为主键的数据字段;单击作为主键的数据字段后的fig_20221020_delete图标,可以删除不需要的字段。

    重要

    时序表创建完成后不可变更作为主键的数据字段,请谨慎操作。

    创建分析存储

    分析存储主要用于时序数据的长期存储和分析场景,能够帮助您低成本存储时序数据,并实现对时序数据的快速查询与分析。

    系统默认已开启分析存储,请根据实际业务场景进行分析存储配置。

    • 如果不需要使用分析存储,关闭创建分析存储开关即可。

    • 如果需要创建默认分析存储,创建分析存储保持默认配置即可。

    • 如果需要自定义分析存储,创建分析存储保持默认配置,打开高级选项开关并配置分析存储名称分析存储生命周期

    创建Lastpoint索引

    Lastpoint索引专门为快速检索时序表中各时间线的最新状态而设计,可用于快速获取监控目标的最新时间点数据。

    系统默认关闭创建Lastpoint索引开关,请根据实际业务场景进行Lastpoint索引配置。

    • 如果不需要创建Lastpoint索引,保持默认配置即可。

    • 如果需要创建Lastpoint索引,请打开创建Lastpoint索引开关,并配置Lastpoint索引名称

      说明
      • Lastpoint索引名称必须由字母、数字和下划线组成,且不能以数字开头。长度为1~128个字节。

      • 一个时序表中Lastpoint索引与分析存储的数量总和不得超过10个。

  5. 单击创建

    时序表创建完成后,在时序表列表页签,您可以查看已创建的时序表。如果新建的表未在列表中显示,可单击fig_tablestore_002图标,刷新时序表列表。

管理时序表

请根据实际需要执行相应操作管理时序表。

功能

描述

列出时序表

时序表列表页签,查看实例内的所有时序表。

更新时序表数据生命周期

  1. 时序表列表页签,单击时序表名称。

  2. 基本详情页签的基本信息区域,单击数据生命周期后的image.png图标。

  3. 在弹出的悬浮框中,修改数据生命周期。

    时序表中数据的过期时间,单位为秒。取值最小为86400秒(1天),也可以设置为-1(永不过期)。

    说明

    更新时序表的数据生命周期(TTL)后,表格存储将自动异步清理时序表中超过TTL的时序数据。

  4. 单击确定

更新时间线元数据生命周期

  1. 时序表列表页签,单击时序表名称。

  2. 基本详情页签的基本信息区域,单击时间线元数据生命周期后的image.png图标。

  3. 在弹出的悬浮框中,修改时间线元数据生命周期。

    时序表中时间线数据的存活时间,单位为秒。取值最小为604800秒(7天),也可以设置为-1(永不过期)。

    说明
    • 时间线元数据生命周期默认值为-1(永久)。

      • 时间线元数据生命周期的取值必须大于或等于时序表的数据生命周期。

      • 如果您要将时间线元数据生命周期更改为非-1的值(最小值为604800秒),请务必确认业务逻辑中不需要更新时间线元数据属性,并且将时间线元数据属性是否允许更新配置为

      • 如果您要将时间线元数据属性是否允许更新配置为,则您必须保证时间线元数据生命周期的值为-1(永久)。

    • 更新时间线元数据生命周期(TTL)后,表格存储将自动异步清理超过TTL的时间线,但不会删除相应的时序数据。您仍然可以通过指定时间线标识的方式查询这些时序数据。

  4. 单击确定

更新时间线元数据属性是否允许更新

  1. 时序表列表页签,单击时序表名称。

  2. 基本详情页签的基本信息区域,单击时间线元数据属性是否允许更新后的image.png图标。

  3. 在弹出的悬浮框中,选择是否允许更新时间线元数据属性列。

    说明

    如果允许更新时间线元数据属性列,则必须将时间线元数据生命周期设置为-1(永不过期)。

  4. 单击确定

查询时序表描述信息

  1. 时序表列表页签,单击时序表名称。

  2. 基本详情页签,查看基本信息时间线标识作为主键的数据字段分析存储Lastpoint索引等相关信息。

删除时序表

  1. 时序表列表页签,单击删除

  2. 在弹出的对话框中单击确定

    重要
    • 时序表删除后不可恢复,请谨慎操作。

    • 删除时序表时,系统将自动删除时序表下的分析存储和Lastpoint索引。

开发集成

功能

调用方式

创建时序表

更新时序表

列出时序表

查询时序表描述信息

删除时序表