全部產品
Search
文件中心

Tablestore:時序表操作

更新時間:Jun 05, 2026

通過命令列工具建立、列出、使用、查看、更新和刪除時序模型

前提條件

  • 已完成命令列工具的安裝和訪問憑證配置。具體操作,請參見命令列工具

  • 已建立執行個體。具體操作,請參見執行個體操作

建立時序表

create -m timeseries -t <tableName> --ttl <timeToLive>

參數

必填

說明

-m, --model

表類型。建立時序表時設定為 timeseries。

-t, --table

時序表名稱。

--ttl

時序表的資料存活時間,單位為秒。預設值為 -1,表示資料永不到期。取值為大於等於 86400 秒(一天)或 -1(永不到期)。

重要

系統以使用者傳入的時間列判斷資料產生時間,並非資料寫入表中的時間。

樣本

建立名稱為 mytable 的時序表,資料永不到期。

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

列出時序表

列出當前執行個體下的所有時序表名稱。

list_table --ts

使用時序表

選擇目標時序表,後續資料操作在該表上執行。

use --ts -t <tableName>

參數

必填

說明

--ts

指定操作對象為時序表。

-t, --table

時序表名稱。

樣本

use --ts -t mytable

查看時序表資訊

desc --ts -t <tableName>

參數

必填

說明

--ts

表示操作的表為時序表。已通過use --ts選定時序表時可省略。

-t, --table

時序表名稱。已通過use選定時序表時可省略。

-f, --print_format

輸出格式。取值為 json(預設)或 table

-o, --output

將表資訊輸出為本地 JSON 檔案。

樣本

desc --ts -t mytable

更新時序表

更新時序表的資料存活時間。

alter --ttl <timeToLive> --ts

參數

必填

說明

--ts

指定操作對象為時序表。

--ttl

時序表的資料存活時間,單位為秒。取值為大於等於 86400 秒(一天)或 -1(永不到期)。

重要

系統以使用者傳入的時間列判斷資料產生時間,並非資料寫入表中的時間。

樣本

修改當前時序表的資料存活時間為 86400 秒(即 1 天)。

alter --ttl 86400 --ts

刪除時序表

drop -t <tableName> --ts -y

參數

必填

說明

-t, --table

時序表名稱。

--ts

指定操作對象為時序表。

-y, --yes

跳過刪除確認提示。

樣本

刪除 mytable 時序表。

drop -t mytable --ts -y