Tablestore SDK for Java を使用して、時系列データとメタデータの Time-to-Live (TTL) を更新し、メタデータ属性列の更新可否を指定します。
前提条件
Tablestore SDK for Java をインストールし、時系列クライアントを初期化します。
説明
updateTimeseriesTable API を呼び出して、時系列テーブルの設定を更新します。各リクエストでは、時系列データの設定またはメタデータの設定のいずれかを更新できますが、両方を同時に更新することはできません。
public UpdateTimeseriesTableResponse updateTimeseriesTable(UpdateTimeseriesTableRequest request)
次の例では、example_timeseries_table の時系列データの Time-to-Live (TTL) を 3 年に更新します。
TimeseriesClient timeseriesClient = client.asTimeseriesClient();
String tableName = "example_timeseries_table";
UpdateTimeseriesTableRequest request =
new UpdateTimeseriesTableRequest(tableName);
request.setTimeseriesTableOptions(
new TimeseriesTableOptions(86400 * 365 * 3));
timeseriesClient.updateTimeseriesTable(request);
パラメーター
UpdateTimeseriesTableRequest には、次のパラメーターが含まれています。
|
名前 |
型 |
説明 |
|
timeseriesTableName (必須) |
|
設定を更新する時系列テーブルの名前。 |
|
timeseriesTableOptions (任意) |
|
時系列データの設定。 |
|
timeseriesMetaOptions (任意) |
|
時系列メタデータの設定。 |
時系列データの設定
timeseriesTableOptions は TimeseriesTableOptions 型で、次のパラメーターが含まれています。
|
名前 |
型 |
説明 |
|
timeToLive (必須) |
|
時系列データの Time-to-Live (TTL) (秒単位)。値を Tablestore は失効したデータを自動的に削除します。 メタデータの Time-to-Live (TTL) が |
時系列メタデータの設定
timeseriesMetaOptions は TimeseriesMetaOptions 型です。 次のパラメーターの少なくとも 1 つを指定します。 省略されたパラメーターは現在の値を保持します。
|
名前 |
型 |
説明 |
|
metaTimeToLive (任意) |
|
時系列メタデータの Time-to-Live (TTL) (秒単位)。値を この値は、時系列データの Time-to-Live (TTL) 未満には設定できません。データの Time-to-Live (TTL) が 有限の Time-to-Live (TTL) を設定する場合は、 |
|
allowUpdateAttributes (任意) |
|
メタデータ属性列の更新可否を指定します。メタデータの Time-to-Live (TTL) が |
例
時系列メタデータの設定の更新
次の例では、時系列メタデータが失効しないように設定し、メタデータ属性列の更新を許可します。
String tableName = "example_timeseries_table";
TimeseriesMetaOptions metaOptions = new TimeseriesMetaOptions();
metaOptions.setMetaTimeToLive(-1);
metaOptions.setAllowUpdateAttributes(true);
UpdateTimeseriesTableRequest request =
new UpdateTimeseriesTableRequest(tableName);
request.setTimeseriesMetaOptions(metaOptions);
timeseriesClient.updateTimeseriesTable(request);