ラストポイントインデックスを使用すると、各時系列の最新の時点データをすばやく取得できます。 CreateTimeseriesLastpointIndex 操作を使用して、時系列テーブルのラストポイントインデックスを作成できます。 ラストポイントインデックスを作成する際は、時系列テーブル名とラストポイントインデックス名を設定する必要があります。 時系列テーブルの既存データを含めるかどうかをラストポイントインデックスに指定することもできます。
時系列テーブルの作成時に Lastpoint インデックスを作成することもできます。詳細については、「時系列テーブルの作成」をご参照ください。
注意事項
Tablestore SDK for Go V1.7.15 以降では、Lastpoint インデックス機能がサポートされています。Lastpoint インデックス機能を使用するには、Tablestore SDK for Go V1.7.15 以降を取得してください。
時系列テーブルに Lastpoint インデックスを作成すると、時系列テーブルにデータが書き込まれた際、Tablestore は時系列テーブル内の時系列の最新データを、非同期で Lastpoint インデックスに自動的に同期します。ほとんどの場合、同期の遅延はミリ秒単位です。
データが Lastpoint インデックスに同期されると、Lastpoint インデックスには、Tablestore が時系列用に生成したパーティションキー (
_#hフィールド) 、時系列識別子、および時系列の最新データが含まれます。Lastpoint インデックスの作成には課金されません。Lastpoint インデックスのストレージ使用量と、Lastpoint インデックスからのデータ読み取り時に課金されます。詳細については、「TimeSeries モデルの課金項目」をご参照ください。
SQL ステートメントの実行または検索インデックスを使用して Lastpoint インデックス内のデータをクエリまたは取得する場合、それぞれの機能の課金ルールに従って、SQL クエリまたは検索インデックス関連の料金が発生します。詳細については、「SQL クエリの課金項目」および「検索インデックスの課金項目」をご参照ください。
1 つの時系列テーブルに作成できる Lastpoint インデックスと分析ストアの合計数は、10 を超えることはできません。
前提条件
Lastpoint インデックス機能をサポートするリージョンで、TimeSeries モデル用のインスタンスが作成されている必要があります。詳細については、「TimeSeries モデル用インスタンスの作成」をご参照ください。
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)
_, err := client.CreateTimeseriesLastpointIndex(request)
if err != nil {
log.Fatal(err)
}
}関連ドキュメント
Lastpoint インデックスを作成した後、次の方法で Lastpoint インデックスからデータを読み取ることができます。
データテーブルのデータ読み取り操作でデータを読み取ります。詳細については、「データの読み取り」をご参照ください。
Lastpoint インデックスに検索インデックスを作成し、検索インデックスのクエリ機能を使用してデータを読み取ります。
Lastpoint インデックスに SQL マッピングテーブルを作成し、SELECT ステートメントを実行してデータを読み取ります。
Lastpoint インデックスが不要になった場合は、削除できます。詳細については、「Lastpoint インデックスの削除」をご参照ください。