UpdateTimeseriesMeta API を呼び出して、時系列メタデータの属性をバッチ更新できます。1 回の UpdateTimeseriesMeta 呼び出しで、複数の時系列のメタデータを更新できます。更新対象の時系列メタデータが存在しない場合、システムがメタデータを作成します。
前提条件
クライアントが初期化済みである必要があります。詳細については、「Tablestore クライアントの初期化」をご参照ください。
パラメーター
timeseriesMeta パラメーターは、時系列のメタデータを指定します。各 timeseriesMeta パラメーターは、timeseriesKey パラメーターと attributes パラメーターで構成されます。次の表にパラメーターを示します。
|
パラメーター |
必須 |
説明 |
|
timeseriesKey |
はい |
時系列の識別子。次の項目が含まれます。
重要
メトリック名やデータソースなどの時系列識別子が不明な場合は、QueryTimeseriesMeta 操作を呼び出して、フィルター条件に基づいて時系列を取得してください。詳細については、「時系列の取得」をご参照ください。 |
|
attributes |
はい |
時系列の属性。キーと値がそれぞれ |
例
次のサンプルコードは、時系列の属性情報を更新する方法を示しています。
func UpdateTimeseriesMetaSample(tsClient *tablestore.TimeseriesClient, timeseriesTableName string) {
// 時系列メタデータの更新を開始します。
fmt.Println("[情報]: 時系列メタデータの更新を開始します。")
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("[エラー]: 時系列メタデータの更新に失敗しました。エラー: " , err)
return
}
if len(updateTimeseriesMetaResponse.GetFailedRowResults()) > 0 {
// 時系列メタデータの更新に失敗した行
fmt.Println("[エラー]: 時系列メタデータの更新に失敗した行: ")
for i := 0; i < len(updateTimeseriesMetaResponse.GetFailedRowResults()); i++ {
fmt.Println("[エラー]: " , updateTimeseriesMetaResponse.GetFailedRowResults()[i].Index , updateTimeseriesMetaResponse.GetFailedRowResults()[i].Error)
}
}
// UpdateTimeseriesMetaSample が完了しました。
fmt.Println("[情報]: UpdateTimeseriesMetaSample が完了しました。")
}関連ドキュメント
更新された時系列の属性を表示するには、時系列を取得してください。詳細については、「時系列の取得」をご参照ください。