時系列テーブルに対する Tablestore CLI の操作の使用 - - Alibaba Cloud ドキュメントセンター

このトピックでは、Tablestore CLI を使用して時系列テーブルに対する操作を実行する方法について説明します。たとえば、Tablestore CLI を使用して、時系列テーブルの作成、使用、更新、削除を行うことができます。また、Tablestore CLI を使用して、時系列テーブルに関する情報を表示したり、時系列テーブルの名前をクエリしたりすることもできます。

説明

TimeSeries モデルの詳細については、概要を参照してください。

時系列テーブルの作成

有効期限 (TTL) 値が指定された時系列テーブルを作成します。

コマンド構文

create -m mode -t tableName --ttl timeToLive

次の表は、時系列テーブルを作成するために構成できるパラメーターを示しています。

パラメーター	必須	例	説明
-m, --model	はい	timeseries	作成するテーブルのタイプ。デフォルト値: widecolumn。有効な値: widecolumn: データテーブル。 timeseries: 時系列テーブル。
-t, --table	はい	mytable	時系列テーブルの名前。
--ttl	いいえ	864000	時系列テーブル内のデータの TTL。単位: 秒。デフォルト値は -1 で、データが期限切れにならないことを指定します。システムが、現在の時刻とテーブルに渡された時間列の差が指定された TTL 値を超えていることを検出した場合、システムは期限切れのデータを自動的に削除します。重要時系列テーブルでは、システムは、データがテーブルに書き込まれた時刻ではなく、テーブルに渡された時間列に基づいて、データが生成された時刻を決定します。このパラメーターの値は、-1、または 86400 (1 日) 以上である必要があります。値 -1 は、データが期限切れにならないことを指定します。

例

データが期限切れにならない mytable という名前の時系列テーブルを作成します。

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

時系列テーブルの使用

テーブル操作またはデータ操作を実行するテーブルを選択します。

コマンド構文

use --ts -t tableName

次の表は、時系列テーブルを使用するために構成する必要があるパラメーターを示しています。

パラメーター	必須	例	説明
--ts	はい	N/A	使用するテーブルが時系列テーブルであることを指定します。
-t, --table	はい	mytable	時系列テーブルの名前。

例

mytable という名前の時系列テーブルを使用します。

use --ts -t mytable

時系列テーブルの更新

時系列テーブルの TTL 構成を変更します。

コマンド構文

alter --ttl timeToLive --ts

次の表は、時系列テーブルを更新するために構成する必要があるパラメーターを示しています。

パラメーター

必須

例

説明

--ts

はい

N/A

TTL 構成を変更するテーブルが時系列テーブルであることを指定します。

--ttl

はい

864000

時系列テーブル内のデータの TTL。単位: 秒。デフォルト値は -1 で、データが期限切れにならないことを指定します。

システムが、現在の時刻とテーブルに渡された時間列の差が指定された TTL 値を超えていることを検出した場合、システムは期限切れのデータを自動的に削除します。

重要

時系列テーブルでは、システムは、データがテーブルに書き込まれた時刻ではなく、テーブルに渡された時間列に基づいて、データが生成された時刻を決定します。

このパラメーターの値は、-1、または 86400 (1 日) 以上である必要があります。値 -1 は、データが期限切れにならないことを指定します。

例

現在のテーブルの TTL 値を 86400 秒に設定します。

alter --ttl 86400 --ts

時系列テーブルに関する情報のクエリ

時系列テーブルに関する情報をクエリします。

コマンド構文

desc --ts -t tableName

次の表は、時系列テーブルに関する情報をクエリするために構成できるパラメーターを示しています。

パラメーター	必須	例	説明
--ts	いいえ	N/A	情報をクエリするテーブルが時系列テーブルであることを指定します。
-t,--table	いいえ	mytable	時系列テーブルの名前。このパラメーターは省略可能です。
-f,--print_format	いいえ	json	テーブル情報の出力形式。デフォルト値: json。有効な値: json および table。
-o, --output	いいえ	/tmp/describe_table_meta.json	時系列テーブルに関する情報が格納されているローカル JSON ファイルのパス。

例

現在のテーブルに関する情報をクエリします。

desc

mytable という名前の時系列テーブルに関する情報をクエリします。

desc --ts -t mytable

時系列テーブルの削除

不要になった時系列テーブルを削除します。

コマンド構文

drop -t tableName --ts -y

次の表は、時系列テーブルを削除するために構成する必要があるパラメーターを示しています。

パラメーター	必須	例	説明
-t, --table	はい	mytable	時系列テーブルの名前。
-y, --yes	はい	N/A	確認情報が表示されることを指定します。このパラメーターは必須です。
--ts	はい	N/A	削除するテーブルが時系列テーブルであることを指定します。

例

mytable という名前の時系列テーブルを削除します。

drop -t mytable --ts -y

テーブル名のリスト

インスタンス内のすべてのテーブル、すべてのデータテーブル、またはすべての時系列テーブルの名前をリストします。

コマンド構文

list

パラメーター

パラメーター	必須	例	説明
-a, --all	いいえ	N/A	すべてのテーブルの名前をリストします。
-d, --detail	いいえ	N/A	テーブルの詳細をリストします。
-w, --wc	いいえ	N/A	すべてのデータテーブルの名前をリストします。
-t, --ts	いいえ	N/A	すべての時系列テーブルの名前をリストします。

例

現在のテーブルと同じタイプのすべてのテーブルの名前をリストします
```
list
```
すべてのテーブルの名前をリストします
```
list -a
```
すべてのデータテーブルの名前をリストします
```
list -w
```
すべての時系列テーブルの名前をリストします
```
list -t
```