時系列テーブルの一覧表示 - Tablestore SDK for Java - Tablestore

Tablestore SDK for Java を使用して、インスタンス内のすべての時系列テーブルを一覧表示し、テーブル名、設定、ステータス情報を取得します。

前提条件

Tablestore SDK for Java をインストールし、時系列クライアントを初期化します。

説明

listTimeseriesTable を呼び出して、現在のインスタンス内のすべての時系列テーブルを一覧表示します。

public ListTimeseriesTableResponse listTimeseriesTable()

次の例では、時系列テーブルを一覧表示し、各テーブルの名前、ステータス、時系列データの TTL を出力します。

TimeseriesClient timeseriesClient = client.asTimeseriesClient();

ListTimeseriesTableResponse response =
        timeseriesClient.listTimeseriesTable();

for (TimeseriesTableMeta tableMeta : response.getTimeseriesTableMetas()) {
    System.out.println(tableMeta.getTimeseriesTableName());
    System.out.println(tableMeta.getStatus());
    System.out.println(tableMeta.getTimeseriesTableOptions().getTimeToLive());
}

パラメーター

listTimeseriesTable メソッドは、リクエストパラメーターを受け取りません。

レスポンス

ListTimeseriesTableResponse には、次の操作固有のフィールドが含まれます。

フィールド	タイプ	説明
`timeseriesTableMetas`	`List<TimeseriesTableMeta>`	`getTimeseriesTableMetas()` を呼び出して、時系列テーブルのリストを取得します。テーブル名のみを取得するには、`getTimeseriesTableNames()` を呼び出します。

時系列テーブル情報

timeseriesTableMetas[] の各要素は TimeseriesTableMeta 型で、次のフィールドが含まれます。

フィールド	タイプ	説明
`timeseriesTableName`	`String`	`getTimeseriesTableName()` を呼び出して、時系列テーブル名を取得します。
`timeseriesTableOptions`	`TimeseriesTableOptions`	`getTimeseriesTableOptions()` を呼び出して、時系列データの設定を取得します。
`timeseriesMetaOptions`	`TimeseriesMetaOptions`	`getTimeseriesMetaOptions()` を呼び出して、時系列メタデータの設定を取得します。
`status`	`String`	`getStatus()` を呼び出して、時系列テーブルのステータスを取得します。
`timeseriesKeys`	`List<String>`	`getTimeseriesKeys()` を呼び出して、カスタム時系列識別子フィールドを取得します。カスタムフィールドが設定されていない場合は、空のリストが返されます。
`fieldPrimaryKeys`	`List<PrimaryKeySchema>`	`getFieldPrimaryKeys()` を呼び出して、プライマリキーとして使用されるデータフィールドを取得します。データフィールドのプライマリキーが設定されていない場合は、空のリストが返されます。

時系列データ設定

timeseriesTableMetas[].timeseriesTableOptions は TimeseriesTableOptions 型で、次のフィールドが含まれます。

フィールド	タイプ	説明
`timeToLive`	`int`	`getTimeToLive()` を呼び出して、時系列データの TTL を秒単位で取得します。値が `-1` の場合、データは有効期限が切れません。

時系列メタデータ設定

timeseriesTableMetas[].timeseriesMetaOptions は TimeseriesMetaOptions 型で、次のフィールドが含まれます。

フィールド	タイプ	説明
`metaTimeToLive`	`int`	`getMetaTimeToLive()` を呼び出して、時系列メタデータの TTL を秒単位で取得します。値が `-1` の場合、メタデータは有効期限が切れません。
`allowUpdateAttributes`	`boolean`	`getAllowUpdateAttributes()` を呼び出して、メタデータ属性の列を更新できるかどうかを確認します。

データフィールドプライマリキー

timeseriesTableMetas[].fieldPrimaryKeys[] の各要素は PrimaryKeySchema 型で、次のフィールドが含まれます。

フィールド	タイプ	説明
`name`	`String`	`getName()` を呼び出して、データフィールドの名前を取得します。
`type`	`PrimaryKeyType`	`getType()` を呼び出して、データフィールドのタイプを取得します。有効な値は `INTEGER` と `STRING` です。