Java SDK を使用してラストポイントインデックスを作成する - Tablestore

ラストポイントインデックスを使用すると、各時系列の最新の時点データをすばやく取得できます。 CreateTimeseriesLastpointIndex 操作を使用して、時系列テーブルのラストポイントインデックスを作成できます。ラストポイントインデックスを作成する際は、時系列テーブル名とラストポイントインデックス名を設定する必要があります。時系列テーブルの既存データを含めるかどうかをラストポイントインデックスに指定することもできます。

説明

時系列テーブルの作成時にラストポイントインデックスを設定することもできます。詳細については、「時系列テーブルの作成」をご参照ください。

使用上の注意

Tablestore Java SDK は、バージョン 5.17.1 以降でラストポイントインデックス機能をサポートしています。この機能を使用する場合は、正しい Java SDK バージョンを取得していることを確認してください。 Java SDK の過去のバージョンについては、「Java SDK の過去のバージョン」をご参照ください。
ラストポイントインデックスを作成した後、時系列テーブルにデータが書き込まれると、Tablestore は時系列テーブル内の時系列の最新の時点データを非同期的にラストポイントインデックスに自動的に同期します。通常の状況では、同期遅延はミリ秒レベルです。
データがラストポイントインデックステーブルに同期されると、ラストポイントインデックステーブルには、時系列に対して Tablestore によって生成されたパーティションキー (_#h フィールド)、時系列識別子、および時系列の最新の時点データが含まれます。
ラストポイントインデックスの作成には料金はかかりません。ラストポイントインデックスへのデータ保存とインデックスからのデータ読み取りに対して料金が発生します。詳細については、「時系列モデルの課金」をご参照ください。
SQL クエリまたは多次元インデックス機能を使用してラストポイントインデックスのデータをクエリする場合、SQL クエリと多次元インデックスにも料金が発生します。料金は、対応する機能の課金ルールに基づいて計算されます。詳細については、「SQL クエリの課金」および「多次元インデックスの課金」をご参照ください。
時系列テーブルのラストポイントインデックスと分析ストアの合計数は 10 を超えることはできません。

前提条件

ラストポイントインデックスをサポートするリージョンに時系列モデルインスタンスを作成済みであること。詳細については、「時系列モデルインスタンスの作成」をご参照ください。
TimeseriesClient インスタンスが初期化されていること。詳細については、「Tablestore クライアントの初期化」をご参照ください。

パラメーター

パラメーター	必須	説明
timeseriesTableName	はい	時系列テーブルの名前。
lastpointIndexName	はい	ラストポイントインデックスの名前。
includeBaseData	いいえ	既存データを含めるかどうかを指定します。タイプはブール値です。パラメーターの有効な値: true: 既存データが含まれます。 false (デフォルト): 既存データは含まれません。

例

次の例は、timeseries_table という名前の時系列テーブルに last_point_index という名前のラストポイントインデックスを作成する方法を示しています。インデックスには既存データが含まれます。

public void createTimeseriesLastpointIndex(TimeseriesClient client) {
    CreateTimeseriesLastpointIndexRequest request =
            new CreateTimeseriesLastpointIndexRequest("timeseries_table", "last_point_index", true);
    client.createTimeseriesLastpointIndex(request);
}

Tablestore:ラストポイントインデックスの作成

使用上の注意

前提条件

パラメーター

例

関連情報