すべてのプロダクト
Search
ドキュメントセンター

Tablestore:時系列テーブルの操作

最終更新日:Jun 09, 2026

CLI を使用して、時系列モデルのテーブルを作成、一覧表示、選択、詳細表示、更新、削除します。

前提条件

  • アクセス認証情報が設定された CLI がインストールされていること。詳細については、「Tablestore CLI」をご参照ください。

  • Tablestore インスタンスが作成されていること。詳細については、「インスタンスの操作」をご参照ください。

時系列テーブルの作成

Time-to-Live (TTL) 設定をオプションで指定して、時系列テーブルを作成します。

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

パラメーター

必須

説明

-m, --model

はい

テーブルタイプ。時系列テーブルを作成する場合は、このパラメーターを timeseries に設定します。

-t, --table

はい

時系列テーブルの名前。

--ttl

いいえ

時系列テーブル内のデータの TTL (秒単位)。デフォルト値: -1 (データは有効期限切れになりません)。有効な値: 86400 (1 日) 以上の整数、または -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

時系列テーブルの更新

時系列テーブルの TTL を更新します。

alter -t <tableName> --ttl <timeToLive> --ts

パラメーター

必須

説明

--ts

はい

時系列テーブルを操作対象とします。

--ttl

はい

時系列テーブル内のデータの TTL (秒単位)。有効な値: 86400 (1 日) 以上の整数、または -1 (データは有効期限切れになりません)。

重要

データの有効期限は、書き込み時刻ではなく、指定したタイムスタンプ列から計算されます。

時系列テーブル mytable の TTL を 86400 秒 (1 日) に設定します。

alter -t mytable --ttl 86400 --ts

時系列テーブルの削除

時系列テーブルとそのすべてのデータを削除します。

drop -t <tableName> --ts -y

パラメーター

必須

説明

-t, --table

はい

時系列テーブルの名前。

--ts

はい

時系列テーブルを操作対象とします。

-y, --yes

はい

削除確認プロンプトをスキップします。

時系列テーブル mytable を削除します。

drop -t mytable --ts -y