赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 表格存储
  4. 操作指南
  5. 时序模型
  6. 时序数据生命周期

时序数据生命周期

  • 时序模型
  • 发布于 2025-04-22
  • 0 次阅读
文档编辑
文档编辑

当要实现自动清理时序表中的历史数据时,您可以使用数据生命周期(TTL)功能有效地管理时序数据,减少数据存储空间,降低存储成本。配置TTL后,如果希望延长数据保存时间,您可以修改TTL。

注意事项

  • 数据清理后无法恢复,请谨慎操作。

    通过配置TTL清理历史数据前,如果需要备份历史数据,请通过DataWorks数据集成服务导出时序数据到OSS中存储。具体操作,请参见同步到OSS。

  • 修改TTL前,您可以调用DescribeTimeseriesTable接口查看当前时序数据生命周期。

数据生命周期

时序模型中的数据包括时间线元数据和时序表数据,分别由时间线元数据表和时间线数据表存储。表格存储分别提供了时间线元数据生命周期和时序表数据生命周期用于管理相应数据。

时序表数据生命周期

时序表数据生命周期是时间线数据表的一个属性,即时序表数据的保存时间,单位为秒。当时序表数据的保留时间超过设置的TTL时,系统会自动异步清理超过TTL的数据。

例如数据表的TTL设置为86400(一天),在2016-07-21 00:00:00 UTC+8时,时序表中数据早于2016-07-20 00:00:00 UTC+8的时间线均会过期,系统会自动异步清理对应过期数据。

创建时序表时,如果未设置TTL,则系统会使用默认值-1(表示数据永不过期),您也可以自定义TTL。创建时序表后,您可以通过UpdateTimeseriesTable接口修改TTL。

超过TTL的过期数据为无效数据,即使系统还未删除数据,用户已无法查询对应数据。

  • 当调小TTL时,时序表中可能会有数据过期,系统会异步删除对应过期数据。

  • 当调大TTL时,如果系统还未删除在旧的TTL之外以前的时序表数据,且对应时序表数据在新设的TTL中,则对应时序表数据可以重新查询。

时间线元数据生命周期

时间线元数据生命周期是时间线元数据表的一个属性,即时间线元数据的保存时间,单位为秒。当时间线元数据的保留时间超过设置的TTL时,系统会自动异步清理超过TTL的时间线元数据,不会删除时序表数据。

重要

当某些时间线元数据过期,但是相应时间线数据未过期时,通过GetTimeseriesData接口指定时间线标识进行查询时仍可查询到时序表数据。

创建时序表时,如果未设置TTL,则系统会使用默认值-1(表示数据永不过期),您也可以自定义TTL。创建时序表后,您可以通过UpdateTimeseriesTable接口修改TTL。

重要

时间线元数据中有一个时间线元数据属性列(_attributes)支持进行更新,但目前仅在时间线元数据生命周期为-1(数据永不过期)时支持该属性的更新。

如果要将时间线元数据生命周期从-1修改为大于等于7天,请确认业务逻辑中不需要更新时间线元数据属性,并将时间线元数据属性是否允许更新配置为否。

如果要将时间线元数据属性是否允许更新配置为是,则您需要同步将时间线元数据生命周期调整为-1。

超过TTL的过期数据为无效数据,即使系统还未删除时间线元数据,用户已无法检索到对应时间线元数据。

  • 当调小TTL时,时间线元数据表中可能会有时间线元数据过期,系统会异步删除对应过期数据。

  • 当调大TTL时,如果系统还未删除在旧的TTL之外以前的时间线元数据,且对应时间线元数据在新设的TTL中,则对应时间线元数据可以重新检索到。

使用方式

创建时序表时,您可以配置数据生命周期。您也可以在创建时序表后修改数据生命周期。此处以创建时序表后修改数据生命周期为例介绍。您可以使用控制台、命令行工具或者SDK进行数据生命周期修改操作。

说明
  • 关于在创建数据表时进行数据生命周期配置的具体操作,请参见时序表操作。

  • 通过不同使用方式进行操作时支持的功能存在差异,请以实际为准。

使用控制台

您可以使用控制台修改时间线元数据生命周期或时序表数据生命周期。

修改时序表数据生命周期

  1. 进入实例管理页面。

    1. 登录表格存储控制台。

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

    3. 在概览页面,单击实例名称或者单击实例操作的实例管理。

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

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

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

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

    时序表中数据的过期时间,单位为秒。取值必须大于等于86400秒(一天)或者必须为-1(数据永不过期)。

  6. 单击确定。

