Todos os produtos
Search
Central de documentação

Tablestore:Excluir metadados de séries temporais

Última atualização: Aug 03, 2026

Use o Tablestore SDK for Java para excluir várias entradas de metadados de séries temporais e obter erros das entradas com falha. A exclusão de metadados não remove os dados correspondentes da série temporal.

Pré-requisitos

Instale o Tablestore SDK for Java e inicialize um cliente de séries temporais.

Descrição

Chame deleteTimeseriesMeta para exclua várias entradas de metadados de séries temporais especificando seus identificadores completos. Essa operação remove registros apenas do índice de metadados e não exclui os dados existentes na série temporal.

public DeleteTimeseriesMetaResponse deleteTimeseriesMeta(DeleteTimeseriesMetaRequest request) throws TableStoreException, ClientException

O exemplo a seguir exclui os metadados da série temporal especificada em example_timeseries_table e verifica as entradas com falha.

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

Parâmetros

DeleteTimeseriesMetaRequest contém os seguintes parâmetros:

Nome

Tipo

Descrição

timeseriesTableName (obrigatório)

String

Nome da tabela de séries temporais.

timeseriesKeys (obrigatório)

List<TimeseriesKey>

Lista não vazia de identificadores das entradas de metadados de séries temporais a excluir. Você pode excluir várias entradas em uma única solicitação.

Identificadores de séries temporais

Cada elemento em timeseriesKeys[] é do tipo TimeseriesKey e contém os seguintes parâmetros:

Nome

Tipo

Descrição

measurementName (obrigatório)

String

Nome da medição. O Tablestore SDK for Java 5.17.2 e versões posteriores permitem que este parâmetro esteja vazio.

dataSource (opcional)

String

Identificador da fonte de dados. Pode estar vazio.

tags (opcional)

SortedMap<String, String>

Tags como pares chave-valor de string. Se este parâmetro não for especificado, um mapa vazio será usado. Os identificadores completos da série temporal devem corresponder à entrada de metadados de destino.

Resposta

DeleteTimeseriesMetaResponse contém o seguinte campo específico da operação:

Campo

Tipo

Descrição

failedRows

List<DeleteTimeseriesMetaResponse.FailedRowResult>

Chame getFailedRows() para obter as entradas de metadados cuja exclusão falhou. Uma lista vazia indica que todas as entradas foram excluídas. Você também pode chamar isAllSuccess() para verificar se todas as entradas foram excluídas com êxito.

Informações sobre entradas com falha

Cada elemento em failedRows[] é do tipo DeleteTimeseriesMetaResponse.FailedRowResult e contém os seguintes campos:

Campo

Tipo

Descrição

index

int

Chame getIndex() para obter o índice da entrada de metadados com falha na lista timeseriesKeys da solicitação.

error

Error

Chame getError() para obter o motivo da falha.