赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 表格存储
  4. 开发参考
  5. SDK参考
  6. Java SDK
  7. 时序模型
  8. 时序数据操作
  9. 更新时间线元数据

更新时间线元数据

  • 时序数据操作
  • 发布于 2025-04-22
  • 0 次阅读
文档编辑
文档编辑

使用UpdateTimeseriesMeta接口,您可以批量更新时间线元数据的属性。一次UpdateTimeseriesMeta调用支持更新多个时间线的元数据。如果更新的时间线元数据不存在,则直接执行新增操作。

说明

API接口说明请参见UpdateTimeseriesMeta。

前提条件

  • 已写入时序数据。具体操作,请参见写入时序数据。

  • 已初始化TimeseriesClient。具体操作,请参见初始化Tablestore Client。

接口

public class UpdateTimeseriesMetaRequest implements Request {
    /** 时序表名称。*/
    private final String timeseriesTableName;
    /** 时间线元数据。*/
    private List<TimeseriesMeta> metas = new ArrayList<TimeseriesMeta>();
}

public class TimeseriesMeta {
    /** 时间线元数据标识。*/
    private TimeseriesKey timeseriesKey;
    /** 时间线元数据属性。*/
    private SortedMap<String, String> attributes = new TreeMap<String, String>();
    /** 时间线元数据生命周期。*/
    private long updateTimeInUs = -1;
}

public class TimeseriesKey implements Comparable<TimeseriesKey> {
    /** 度量名称。*/
    private final String measurementName;
    /** 数据源名称。*/
    private final String dataSource;
    /** 标签信息。*/
    private final SortedMap<String, String> tags = new TreeMap<String, String>();
    private String tagsString;
}

参数

timeseriesMeta表示一个时间线元数据,每个timeseriesMeta包括timeseriesKey和attributes。详细参数说明请参见下表,

参数

描述

timeseriesKey

时间线标识。

attributes

时间线的属性信息,内容为字符串类型的key-value对。

示例

以下示例用于更新指定时序表中时间线的属性信息。

private static void updateTimeseriesMeta(TimeseriesClient client) {
    List<TimeseriesMeta> timeseriesMetaList = new ArrayList<TimeseriesMeta>();
    for (int i = 0; i < 10; i++) {
        Map<String, String> tags = new HashMap<String, String>();
        tags.put("region", "hangzhou");
        tags.put("os", "Ubuntu16.04");
        // 构造TimeseriesKey。
        TimeseriesKey timeseriesKey = new TimeseriesKey("cpu", "host_" + i, tags);
        TimeseriesMeta meta = new TimeseriesMeta(timeseriesKey);
        // 设置时间线的属性值(attributes)。
        Map<String, String> attrs = new HashMap<String, String>();
        attrs.put("status", "online");
        meta.setAttributes(attrs);
        timeseriesMetaList.add(meta);
    }
    // 填写时序表名称。
    String tableName = "<TIME_SERIES_TABLE>";
    UpdateTimeseriesMetaRequest updateTimeseriesMetaRequest = new UpdateTimeseriesMetaRequest(tableName);
    updateTimeseriesMetaRequest.setMetas(timeseriesMetaList);
    UpdateTimeseriesMetaResponse updateTimeseriesMetaResponse = client.updateTimeseriesMeta(updateTimeseriesMetaRequest);
    // 检查是否全部成功。
    if (!updateTimeseriesMetaResponse.isAllSuccess()) {
        for (UpdateTimeseriesMetaResponse.FailedRowResult failedRowResult : updateTimeseriesMetaResponse.getFailedRows()) {
            System.out.println(failedRowResult.getIndex());
            System.out.println(failedRowResult.getError());
        }
    }
}
相关文章

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

创建时序表后,您可以使用PutTimeseriesData接口批量写入时序数据。一次PutTimeseriesData调用支持写入多行数据。 前提条件

查询时序数据 2025-04-22 14:27

使用GetTimeseriesData接口,您可以查询符合指定条件的时序数据。 前提条件

检索时间线 2025-04-22 14:27

当不确定要查询的时间线信息(例如度量名称、数据源信息)或者需要按照指定条件列出时间线时,您可以使用QueryTimeseriesMeta接口指定度量名称、数据源、标签、属性、更新时间等多种条件检索时间线。

更新时间线元数据 2025-04-22 14:27

使用UpdateTimeseriesMeta接口,您可以批量更新时间线元数据的属性。一次UpdateTimeseriesMeta调用支持更新多个时间线的元数据。如果更新的时间线元数据不存在,则直接执行新增操作。

删除时间线元数据 2025-04-22 14:27

使用DeleteTimeseriesMeta接口,您可以批量删除时间线元数据。 说明

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