Tablestore：行政時間線中繼資料

檢索時間軸

1. 進入執行個體管理頁面。

   1. 登入Table Store控制台。

   2. 在頁面上方，選擇資源群組和地區。

   3. 在概覽頁面，單擊執行個體名稱或者單擊執行個體操作的執行個體管理。

2. 在執行個體詳情頁簽，單擊時序表列表頁簽。

3. 在時序表列表頁簽，單擊時序表名稱後選擇資料管理頁簽或在時序表操作列單擊資料管理。

4. 在資料管理頁簽，單擊右上方的查詢資料。

5. 在查詢資料對話方塊，輸入時間軸的度量名稱，根據實際需要輸入資料來源以及單擊對應地區的添加設定標籤、屬性或者更新時間的匹配條件。

   下圖中條件用於查詢度量名稱為cpu，標籤中含有os=Ubuntu16.10的所有時間軸。

6. 單擊確定。

   符合查詢條件的資料會顯示在資料管理頁簽。

更新時間軸中繼資料

1. 進入執行個體管理頁面。

   1. 登入Table Store控制台。

   2. 在頁面上方，選擇資源群組和地區。

   3. 在概覽頁面，單擊執行個體名稱或者單擊執行個體操作的執行個體管理。

2. 在執行個體詳情頁簽，單擊時序表列表頁簽。

3. 在時序表列表頁簽，單擊時序表名稱後選擇資料管理頁簽或在時序表操作列單擊資料管理。

4. 在資料管理頁簽，單擊時間軸操作列的更新。

5. 在更新時間軸對話方塊，根據需要添加、刪除或者修改時間軸中繼資料屬性。

6. 單擊確定。

檢索時間軸

執行query_ts_meta（簡寫為qtm）命令根據條件檢索時間軸以及返回全部或者指定個數的時間軸。更多資訊，請參見檢索時間軸或掃描時間軸。

• 根據條件檢索時間軸

  以下樣本用於檢索度量名稱為cpu且資料來源標識為localhost的時間軸。

  query_ts_meta --measurement cpu --datasource localhost --limit 10

• 掃描指定個數時間軸

  以下樣本用於返回表中10個時間軸。

  query_ts_meta --limit 10

更新時間軸中繼資料

執行update_ts_meta（簡寫為utm）命令更新時間軸中繼資料屬性。

以下樣本用於更新指定時間軸的屬性為"city=nanjing"和"region=jiangning"。

update_ts_meta --k '["cpu","localhost",["city=hangzhou","region=xihu"]]' --attrs '["city=nanjing","region=jiangning"]' 

檢索時間軸

以下樣本用於查詢指定時序表中度量名稱為cpu，標籤中含有os標籤且標籤首碼為Ubuntu的所有時間軸。

private static void queryTimeseriesMeta(TimeseriesClient client) {
    // 填寫時序表名稱。
    String tableName = "<TIME_SERIES_TABLE>";
    QueryTimeseriesMetaRequest queryTimeseriesMetaRequest = new QueryTimeseriesMetaRequest(tableName);
    // 查詢度量名稱為cpu，標籤中含有os標籤且首碼為"Ubuntu"的所有時間軸。即measurement_name="cpu" and have_prefix(os, "Ubuntu")。
    CompositeMetaQueryCondition compositeMetaQueryCondition = new CompositeMetaQueryCondition(MetaQueryCompositeOperator.OP_AND);
    compositeMetaQueryCondition.addSubCondition(new MeasurementMetaQueryCondition(MetaQuerySingleOperator.OP_EQUAL, "cpu"));
    compositeMetaQueryCondition.addSubCondition(new TagMetaQueryCondition(MetaQuerySingleOperator.OP_PREFIX, "os", "Ubuntu"));
    queryTimeseriesMetaRequest.setCondition(compositeMetaQueryCondition);
    queryTimeseriesMetaRequest.setGetTotalHits(true);
    // 限制單次請求返回的時間軸中繼資料條數。
    queryTimeseriesMetaRequest.setLimit(100);
    // 發起查詢。
    QueryTimeseriesMetaResponse queryTimeseriesMetaResponse = client.queryTimeseriesMeta(queryTimeseriesMetaRequest);
    // 列印合格時間軸的總條數。
    System.out.println(queryTimeseriesMetaResponse.getTotalHits());

    // 儲存請求結果。
    List<TimeseriesMeta> timeseriesMetas = new ArrayList<TimeseriesMeta>();
    timeseriesMetas.addAll(queryTimeseriesMetaResponse.getTimeseriesMetas());

    // 如果有NextToken，可以繼續發起請求擷取。
    while (queryTimeseriesMetaResponse.getNextToken() != null) {
        queryTimeseriesMetaRequest.setNextToken(queryTimeseriesMetaResponse.getNextToken());
        queryTimeseriesMetaResponse = client.queryTimeseriesMeta(queryTimeseriesMetaRequest);
        timeseriesMetas.addAll(queryTimeseriesMetaResponse.getTimeseriesMetas());
        // 限制總共擷取的條數。
        if (timeseriesMetas.size() >= 1000) {
            break;
        }
    }

    System.out.println(timeseriesMetas.size());
    for (TimeseriesMeta timeseriesMeta : timeseriesMetas) {
        System.out.println(timeseriesMeta.getTimeseriesKey().getMeasurementName());
        System.out.println(timeseriesMeta.getTimeseriesKey().getDataSource());
        System.out.println(timeseriesMeta.getTimeseriesKey().getTags());
        System.out.println(timeseriesMeta.getAttributes());
        System.out.println(timeseriesMeta.getUpdateTimeInUs());
    }
}

更新時間軸中繼資料

以下樣本用於更新指定時序表中時間軸的屬性資訊。

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());
        }
    }
}

刪除時間軸中繼資料

以下樣本用於刪除指定時序表中的部分時間軸。

private static void deleteTimeseriesMeta(TimeseriesClient client) {
    List<TimeseriesKey> timeseriesKeyList = new ArrayList<TimeseriesKey>();
    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);
        timeseriesKeyList.add(timeseriesKey);
    }
    // 填寫時序表名稱。
    String tableName = "<TIME_SERIES_TABLE>";
    DeleteTimeseriesMetaRequest deleteTimeseriesMetaRequest = new DeleteTimeseriesMetaRequest(tableName);
    deleteTimeseriesMetaRequest.setTimeseriesKeys(timeseriesKeyList);
    DeleteTimeseriesMetaResponse deleteTimeseriesMetaResponse = client.deleteTimeseriesMeta(deleteTimeseriesMetaRequest);
    // 檢查是否全部成功。
    if (!deleteTimeseriesMetaResponse.isAllSuccess()) {
        for (DeleteTimeseriesMetaResponse.FailedRowResult failedRowResult : deleteTimeseriesMetaResponse.getFailedRows()) {
            System.out.println(failedRowResult.getIndex());
            System.out.println(failedRowResult.getError());
        }
    }
}