ラストポイントインデックスを使用すると、各時系列の最新の時点データをすばやく取得できます。 CreateTimeseriesLastpointIndex 操作を使用して、時系列テーブルのラストポイントインデックスを作成できます。 ラストポイントインデックスを作成する際は、時系列テーブル名とラストポイントインデックス名を構成する必要があります。 時系列テーブルの既存データ をラストポイントインデックスに含めるかどうかを指定することもできます。
時系列テーブルの作成時にラストポイントインデックスを構成することもできます。 詳細については、「時系列テーブルの作成」をご参照ください。
使用上の注意
Tablestore Go SDK は、バージョン v1.7.15 以降でラストポイントインデックス機能をサポートしています。 この機能を使用する場合は、正しい Go SDK バージョンを取得していることを確認してください。
ラストポイントインデックスを作成した後、時系列テーブルにデータが書き込まれると、Tablestore は時系列の最新の時点データ をラストポイントインデックスに 非同期的に自動的に同期します。 通常の状況では、同期遅延 はミリ秒レベルです。
データがラストポイントインデックステーブルに同期されると、ラストポイントインデックステーブルには、時系列用に Tablestore によって生成された パーティションキー (
_#h
フィールド)、時系列識別子、および時系列の最新の時点データが含まれます。ラストポイントインデックスの作成には料金はかかりません。 ラストポイントインデックスへのデータストレージとインデックスからのデータ読み取りに対して料金が発生します。 詳細については、「時系列モデルの課金」をご参照ください。
SQL クエリまたは 多次元インデックスを使用してラストポイントインデックスのデータをクエリする場合、対応する 特徴 の課金ルールに基づいて、SQL クエリと 多次元インデックスにも料金が発生します。 詳細については、「SQL クエリの課金」および「 多次元インデックスの課金」をご参照ください。
時系列テーブルのラストポイントインデックスと分析ストアの合計数は 10 を超えることはできません。
前提条件
ラストポイントインデックスをサポートする リージョン に時系列モデル インスタンス を作成済みであること。 詳細については、「時系列モデルインスタンスの作成」をご参照ください。
TimeseriesClient インスタンスが初期化されていること。 詳細については、「Tablestore クライアントの初期化」をご参照ください。
パラメーター
パラメーター | 必須 | 説明 |
timeseriesTableName | はい | 時系列テーブルの名前。 |
lastpointIndexName | はい | ラストポイントインデックスの名前。 |
includeBaseData | いいえ | 既存データ を含めるかどうかを指定します。 タイプは ブール値 です。 パラメーターの有効な値:
|
例
次の例は、timeseries_table という名前の時系列テーブルに last_point_index という名前のラストポイントインデックスを作成する方法を示しています。 インデックスには 既存データ が含まれます。
func createTimeseriesLastpointIndex(client *tablestore.TimeseriesClient) {
request := tablestore.NewCreateTimeseriesLastpointIndexRequest("test_timeseries_table", "last_point_index", true) // 時系列テーブル "test_timeseries_table" に、既存データを含めた "last_point_index" というラストポイントインデックスを作成するリクエストを作成
_, err := client.CreateTimeseriesLastpointIndex(request) // リクエストを送信
if err != nil {
log.Fatal(err) // エラーが発生した場合はログに出力して終了
}
}
関連情報
ラストポイントインデックスを作成した後、次の メソッド を使用してラストポイントインデックスからデータを読み取ることができます。
データテーブルのデータ読み取り 操作 を使用してデータを読み取ります。 詳細については、「データの読み取り」をご参照ください。
ラストポイントインデックスの 多次元インデックス を作成し、 多次元インデックス クエリ機能を使用してデータを読み取ります。
ラストポイントインデックスのSQL マッピング 関係を作成し、SELECT 文 を使用してデータを読み取ります。
ラストポイントインデックスが不要になった場合は、削除できます。 詳細については、「ラストポイントインデックスの削除」をご参照ください。