Todos os produtos
Search

Este produto

    Tablestore:Retrieve time series

    Central de documentação

    Tablestore:Retrieve time series

    Última atualização: Jun 30, 2026

    Recupere séries temporais que atendam a condições específicas chamando a operação QueryTimeseriesMeta.

    Pré-requisitos

    Inicialize um cliente. Para mais informações, consulte Inicializar um cliente do Tablestore.

    Parâmetros

    Parâmetro

    Descrição

    timeseriesTableName (obrigatório)

    Nome da tabela de séries temporais.

    condition (opcional)

    Condição de consulta para recuperar séries temporais. Há suporte para as seguintes combinações de condições:

    • CompositeMetaQueryCondition: condições compostas, formadas pelos seguintes itens:

      • operator: operador lógico. Valores válidos: OP_AND, OP_OR e OP_NOT.

      • sub_conditions: lista de subcondições combinadas pelo operador para formar condições de consulta complexas.

    • MeasurementMetaQueryCondition: condição baseada no nome da métrica.

      • operator: operador relacional ou condição de correspondência de prefixo (OP_PREFIX). O operador relacional pode ser OP_EQUAL, OP_NOT_EQUAL, OP_GREATER_THAN, OP_GREATER_EQUAL, OP_LESS_THAN ou OP_LESS_EQUAL.

      • value: nome da métrica da série temporal a ser consultada. Tipo: String.

    • DataSourceMetaQueryCondition: condição baseada na source de dados.

      • operator: operador relacional ou condição de correspondência de prefixo (OP_PREFIX). O operador relacional pode ser OP_EQUAL, OP_NOT_EQUAL, OP_GREATER_THAN, OP_GREATER_EQUAL, OP_LESS_THAN ou OP_LESS_EQUAL.

      • value: nome da source de dados da série temporal a ser consultada. Tipo: String.

    • TagMetaQueryCondition: condição baseada em tag.

      • operator: operador relacional ou condição de correspondência de prefixo (OP_PREFIX). O operador relacional pode ser OP_EQUAL, OP_NOT_EQUAL, OP_GREATER_THAN, OP_GREATER_EQUAL, OP_LESS_THAN ou OP_LESS_EQUAL.

      • tag_name: nome da tag da série temporal a ser consultada. Tipo: String.

      • value: valor da tag da série temporal a ser consultada. Tipo: String.

    • UpdateTimeMetaQueryCondition: condição baseada no horário de atualização dos metadados da série temporal.

      • operator: operador relacional. Valores válidos: OP_EQUAL, OP_NOT_EQUAL, OP_GREATER_THAN, OP_GREATER_EQUAL, OP_LESS_THAN, OP_LESS_EQUAL.

      • time_in_us: timestamp do horário de atualização dos metadados da série temporal. Tipo: Integer. Unidade: microssegundos.

    • AttributeMetaQueryCondition: condição baseada em atributos dos metadados da série temporal.

      • operator: operador relacional ou condição de correspondência de prefixo (OP_PREFIX). O operador relacional pode ser OP_EQUAL, OP_NOT_EQUAL, OP_GREATER_THAN, OP_GREATER_EQUAL, OP_LESS_THAN ou OP_LESS_EQUAL.

      • attribute_name: nome do atributo. Tipo: String.

      • value: valor do atributo. Tipo: String.

    getTotalHits (opcional)

    Define se o sistema deve retornar o número total de linhas que atendem à condição de recuperação especificada. Valor padrão: False.

    limit (opcional)

    Número máximo de linhas a retornar nesta solicitação. Valor padrão: 100. Valores válidos: (0,1000].

    Nota

    O parâmetro limit restringe apenas o número máximo de linhas retornadas. Mesmo que a quantidade de linhas correspondentes às condições exceda esse limite, o número efetivamente retornado pode ser menor devido a outras restrições, como o volume máximo de dados por varredura. Nesse caso, utilize o parâmetro nextToken para obter as linhas restantes.

    nextToken (opcional)

    Quando uma consulta retorna apenas parte das linhas correspondentes, a resposta inclui o parâmetro nextToken. Especifique esse parâmetro na próxima solicitação para recuperar as linhas restantes.

    Importante

    Caso precise persistir o nextToken ou transferi-lo para uma página frontend, codifique-o em Base64 para convertê-lo em string. O nextToken não é nativamente uma string. Se você usar diretamente str(nextToken) para essa conversão, as informações do token serão perdidas.

    Exemplo

    O código de exemplo abaixo demonstra como recuperar séries temporais que atendem a condições específicas em uma tabela de séries temporais:

    try:
    # Query condition: All time series with metric name "cpu" and a tag named "os" with a prefix of "Ubuntu". 
    # This is equivalent to measurement_name="cpu" and have_prefix(os, "Ubuntu").
    measCond = MeasurementMetaQueryCondition(MetaQuerySingleOperator.OP_EQUAL, "cpu")
    tagCond = TagMetaQueryCondition(MetaQuerySingleOperator.OP_PREFIX, "os", "Ubuntu")
    condition = CompositeMetaQueryCondition(MetaQueryCompositeOperator.OP_AND, [measCond, tagCond])

    request = QueryTimeseriesMetaRequest("", condition)
    # Call the operation to retrieve time series.
    response = ots_client.query_timeseries_meta(request)
    print("query timeseries metas succeeded. ")
    for timeseriesMeta in response.timeseriesMetas:
        print("data_source: %s, measurement_name: %s, tags: %s, attributes : %s, update_time_in_us: %s." % (
        timeseriesMeta.timeseries_key.data_source, timeseriesMeta.timeseries_key.measurement_name,
        timeseriesMeta.timeseries_key.tags,
        timeseriesMeta.attributes, timeseriesMeta.update_time_in_us))
except Exception as e:
    # If an exception is thrown, the query fails. Handle the exception.
    print("query timeseries meta failed. %s" % e)