Todos os produtos
Search
Central de documentação

Tablestore:Atualizar séries temporais

Última atualização: Jul 03, 2026

Chame a operação UpdateTimeseriesMeta para atualizar os metadados de várias séries temporais simultaneamente. Se os metadados da série temporal que você deseja atualizar não existirem, eles serão adicionados automaticamente.

Pré-requisitos

Inicialize um cliente. Para mais informações, consulte Inicializar um cliente do Tablestore.

Parâmetros

O parâmetro timeseriesMeta especifica os metadados de uma série temporal. Cada parâmetro timeseriesMeta consiste nos parâmetros timeseriesKey e attributes. A tabela a seguir descreve esses parâmetros.

Parâmetro

Obrigatório

Descrição

timeseriesKey

Sim

Identificadores da série temporal, que incluem os seguintes itens:

  • measurementName: nome da métrica da série temporal.

  • dataSource: fonte de dados da série temporal. Este parâmetro pode ficar em branco.

  • tags: tags da série temporal. Os valores são pares chave-valor do tipo STRING.

Importante

Se você não tiver certeza sobre os identificadores da série temporal, como o nome da métrica ou a fonte de dados, chame a operação QueryTimeseriesMeta para recuperar séries temporais com base em condições de filtro. Para mais informações, consulte Recuperar séries temporais.

attributes

Sim

Atributos da série temporal. O valor consiste em um ou mais pares chave-valor do tipo String.

Exemplo

O código de exemplo a seguir mostra como atualizar as informações de atributos das séries temporais:

func UpdateTimeseriesMetaSample(tsClient *tablestore.TimeseriesClient, timeseriesTableName string) {
    fmt.Println("[Info]: Begin to update timeseries meta!")

    updateTimeseriesMetaRequest := tablestore.NewUpdateTimeseriesMetaRequest(timeseriesTableName)

    timeseriesKey := tablestore.NewTimeseriesKey()
    timeseriesKey.SetMeasurementName("NETWORK")
    timeseriesKey.SetDataSource("127.0.0.1")
    timeseriesKey.AddTag("City" , "Hangzhou")
    timeseriesKey.AddTag("Region" , "Xihu")

    timeseriesMeta := tablestore.NewTimeseriesMeta(timeseriesKey)
    //timeseriesMeta.SetUpdateTimeInUs(96400)
    timeseriesMeta.AddAttribute("NewRegion" , "Yuhang")
    timeseriesMeta.AddAttribute("NewCity" , "Shanghai")

    updateTimeseriesMetaRequest.AddTimeseriesMetas(timeseriesMeta)

    updateTimeseriesMetaResponse , err := tsClient.UpdateTimeseriesMeta(updateTimeseriesMetaRequest)
    if err != nil {
        fmt.Println("[Error]: Update timeseries meta failed with error: " , err)
        return
    }

    if len(updateTimeseriesMetaResponse.GetFailedRowResults()) > 0 {
        fmt.Println("[Error]: Update timeseries meta failed row: ")
        for i := 0; i < len(updateTimeseriesMetaResponse.GetFailedRowResults()); i++ {
            fmt.Println("[Error]: " , updateTimeseriesMetaResponse.GetFailedRowResults()[i].Index , updateTimeseriesMetaResponse.GetFailedRowResults()[i].Error)
        }
    }

    fmt.Println("[Info]: UpdateTimeseriesMetaSample finished!")
}

Referências

Para visualizar os atributos atualizados da série temporal, recupere as séries temporais. Para mais informações, consulte Recuperar séries temporais.