すべてのプロダクト
Search
ドキュメントセンター

Tablestore:分析ストアの作成

最終更新日:Aug 04, 2026

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)

String

時系列テーブルの名前。

analyticalStore (required)

TimeseriesAnalyticalStore

分析ストアの設定。

分析ストアの設定

analyticalStore は TimeseriesAnalyticalStore 型であり、次のパラメータが含まれます。

名前

タイプ

説明

analyticalStoreName (required)

String

分析ストアの名前。

timeToLive (optional)

int

分析ストアの TTL (秒)。デフォルト値:-1。値は -1、または 2592000 以上の int32 整数に設定します。値が -1 の場合、データは失効しません。Tablestore は、データの書き込み時刻ではなくデータカラムのタイムスタンプに基づいてデータが失効するかどうかを判断し、失効したデータを自動的に削除します。

syncOption (optional)

AnalyticalStoreSyncType

データの同期モード。デフォルト値:SYNC_TYPE_FULL。有効な値:SYNC_TYPE_FULL、SYNC_TYPE_INCR。