Atualizar metadados de séries temporais - Tablestore SDK for Java - Tablestore: Central de Documentação do Alibaba Cloud

Pré-requisitos

Instale o Tablestore SDK for Java e inicialize um cliente de séries temporais.
A tabela de séries temporais deve permitir a atualização de atributos de metadados. Caso não permita, modifique as configurações da tabela de séries temporais e defina allowUpdateAttributes como true.

Descrição

Chame updateTimeseriesMeta para atualizar os atributos de várias entradas de metadados de séries temporais. Se os metadados especificados não existirem, o servidor os adicionará automaticamente.

public UpdateTimeseriesMetaResponse updateTimeseriesMeta(UpdateTimeseriesMetaRequest request) throws TableStoreException, ClientException

Nota

Os índices de metadados de séries temporais são atualizados de forma assíncrona. Após enviar uma atualização, aguarde a atualização do índice antes de consultar os atributos mais recentes.

O exemplo a seguir atualiza o atributo status da série temporal especificada em example_timeseries_table para online 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);

Map<String, String> attributes = new HashMap<>();
attributes.put("status", "online");
TimeseriesMeta meta = new TimeseriesMeta(timeseriesKey);
meta.setAttributes(attributes);

UpdateTimeseriesMetaRequest request =
        new UpdateTimeseriesMetaRequest("example_timeseries_table");
request.setMetas(Collections.singletonList(meta));
UpdateTimeseriesMetaResponse response =
        timeseriesClient.updateTimeseriesMeta(request);

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

Parâmetros

UpdateTimeseriesMetaRequest contém os seguintes parâmetros:

Nome	Tipo	Descrição
timeseriesTableName (obrigatório)	`String`	Nome da tabela de séries temporais.
metas (obrigatório)	`List<TimeseriesMeta>`	Lista não vazia de entradas de metadados de séries temporais a atualizar. É possível atualizar várias entradas em uma única solicitação.

Metadados de séries temporais

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

Nome	Tipo	Descrição
timeseriesKey (obrigatório)	`TimeseriesKey`	Identificadores da série temporal cujos metadados serão atualizados.
attributes (opcional)	`SortedMap<String, String>`	Atributos de metadados definidos como pares chave-valor do tipo string. Se este parâmetro não for especificado ou estiver definido como um mapa vazio, o Tablestore SDK for Java não envia o conteúdo do atributo.

Nota

O campo updateTimeInUs é gerado pelo servidor e retornado durante a consulta de metadados de séries temporais. Não defina este campo em uma solicitação de atualização. Caso contrário, o Tablestore SDK for Java rejeitará a solicitação.

Identificadores de séries temporais

metas[].timeseriesKey é 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, que pode estar vazio.
tags (opcional)	`SortedMap<String, String>`	Tags representadas como pares chave-valor do tipo string. Se este parâmetro não for especificado, um mapa vazio será usado.

Resposta

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

Campo	Tipo	Descrição
`failedRows`	`List<UpdateTimeseriesMetaResponse.FailedRowResult>`	Chame `getFailedRows()` para obter as entradas de metadados cuja atualização falhou. Uma lista vazia indica que todas as entradas foram atualizadas. Você também pode chamar `isAllSuccess()` para verificar se todas as entradas foram atualizadas.

Informações sobre entradas com falha

Cada elemento em failedRows[] é do tipo UpdateTimeseriesMetaResponse.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 `metas` da solicitação.
`error`	`Error`	Chame `getError()` para obter o motivo da falha.