Tablestore：時序表操作

通過控制台建立一張時序表。

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

   1. 登入Table Store控制台。

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

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

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

3. 在時序表列表頁簽，單擊建立時序表。

   說明

   您也可以單擊一鍵產生範例，建立一張測試表以及範例資料來快速體驗功能。對於建立的測試表，系統會進行一些初始化操作，因此需要等待幾十秒左右才能看到時間軸。

4. 在建立時序表對話方塊，按照如下說明配置時序表資訊。

   參數	描述
   時序表名稱	時序表的名稱，用於在執行個體中唯一標識一張時序表。 時序表的命名規則為由大小寫字母、數字或底線（_）組成，且只能以字母或底線（_）開頭，長度在1~128個字元之間。 重要 時序表的名稱不能與當前已存在的資料表、二級索引表和時序表的名稱相同。
   資料生命週期	時序表中資料的到期時間，單位為秒。當系統判斷目前時間減去使用者傳入資料列的時間已經超過設定的資料生命週期時，系統會自動清理超過資料生命週期的資料。 重要 在時序表中，系統判斷資料產生時間以使用者傳入的時間列為準，並非資料寫入表中的時間。 取值必須大於等於86400秒（一天）或者必須為-1（資料永不到期）。

5. 單擊確定。

   時序表建立完成後，在時序表列表頁簽，您可以查看已建立的時序表。如果建立的表未顯示在列表中，可單擊表徵圖，重新整理時序表列表。

建立時序表後，請根據實際需要執行相應操作管理時序表。

通過命令列工具執行create命令建立時序表。更多資訊，請參見建立表。

以下樣本用於建立名稱為mytable的時序表，表中資料永不到期。

create -m timeseries -t mytable --ttl -1

執行表操作前，您需要執行use命令選擇要使用的表。更多資訊，請參見使用表。

以下樣本用於使用mytable時序表。

use --ts -t mytable

建立並使用時序表後，請根據實際需要執行相應操作管理時序表。

list -t

alter --ttl 86400 --ts

desc --ts -t mytable

drop -t mytable --ts -y

您可以使用Java SDK和Go SDK建立時序表以及管理時序表。此處以Java SDK為例介紹時序表的建立和管理。

請根據實際情境選擇合適的樣本進行時序表建立。

以下樣本用於建立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);
}

建立時序表後，請根據實際需要執行相應操作管理時序表。

private static void listTimeseriesTable(TimeseriesClient client) {
    ListTimeseriesTableResponse listTimeseriesTableResponse = client.listTimeseriesTable();
    for (String table : listTimeseriesTableResponse.getTimeseriesTableNames()) {
        System.out.println(table);
    }
}

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

private static void describeTimeseriesTable(TimeseriesClient client) {
    // 填寫時序表名稱。
    String tableName = "<TIMESERIES_TABLE>";
    DescribeTimeseriesTableResponse describeTimeseriesTableResponse = client.describeTimeseriesTable(new DescribeTimeseriesTableRequest(tableName));
    TimeseriesTableMeta tableMeta = describeTimeseriesTableResponse.getTimeseriesTableMeta();
    // 查看時序表名。
    System.out.println(tableMeta.getTimeseriesTableName()); 
    // 查看時序表狀態。
    System.out.println(tableMeta.getStatus()); 
    // 查看時序表的TTL配置。
    System.out.println(tableMeta.getTimeseriesTableOptions().getTimeToLive()); 
    // 查看時間軸表的TTL配置。
    System.out.println(tableMeta.getTimeseriesMetaOptions().getMetaTimeToLive()); 
    // 查看是否允許更新時間軸屬性列。
    System.out.println(tableMeta.getTimeseriesMetaOptions().getAllowUpdateAttributes()); 
}

private static void deleteTimeseriesTable(TimeseriesClient client) {
    // 填寫時序表名稱。
    String tableName = "<TIMESERIES_TIME>";
    DeleteTimeseriesTableRequest deleteTimeseriesTableRequest = new DeleteTimeseriesTableRequest(tableName);
    client.deleteTimeseriesTable(deleteTimeseriesTableRequest);
}