修改时间线元数据生命周期

  1. 进入实例管理页面。

    1. 登录表格存储控制台。

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

    3. 在概览页面,单击实例名称或者单击实例操作的实例管理。

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

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

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

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

    时序时间线表的时间线数据存活时间,单位为秒。取值必须大于等于604800秒(即7天)或者必须为-1(数据永不过期)。

  6. 单击确定。

使用命令行工具

您可以使用命令行工具修改时序表数据生命周期。

执行alter命令更新表信息。更多信息,请参见更新表。

以下示例用于修改当前表的数据生命周期为86400秒(即1天)。

alter --ttl 86400 --ts

使用SDK

您可以使用SDK修改时间线元数据生命周期或时序表数据生命周期。

修改时序表数据生命周期

以下示例用于更新指定时序表的TTL为3年。

private static void updateTimeseriesTable(TimeseriesClient client) {
    // 填写时序表名称。
    String tableName = "<TIMESERIES_TABLE>";
    UpdateTimeseriesTableRequest updateTimeseriesTableRequest = new UpdateTimeseriesTableRequest(tableName);
    // 更新TTL为3年。
    updateTimeseriesTableRequest.setTimeseriesTableOptions(new TimeseriesTableOptions(86400 * 365 * 3)); 
    client.updateTimeseriesTable(updateTimeseriesTableRequest);

    DescribeTimeseriesTableResponse describeTimeseriesTableResponse = client.describeTimeseriesTable(new DescribeTimeseriesTableRequest(tableName));
    TimeseriesTableMeta tableMeta = describeTimeseriesTableResponse.getTimeseriesTableMeta();
    // 查看更新后时序表的TTL配置。
    System.out.println(tableMeta.getTimeseriesTableOptions().getTimeToLive()); 
}

修改时间线元数据生命周期

以下示例用于更新指定时序表的时间线元数据TTL为3年。

private static void updateTimeseriesMetaTableTTL(TimeseriesClient client) {
    // 填写时序表名称。
    String tableName = "<TIMESERIES_TABLE>";
    UpdateTimeseriesTableRequest updateTimeseriesTableRequest = new UpdateTimeseriesTableRequest(tableName);
    // 更新TTL为3年。
    TimeseriesMetaOptions options = new TimeseriesMetaOptions();
    options.setMetaTimeToLive(86400 * 365 * 3);
    updateTimeseriesTableRequest.setTimeseriesMetaOptions(options);
    client.updateTimeseriesTable(updateTimeseriesTableRequest);
}

常见问题

如何删除时序数据

相关文档

分析存储是针对时序场景进行定制优化的低成本存储引擎。您可以使用分析存储低成本存储时序数据以及快速查询和分析时序数据。

相关文章

创建时序模型实例 2025-04-22 14:43

创建时序模型实例后,您可以使用控制台、CLI工具或者SDK快速体验时序模型功能。 注意事项

时序表操作 2025-04-22 14:43

时序模型通过时序表存储时间序列数据,单表能提供高并发写入和查询以及PB级海量数据的低成本存储。本文将为您介绍如何创建和管理时序表。 注意事项 单个实例中最多可以创建64张表,限制值包含数据表、二级索引表、时序表、Lastpoint索引表和分析存储的数量。更多使用限制介绍,请参见时序模型使用限制

时序数据生命周期 2025-04-22 14:43

当要实现自动清理时序表中的历史数据时,您可以使用数据生命周期(TTL)功能有效地管理时序数据,减少数据存储空间,降低存储成本。配置TTL后,如果希望延长数据保存时间,您可以修改TTL。 注意事项 数据清理后无法恢复,请谨慎操作。 通过配置TTL清理历史数据前,如果需要备

时间线操作 2025-04-22 14:43

时间线元数据也称为时间序列元数据,主要由时间线标识、属性和更新时间组成。本文将为您介绍如何管理时间线元数据。 功能概述 写入时序数据前,您可以预先定义时间线。如果未预先新建时间线元数据,当写入时序数据时,系统会自动提取该时间线的元数据信息并自动构建索引。 时间线元数据生成后,您可以根据所需场景管理时

时序数据操作 2025-04-22 14:43

本文将为您介绍表格存储中时序数据的写入与查询操作。 写入时序数据 创建时序表后,请根据实际场景选择合适的方式写入时序数据。 如果要通过SDK批量写入时序数据到时序表,请参见写入时序数据。

写入时序数据 2025-04-22 14:43

时序数据由元数据和数据两部分组成,元数据用于记录时间序列的标识信息和属性信息,而数据则记录了所有时间序列的数据点(包括产生数据点的时间和对应的数据值)。本文将为您介绍如何写入时序数据。 功能概述 您可以通过控制台、SDK或命令行的方式写入时序数据。如果待写入的行数据已存在,则将先删除原有的行数据,然

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号