UpdateTimeseriesMeta 操作を呼び出して、複数の時系列のメタデータを同時に更新できます。更新する時系列メタデータが存在しない場合は、時系列メタデータが追加されます。
前提条件
クライアントが初期化されていること。詳細については、「Tablestore クライアントを初期化する」をご参照ください。
パラメーター
timeseriesMeta パラメーターは、時系列のメタデータを指定します。各 timeseriesMeta パラメーターは、timeseriesKey パラメーターと attributes パラメーターで構成されます。次の表に、パラメーターを示します。
パラメーター | 必須 | 説明 |
timeseriesKey | はい | 時系列の識別子。以下の項目が含まれます。
重要 クエリ対象の時系列の情報 (メトリック名、データソースなど) が不明な場合は、QueryTimeseriesMeta 操作を呼び出して、さまざまな条件に基づいて時系列を取得できます。詳細については、「時系列を取得する」をご参照ください。 |
attributes | はい | 時系列の属性。値は、1 つ以上の String 型のキーと値のペアで構成されます。 |
例
時系列の属性情報を更新する方法の例を、次のサンプルコードに示します。
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 が完了しました!")
}参照
更新された時系列属性を表示するには、時系列を取得します。詳細については、「時系列を取得する」をご参照ください。