Todos os produtos
Search

Este produto

    Tablestore:Write time series data

    Central de documentação

    Tablestore:Write time series data

    Última atualização: Jun 30, 2026

    Após crie uma tabela de séries temporais, chame a operação PutTimeseriesData para gravar uma ou mais linhas de dados na tabela.

    Observações de uso

    O modelo TimeSeries requer o Tablestore SDK for Python V6.1.0 ou posterior.

    Nota

    Para obter mais informações, consulte Histórico de versões do SDK para Python.

    Pré-requisitos

    Antes de começar, verifique se você tem:

    Parâmetros

    Parâmetro

    Descrição

    timeseriesTableName (obrigatório)

    Nome da tabela de séries temporais.

    timeseriesRows (obrigatório)

    Lista de linhas de séries temporais para gravação. Cada linha contém um identificador de série temporal e os dados associados.

    • timeseries_key (obrigatório): identificador da série temporal, composto pelos seguintes campos:

      • measurement_name (obrigatório): nome da métrica da série temporal.

      • data_source (obrigatório): identificador da source de dados.

      • tags (obrigatório): tags da série temporal, especificadas como pares chave-valor.

    • time_in_us (obrigatório): timestamp do ponto de dados, em microssegundos.

    • fields (obrigatório): pontos de dados, especificados como pares chave-valor de campo.

    Exemplos

    O exemplo a seguir grava duas linhas de dados em uma tabela de séries temporais:

    # Define tags to identify the time series
tags = {"tag1": "t1", "tag2": "t2"}

# Create time series identifiers
key1 = TimeseriesKey("measure1", "datasource1", tags)
key2 = TimeseriesKey("measure2", "datasource2", tags)

# Define data points for each time series
field1 = {"long_field": 1, "string_field": "string", "bool_field": True, "double_field": 0.3}
field2 = {"binary_field2": bytearray(b'a')}

try:
    # Build time series rows with a microsecond timestamp
    row1 = TimeseriesRow(key1, field1, int(time.time() * 1000000))
    row2 = TimeseriesRow(key2, field2, int(time.time() * 1000000))
    rows = [row1, row2]

    # Write the rows to the time series table
    ots_client.put_timeseries_data("", rows)
    print("put timeseries data succeeded.")
except Exception as e:
    print("put timeseries data failed. %s" % e)