全部产品
Search
文档中心

Tablestore:Memperbarui deret waktu

更新时间:Jul 02, 2025

Anda dapat memanggil operasi UpdateTimeseriesMeta untuk memperbarui metadata beberapa deret waktu secara bersamaan. Jika metadata deret waktu yang ingin diperbarui tidak ada, metadata tersebut akan ditambahkan.

Prasyarat

Klien harus sudah diinisialisasi. Untuk informasi lebih lanjut, lihat Inisialisasi klien Tablestore.

Parameter

Parameter timeseriesMeta mendefinisikan metadata dari deret waktu. Setiap parameter timeseriesMeta terdiri dari parameter timeseriesKey dan attributes. Tabel berikut menjelaskan parameter-parameter tersebut.

Parameter

Diperlukan

Deskripsi

timeseriesKey

Ya

Pengenal deret waktu, yang mencakup item-item berikut:

  • measurementName: nama metrik dari deret waktu.

  • dataSource: sumber data dari deret waktu. Anda dapat membiarkan parameter ini kosong.

  • tags: tag dari deret waktu. Nilai dari parameter ini adalah pasangan kunci-nilai bertipe STRING.

Penting

Jika Anda tidak yakin tentang informasi deret waktu yang ingin Anda kueri, seperti nama metrik dan sumber data, Anda dapat memanggil operasi QueryTimeseriesMeta untuk mengambil deret waktu berdasarkan berbagai kondisi. Untuk informasi lebih lanjut, lihat Mengambil deret waktu.

attributes

Ya

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

Contoh

Berikut adalah contoh kode yang menunjukkan cara memperbarui informasi atribut deret waktu:

func UpdateTimeseriesMetaSample(tsClient *tablestore.TimeseriesClient, timeseriesTableName string) {
    fmt.Println("[Info]: Mulai memperbarui metadata deret waktu!")

    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]: Memperbarui metadata deret waktu gagal dengan kesalahan: " , err)
        return
    }

    if len(updateTimeseriesMetaResponse.GetFailedRowResults()) > 0 {
        fmt.Println("[Error]: Baris pembaruan metadata deret waktu gagal: ")
        for i := 0; i < len(updateTimeseriesMetaResponse.GetFailedRowResults()); i++ {
            fmt.Println("[Error]: " , updateTimeseriesMetaResponse.GetFailedRowResults()[i].Index , updateTimeseriesMetaResponse.GetFailedRowResults()[i].Error)
        }
    }


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

Referensi

Untuk melihat atribut deret waktu yang telah diperbarui, Anda dapat mengambil deret waktu. Untuk informasi lebih lanjut, lihat Mengambil deret waktu.