全部產品
Search
文件中心

Tablestore:建立時序表

更新時間:Jul 27, 2024

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

前提條件

注意事項

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

參數

參數

說明

TimeseriesTableMeta

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

  • timeseriesTableName:時序表名。

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

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

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

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

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

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

樣本

以下樣本用於建立一個時序表。

/**
 * CreateTimeseriesTableSample用於建立一個時序表,時序表名為timeseriesTableName,TTL為timeTolive。
 */
func CreateTimeseriesTableSample(client *tablestore.TimeseriesClient, timeseriesTableName string , timeToLive int64) {
    fmt.Println("[Info]: Begin to create timeseries table: " , timeseriesTableName)

    // 構造時序表配置資訊。
    timeseriesTableOptions := tablestore.NewTimeseriesTableOptions(timeToLive)        

    // 構造表中繼資料資訊。
    // 設定時序表名。
    timeseriesTableMeta := tablestore.NewTimeseriesTableMeta(timeseriesTableName)  
    // 設定時序表配置資訊。
    timeseriesTableMeta.SetTimeseriesTableOptions(timeseriesTableOptions)      

    // 構造建立時序表請求。
    createTimeseriesTableRequest := tablestore.NewCreateTimeseriesTableRequest()    
    createTimeseriesTableRequest.SetTimeseriesTableMeta(timeseriesTableMeta)

    // 調用client建立時序表。
    createTimeseriesTableResponse , err := client.CreateTimeseriesTable(createTimeseriesTableRequest)    
    if err != nil {
        fmt.Println("[Error]: Failed to create timeseries table with error: " , err)
        return
    }
    fmt.Println("[Info]: CreateTimeseriesTable finished! RequestId: " , createTimeseriesTableResponse.RequestId)
}

相關文檔

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

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

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

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

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

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

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

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