All Products
Search
Document Center

Tablestore:Perbarui deret waktu

Last Updated:Sep 21, 2026

Anda dapat memanggil operasi UpdateTimeseriesMeta untuk melakukan Pembaruan batch terhadap atribut metadata deret waktu. Satu panggilan UpdateTimeseriesMeta mendukung pembaruan metadata dari beberapa deret waktu. Jika metadata deret waktu yang ingin Anda perbarui belum ada, sistem akan membuatnya secara otomatis.

Prasyarat

Client telah diinisialisasi. Untuk informasi selengkapnya, lihat Initialize a Tablestore client.

Parameter

Parameter timeseriesMeta menentukan metadata dari sebuah deret waktu. Setiap parameter timeseriesMeta terdiri atas timeseriesKey dan attributes. Tabel berikut menjelaskan parameter tersebut.

Parameter

Wajib

Deskripsi

timeseriesKey

Ya

Pengenal deret waktu, yang mencakup item-item berikut:

  • measurementName: nama metrik dari deret waktu.

  • dataSource: sumber data dari deret waktu. Parameter ini boleh dikosongkan.

  • tags: tag dari deret waktu. Nilainya berupa pasangan kunci-nilai bertipe STRING.

Penting

Jika Anda tidak yakin dengan pengenal deret waktu, seperti nama metrik atau sumber data, panggil operasi QueryTimeseriesMeta untuk mengambil deret waktu berdasarkan kondisi filter. Untuk informasi selengkapnya, lihat Retrieve time series.

attributes

Ya

Atribut dari deret waktu. Nilainya terdiri atas satu atau beberapa pasangan kunci-nilai bertipe String.

Contoh

Kode contoh berikut menunjukkan cara memperbarui informasi atribut deret waktu:

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!")
}

Referensi

Untuk melihat atribut deret waktu yang telah diperbarui, Anda dapat mengambil deret waktu tersebut. Untuk informasi selengkapnya, lihat Retrieve time series.