Tablestore SDK for Java を使用して、既存の時系列テーブルに分析ストアを作成し、時系列データをコスト効率よく長期保存して分析します。
前提条件
Tablestore SDK for Java をインストールし、時系列モデルのクライアントを初期化します。分析ストアの操作には Tablestore SDK for Java 5.15.0 以降が必要です。最新バージョンの使用を推奨します。
分析ストアをサポートするリージョンで時系列モデルのインスタンスを作成します。サポートされているリージョンと機能の詳細については、「分析ストア」をご参照ください。
機能の説明
createTimeseriesAnalyticalStore メソッドを呼び出して、既存の時系列テーブルに分析ストアを作成します。分析ストアは、時系列テーブルからデータを自動的に同期します。TTL は時系列テーブルの TTL とは独立しており、分析ストアに対するクエリは時系列テーブルの読み取りや書き込みに影響しません。
public CreateTimeseriesAnalyticalStoreResponse createTimeseriesAnalyticalStore(CreateTimeseriesAnalyticalStoreRequest request) throws TableStoreException, ClientException
分析ストアの作成時に、次のいずれかの同期モードを使用できます:
SYNC_TYPE_FULL:完全同期。既存データと、分析ストアの作成後に書き込まれたデータを同期します。デフォルトのモードです。SYNC_TYPE_INCR:増分同期。分析ストアの作成後に書き込まれたデータのみを同期します。
分析ストアの作成後は同期モードを変更できません。既存データを分析する必要があるかどうかに基づいてモードを選択してください。
1 つの時系列テーブルに作成できる分析ストアは 1 つだけです。時系列テーブルには、Lastpoint インデックスと分析ストアを合わせて最大 10 個まで作成できます。
次のサンプルコードは、example_timeseries_table テーブルに、example_analytical_store という名前の分析ストアを作成します。分析ストア内のデータは失効せず、完全同期を使用します。
TimeseriesClient timeseriesClient = client.asTimeseriesClient();
TimeseriesAnalyticalStore analyticalStore =
new TimeseriesAnalyticalStore("example_analytical_store");
analyticalStore.setTimeToLive(-1);
analyticalStore.setSyncOption(AnalyticalStoreSyncType.SYNC_TYPE_FULL);
CreateTimeseriesAnalyticalStoreRequest request =
new CreateTimeseriesAnalyticalStoreRequest(
"example_timeseries_table", analyticalStore);
timeseriesClient.createTimeseriesAnalyticalStore(request);
分析ストアの作成後、データはバックグラウンドで同期されます。describeTimeseriesAnalyticalStore を呼び出して同期ステータスを確認できます。詳細については、「分析ストア情報の照会」をご参照ください。
パラメータ
CreateTimeseriesAnalyticalStoreRequest には、次のパラメータが含まれます。
|
名前 |
タイプ |
説明 |
|
timeseriesTableName (required) |
|
時系列テーブルの名前。 |
|
analyticalStore (required) |
|
分析ストアの設定。 |
分析ストアの設定
analyticalStore は TimeseriesAnalyticalStore 型であり、次のパラメータが含まれます。
|
名前 |
タイプ |
説明 |
|
analyticalStoreName (required) |
|
分析ストアの名前。 |
|
timeToLive (optional) |
|
分析ストアの TTL (秒)。デフォルト値: |
|
syncOption (optional) |
|
データの同期モード。デフォルト値: |