All Products
Search
Document Center

Tablestore:Hapus metadata deret waktu

Last Updated:Aug 04, 2026

Gunakan Tablestore SDK for Java untuk menghapus beberapa entri metadata deret waktu dan memperoleh informasi kesalahan untuk entri yang gagal. Penghapusan metadata tidak menghapus data deret waktu yang terkait.

Prasyarat

Pasang Tablestore SDK for Java dan inisialisasi klien deret waktu.

Deskripsi

Panggil metode deleteTimeseriesMeta untuk menghapus beberapa entri metadata deret waktu dengan menentukan pengenal deret waktu lengkapnya. Operasi ini hanya menghapus catatan dari indeks metadata dan tidak menghapus data yang telah tersimpan dalam deret waktu tersebut.

public DeleteTimeseriesMetaResponse deleteTimeseriesMeta(DeleteTimeseriesMetaRequest request) throws TableStoreException, ClientException

Contoh berikut menghapus metadata deret waktu tertentu dari tabel example_timeseries_table dan memeriksa entri yang gagal.

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());
}

Parameter

DeleteTimeseriesMetaRequest mencakup parameter berikut.

Name

Type

Description

timeseriesTableName (required)

String

Nama tabel deret waktu.

timeseriesKeys (required)

List<TimeseriesKey>

Daftar tidak kosong berisi pengenal entri metadata deret waktu yang akan dihapus. Anda dapat menghapus beberapa entri dalam satu permintaan.

Pengenal deret waktu

Setiap elemen dalam array timeseriesKeys[] bertipe TimeseriesKey dan mencakup parameter berikut.

Name

Type

Description

measurementName (required)

String

Nama ukuran. Tablestore SDK for Java versi 5.17.2 dan yang lebih baru mengizinkan parameter ini dikosongkan.

dataSource (optional)

String

Pengenal sumber data, yang boleh dikosongkan.

tags (optional)

SortedMap<String, String>

Tag dalam bentuk pasangan kunci-nilai string. Jika parameter ini tidak ditentukan, digunakan map kosong. Pengenal deret waktu lengkap harus sesuai dengan entri metadata target.

Respons

DeleteTimeseriesMetaResponse mencakup bidang spesifik operasi berikut.

Field

Type

Description

failedRows

List<DeleteTimeseriesMetaResponse.FailedRowResult>

Panggil getFailedRows() untuk mendapatkan entri metadata yang gagal dihapus. Daftar kosong menandakan bahwa semua entri berhasil dihapus. Anda juga dapat memanggil isAllSuccess() untuk memeriksa apakah semua entri telah dihapus.

Informasi entri yang gagal

Setiap elemen dalam array failedRows[] bertipe DeleteTimeseriesMetaResponse.FailedRowResult dan mencakup bidang berikut.

Field

Type

Description

index

int

Panggil getIndex() untuk mendapatkan indeks entri metadata yang gagal dalam daftar timeseriesKeys pada permintaan.

error

Error

Panggil getError() untuk mendapatkan alasan kegagalan.