全部產品
Search
文件中心

Tablestore:建立時序表

更新時間:Jul 17, 2024

當使用Table Store時序模型時,您需要使用CreateTimeseriesTable介面建立時序表用於儲存時序資料。建立時序表時支援配置資料生命週期、時序時間軸表的配置資訊。

前提條件

注意事項

時序表的名稱不能與當前已存在的資料表名稱相同。

介面

public class CreateTimeseriesTableRequest implements Request {
    /**時序表的結構資訊。*/
    private TimeseriesTableMeta timeseriesTableMeta;
}

參數

參數

說明

TimeseriesTableMeta

時序表的結構資訊,包含如下內容:

  • timeseriesTableName:時序表名。

  • timeseriesMetaOptions:時序時間軸表的配置資訊,包括如下內容:

    • metaTimeToLive:配置時序時間軸表的時間軸資料存活時間,單位為秒。取值必須大於等於604800秒(即7天)或者必須為-1(資料永不到期)。

    • allowUpdateAttributes:是否允許更新時間軸屬性列。

    您可以通過UpdateTimeseriesTable介面修改相應配置。

  • timeseriesTableOptions:時序表的配置資訊,包括如下內容:

    timeToLive:配置時序表的資料存活時間,單位為秒。如果希望資料永不到期,可以設定為-1。您可以通過UpdateTimeseriesTable介面修改。

樣本

以下樣本用於建立test_timeseries_table時序表,且該表中資料永不到期。

private static void createTimeseriesTable(TimeseriesClient client) {
    String tableName = "test_timeseries_table";
    TimeseriesTableMeta timeseriesTableMeta = new TimeseriesTableMeta(tableName);
    int timeToLive = -1;
    timeseriesTableMeta.setTimeseriesTableOptions(new TimeseriesTableOptions(timeToLive));
    CreateTimeseriesTableRequest request = new CreateTimeseriesTableRequest(timeseriesTableMeta);
    
    client.createTimeseriesTable(request);
}

相關文檔

  • 建立時序表後,您可以寫入時序資料以及讀取表中時序資料。具體操作,請參見寫入時序資料查詢時序資料

  • 如果要修改時序表的資料生命週期,您可以通過更新時序表功能實現。具體操作,請參見更新時序表

  • 如果要查詢當前執行個體下的所有時序表,您可以通過列出時序表名稱實現。具體操作,請參見列出時序表名稱

  • 如果要查看時序表的詳細配置資訊,您可以通過查詢時序表描述資訊實現。更多資訊,請參見查詢時序表描述資訊

  • 如果不再使用時序表,您可以刪除時序表。具體操作,請參見刪除時序表

  • 如果要以更低成本備份Table Store中的時序資料或者以檔案形式匯出時序資料到本地,您可以通過DataWorksData Integration服務將Table Store中的時序資料匯出到OSS後進行儲存或者下載。更多資訊,請參見將Table Store資料同步到OSS

  • 如果要可視化展示時序資料,您可以通過對接Grafana實現。更多資訊,請參見對接Grafana

  • 通過Flink計算與分析資料後,您可以使用Tablestore時序表格儲存體輸出結果。更多資訊,請參見使用教程(時序模型)