時系列テーブル情報のクエリ - Java 版 Tablestore SDK - Tablestore

Java 版 Tablestore SDK を使用して、時系列テーブルの設定とステータス (TTL、カスタム時系列識別子フィールド、データフィールドプライマリキー、分析ストア、Lastpoint インデックスなど) をクエリします。

前提条件

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

説明

describeTimeseriesTable を呼び出して、時系列テーブルの設定とステータスをクエリします。応答には、分析ストアと Lastpoint インデックスのリストも含まれます。対応するリソースが設定されていない場合、空のリストが返されます。

public DescribeTimeseriesTableResponse describeTimeseriesTable(DescribeTimeseriesTableRequest request)

次の例では、example_timeseries_table の設定とステータスをクエリし、分析ストアと Lastpoint インデックスの情報を読み取ります。

TimeseriesClient timeseriesClient = client.asTimeseriesClient();

String tableName = "example_timeseries_table";
DescribeTimeseriesTableRequest request =
        new DescribeTimeseriesTableRequest(tableName);
DescribeTimeseriesTableResponse response =
        timeseriesClient.describeTimeseriesTable(request);

TimeseriesTableMeta tableMeta = response.getTimeseriesTableMeta();
System.out.println(tableMeta.getTimeseriesTableName());
System.out.println(tableMeta.getStatus());
System.out.println(tableMeta.getTimeseriesTableOptions().getTimeToLive());
System.out.println(tableMeta.getTimeseriesMetaOptions().getMetaTimeToLive());
System.out.println(tableMeta.getTimeseriesMetaOptions().getAllowUpdateAttributes());

for (TimeseriesAnalyticalStore store : response.getAnalyticalStores()) {
    System.out.println(store.getAnalyticalStoreName());
    System.out.println(store.getTimeToLive());
    System.out.println(store.getSyncOption());
}

for (TimeseriesLastpointIndex index : response.getLastpointIndexes()) {
    System.out.println(index.getLastpointIndexName());
}

パラメーター

DescribeTimeseriesTableRequest には、次のパラメーターが含まれます。

名前	型	説明
timeseriesTableName (必須)	`String`	時系列テーブル名。

応答

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

フィールド	型	説明
`timeseriesTableMeta`	`TimeseriesTableMeta`	`getTimeseriesTableMeta()` を呼び出して、時系列テーブルの設定とステータスを取得します。
`analyticalStores`	`List<TimeseriesAnalyticalStore>`	`getAnalyticalStores()` を呼び出して、分析ストアを取得します。分析ストアが作成されていない場合、空のリストが返されます。
`lastpointIndexes`	`List<TimeseriesLastpointIndex>`	`getLastpointIndexes()` を呼び出して、Lastpoint インデックスを取得します。 Lastpoint インデックスが作成されていない場合、空のリストが返されます。

時系列テーブル情報

timeseriesTableMeta は TimeseriesTableMeta 型で、次のフィールドが含まれます。

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

時系列データ設定

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

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

時系列メタデータ設定

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

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

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

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

フィールド	型	説明
`name`	`String`	`getName()` を呼び出して、データフィールド名を取得します。
`type`	`PrimaryKeyType`	`getType()` を呼び出して、データフィールドの型を取得します。有効な値： `INTEGER` および `STRING`。

分析ストア

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

フィールド	型	説明
`analyticalStoreName`	`String`	`getAnalyticalStoreName()` を呼び出して、分析ストア名を取得します。
`timeToLive`	`int`	`getTimeToLive()` を呼び出して、分析ストア内のデータの TTL を秒単位で取得します。値が `-1` の場合、データは有効期限が切れないことを示します。
`syncOption`	`AnalyticalStoreSyncType`	`getSyncOption()` を呼び出して、データ同期方式を取得します。

Lastpoint インデックス

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

フィールド	型	説明
`lastpointIndexName`	`String`	`getLastpointIndexName()` を呼び出して、Lastpoint インデックス名を取得します。