Go SDK for Tablestore を使用して時系列メタデータの複数の属性を同時に更新する - Tablestore

UpdateTimeseriesMeta オペレーションを呼び出して、複数の時系列のメタデータを一度に更新できます。

前提条件

時系列データは時系列テーブルに書き込まれます。詳細については、時系列データの書き込みを参照してください。
TimeseriesClient インスタンスが初期化されます。詳細については、OTSClient インスタンスの初期化を参照してください。

パラメーター

timeseriesMeta パラメーターは、時系列のメタデータを指定します。各 timeseriesMeta パラメーターは、timeseriesKey パラメーターと attributes パラメーターで構成されます。次の表に、パラメーターを示します。

パラメーター

必須

説明

timeseriesKey

はい

時系列の識別子。次のパラメーターを使用して、時系列の識別子を指定できます。

measurementName: 時系列のメトリック名。
dataSource: 時系列のデータソース。このパラメーターは空のままにすることができます。
tags: 時系列のタグ。このパラメーターの値は、STRING タイプのキーと値のペアです。

重要

クエリする時系列の情報（メトリック名、データソースなど）が不明な場合は、QueryTimeseriesMeta オペレーションを呼び出して、さまざまな条件に基づいて時系列を取得できます。詳細については、時系列の取得を参照してください。

attributes

はい

時系列の属性。値は、STRING タイプの 1 つ以上のキーと値のペアで構成されます。

例

次のサンプルコードは、時系列の属性を更新する方法の例を示しています。

func UpdateTimeseriesMetaSample(tsClient *tablestore.TimeseriesClient, timeseriesTableName string) {
    fmt.Println("[Info]: 時系列メタデータの更新を開始します!")

    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]: 時系列メタデータの更新に失敗しました。エラー: " , err)
        return
    }

    if len(updateTimeseriesMetaResponse.GetFailedRowResults()) > 0 {
        fmt.Println("[Error]: 時系列メタデータの更新に失敗した行: ")
        for i := 0; i < len(updateTimeseriesMetaResponse.GetFailedRowResults()); i++ {
            fmt.Println("[Error]: " , updateTimeseriesMetaResponse.GetFailedRowResults()[i].Index , updateTimeseriesMetaResponse.GetFailedRowResults()[i].Error)
        }
    }


    fmt.Println("[Info]: UpdateTimeseriesMetaSample が完了しました!")
}

FAQ

参照

API オペレーションの詳細については、UpdateTimeseriesMetaを参照してください。
時系列の更新された属性を表示するには、時系列を取得します。詳細については、時系列の取得を参照してください。