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

Tablestore:時系列メタデータの削除

最終更新日:Aug 04, 2026

Tablestore SDK for Java を使用すると、複数の時系列メタデータエントリを削除し、失敗したエントリのエラーを取得できます。メタデータを削除しても、対応する時系列データは削除されません。

前提条件

Tablestore SDK for Java をインストールし、時系列クライアントを初期化してください。

説明

deleteTimeseriesMeta を呼び出すことで、完全な時系列識別子を指定して複数の時系列メタデータエントリを削除できます。この操作はメタデータインデックスからのみレコードを削除し、時系列に存在するデータは削除しません。

public DeleteTimeseriesMetaResponse deleteTimeseriesMeta(DeleteTimeseriesMetaRequest request) throws TableStoreException, ClientException

次の例では、example_timeseries_table から指定された時系列のメタデータを削除し、失敗したエントリを確認します。

Map<String, String> tags = new HashMap<>();
tags.put("region", "cn-hangzhou");
tags.put("host", "host_0");
TimeseriesKey timeseriesKey =
        new TimeseriesKey("cpu", "source_0", tags);

DeleteTimeseriesMetaRequest request =
        new DeleteTimeseriesMetaRequest("example_timeseries_table");
request.setTimeseriesKeys(Collections.singletonList(timeseriesKey));
DeleteTimeseriesMetaResponse response =
        timeseriesClient.deleteTimeseriesMeta(request);

for (DeleteTimeseriesMetaResponse.FailedRowResult result : response.getFailedRows()) {
    System.out.println(result.getIndex());
    System.out.println(result.getError());
}

パラメーター

DeleteTimeseriesMetaRequest には、次のパラメーターが含まれます。

名前

タイプ

説明

timeseriesTableName (必須)

String

時系列テーブルの名前。

timeseriesKeys (必須)

List<TimeseriesKey>

削除する時系列メタデータエントリの識別子を含む空ではないリスト。 1 つのリクエストで複数のエントリを削除できます。

時系列識別子

timeseriesKeys[] の各要素は TimeseriesKey 型で、次のパラメーターが含まれます。

名前

タイプ

説明

measurementName (必須)

String

メジャメント名。 Tablestore SDK for Java 5.17.2 以降では、このパラメーターを空にすることができます。

dataSource (オプション)

String

データソース識別子。空にすることができます。

tags (オプション)

Map<String, String>

文字列のキーと値のペアであるタグ。このパラメーターが指定されていない場合は、空のマップが使用されます。完全な時系列識別子は、対象のメタデータエントリと一致する必要があります。

レスポンス

DeleteTimeseriesMetaResponse には、次の操作固有のフィールドが含まれます。

フィールド

タイプ

説明

failedRows

List<DeleteTimeseriesMetaResponse.FailedRowResult>

getFailedRows() を呼び出して、削除に失敗したメタデータエントリを取得できます。リストが空の場合は、すべてのエントリが削除されたことを示します。また、isAllSuccess() を呼び出して、すべてのエントリが削除されたかどうかを確認することもできます。

失敗したエントリの情報

failedRows[] の各要素は DeleteTimeseriesMetaResponse.FailedRowResult 型で、次のフィールドが含まれます。

フィールド

タイプ

説明

index

int

getIndex() を呼び出すと、リクエストの timeseriesKeys リストにおける失敗したメタデータエントリのインデックスを取得できます。

error

Error

getError() を呼び出すと、失敗の理由を取得できます。