Todos os produtos
Search

Este produto

    Tablestore:Recuperar séries temporais

    Central de documentação

    Tablestore:Recuperar séries temporais

    Última atualização: Jul 03, 2026

    Chame QueryTimeseriesMeta para pesquisar séries temporais em uma tabela de séries temporais. Filtre por nome da métrica, fonte de dados, tag, atributo ou hora de atualização para recuperar exatamente as séries temporais necessárias.

    Pré-requisitos

    Parâmetros

    O parâmetro metaQueryCondition define as condições para recuperação de séries temporais. Essas condições incluem compositeMetaQueryCondition, measurementMetaQueryCondition, dataSourceMetaQueryCondition, tagMetaQueryCondition, attributeMetaQueryCondition e updateTimeMetaQueryCondition. A tabela a seguir descreve os parâmetros.

    Parâmetro

    Obrigatório

    Descrição

    compositeMetaQueryCondition

    Não

    Condição composta, que inclui o seguinte conteúdo:

    • operator: operador lógico. Operadores lógicos válidos: AND, OR e NOT.

    • subConditions: subcondições combináveis por meio de operadores para consultas complexas.

    measurementMetaQueryCondition

    Sim. É necessário especificar um dos parâmetros.

    Condição de nome da métrica, que inclui o seguinte conteúdo:

    • operator: operador relacional ou condição de correspondência de prefixo. Operadores relacionais válidos: =, >, >=, < e <=.

    • value: nome da métrica da série temporal que você deseja consultar. Tipo: STRING.

    dataSourceMetaQueryCondition

    Condição de fonte de dados, que inclui o seguinte conteúdo:

    • operator: operador relacional ou condição de correspondência de prefixo. Operadores relacionais válidos: =, >, >=, < e <=.

    • value: fonte de dados da série temporal que você deseja consultar. Tipo: STRING.

    tagMetaQueryCondition

    Condição de tag, que inclui o seguinte conteúdo:

    • operator: operador relacional ou condição de correspondência de prefixo. Operadores relacionais válidos: =, >, >=, < e <=.

    • value: valor da tag da série temporal que você deseja consultar. Tipo: STRING.

    attributeMetaQueryCondition

    Condição de atributo para os metadados da série temporal. Essa condição inclui o seguinte conteúdo:

    • operator: operador relacional ou condição de correspondência de prefixo. Operadores relacionais válidos: =, >, >=, < e <=.

    • attributeName: nome do atributo. Tipo: STRING.

    • value: valor do atributo. Tipo: STRING.

    updateTimeMetaQueryCondition

    Condição de hora de atualização para os metadados da série temporal. Essa condição inclui o seguinte conteúdo:

    • operator: operador relacional. Operadores relacionais válidos: =, >, >=, < e <=.

    • timeInUs: timestamp de atualização dos metadados da série temporal. Unidade: microssegundos.

    Exemplos

    O código de exemplo a seguir demonstra como consultar o nome da métrica, a fonte de dados e as tags da série temporal com base em uma condição especificada. A condição pode ser composta.

    func QueryTimeseriesMetaSample(client *tablestore.TimeseriesClient , timeseriesTableName string) {
    fmt.Println("[Info]: Begin to query timeseries table meta!")

    // Construct multiple query conditions. 
    measurementMetaQueryCondition := tablestore.NewMeasurementQueryCondition(tablestore.OP_GREATER_EQUAL , "")
    datasourceMetaQueryCondition := tablestore.NewDataSourceMetaQueryCondition(tablestore.OP_GREATER_EQUAL , "")
    tagMetaQueryCondition := tablestore.NewTagMetaQueryCondition(tablestore.OP_GREATER_THAN , "City" , "")

    // Construct a composite condition. 
    compsiteMetaQueryCondition := tablestore.NewCompositeMetaQueryCondition(tablestore.OP_AND)
    compsiteMetaQueryCondition.AddSubConditions(measurementMetaQueryCondition)
    compsiteMetaQueryCondition.AddSubConditions(datasourceMetaQueryCondition)
    compsiteMetaQueryCondition.AddSubConditions(tagMetaQueryCondition)

    // Construct the query request. 
    queryTimeseriesMetaRequest := tablestore.NewQueryTimeseriesMetaRequest(timeseriesTableName)
    queryTimeseriesMetaRequest.SetCondition(compsiteMetaQueryCondition)
    queryTimeseriesMetaRequest.SetLimit(-1)

    // Call the time series client-related operation to execute the query request. 
    queryTimeseriesTableResponse , err := client.QueryTimeseriesMeta(queryTimeseriesMetaRequest)
    if err != nil {
        fmt.Println("[Error]: Query timeseries table meta failed with error: " , err)
        return
    }
    fmt.Println("[Info]: Query timeseries table meta succeed: ")
    for i := 0; i < len(queryTimeseriesTableResponse.GetTimeseriesMetas()); i++ {
        curTimeseriesMeta := queryTimeseriesTableResponse.GetTimeseriesMetas()[i]
        fmt.Println("[Info]: Meta_" , i , ": " , "Measurement: " , curTimeseriesMeta.GetTimeseriesKey().GetMeasurementName() ,
            "Source: " , curTimeseriesMeta.GetTimeseriesKey().GetDataSource() ,
            "Tags: " , curTimeseriesMeta.GetTimeseriesKey().GetTags(),
            "Attrs: " , curTimeseriesMeta.GetAttributeSlice())
    }
    fmt.Println("[Info]: QueryTimeseriesMetaSample finished !")
}

    Perguntas frequentes

    Referências