Todos os produtos
Search
Central de documentação

Tablestore:TimeSeries model quick start

Última atualização: Sep 09, 2026

O modelo TimeSeries foi desenvolvido para dados de séries temporais, sendo ideal para cenários como monitoramento de dispositivos de Internet das Coisas (IoT), coleta de dados de dispositivos e monitoramento de máquinas. Ele oferece gravações e consultas de alta concorrência, além de armazenamento de baixo custo para petabytes de dados. Este tópico mostra como usar o modelo TimeSeries no console do Tablestore.

Importante

Para usar o modelo TimeSeries com uma ferramenta de linha de comando, consulte Use the TimeSeries model with a command-line tool.

Observações

O modelo TimeSeries é compatível nas seguintes regiões: China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), China (Chengdu), China (Hong Kong), Japan (Tokyo), Malaysia (Kuala Lumpur), Germany (Frankfurt), Indonesia (Jakarta), UK (London), US (Silicon Valley), US (Virginia), SAU (Riyadh - Partner Region), e Singapore.

Recursos como índice Lastpoint, armazenamento de análise de séries temporais, identificadores personalizados de séries temporais e campos de dados como chaves primárias estão disponíveis apenas nas regiões China (Hangzhou), China (Shanghai), China (Beijing) e China (Zhangjiakou). Para utilizar esses recursos, crie sua instância em uma dessas regiões.

Pré-requisitos

  1. Ative o service Tablestore. Para mais informações, consulte Activate Tablestore.

  2. Crie uma instância do modelo TimeSeries.

    1. Faça login no console do Tablestore.

    2. Na barra de navegação superior, selecione um grupo de recursos e uma região.

    3. Na página Overview, clique em Create Instance for TimeSeries Model.

    4. Na caixa de diálogo Create Instance for TimeSeries Model, selecione uma especificação de instância, insira um nome de instância e adicione uma descrição da instância.

    5. Clique em OK.

Procedimento

Etapa 1: Criar uma tabela de séries temporais

Crie uma tabela de séries temporais para armazenar dados desse tipo.

Para obter informações sobre o cenário de exemplo e o esquema da tabela, consulte Sample scenario .
  1. Acesse a página Instance Management.

    1. Faça login no console do Tablestore.

    2. Na barra de navegação superior, selecione um grupo de recursos e uma região.

    3. Na página Overview, clique no nome da instância ou em Manage Instance na coluna Actions da instância.

  2. Na aba Instance Details, clique na aba Time Series Tables.

  3. Na aba Time Series Tables, clique em Create Time Series Table.

    Nota

    Você também pode clicar em Generate Demo with One Click para criar uma tabela de amostra com dados de exemplo e testar rapidamente os recursos. Pode levar alguns segundos para que uma nova série temporal apareça enquanto o sistema inicializa a tabela de amostra.

  4. Na caixa de diálogo Create Time Series Table, defina Time Series Table Name como car_example e mantenha as configurações padrão para os outros parâmetros.

  5. Clique em Create.

    Após a criação da tabela de séries temporais, visualize-a na aba Time Series Tables. Caso a nova tabela não apareça na lista, clique no ícone fig_tablestore_002 para atualizar a lista de tabelas de séries temporais.

Etapa 2: Gravar dados

Grave dados na tabela de séries temporais. Os dados de séries temporais consistem em metadados e pontos de dados. Se você não criar metadados antecipadamente, o sistema os extrairá automaticamente dos dados gravados.

  1. Na aba Time Series Tables, clique no nome da tabela de séries temporais e, em seguida, clique na aba Query Data. Alternativamente, clique em Manage Data na coluna Actions da tabela de séries temporais.

  2. (Opcional) Crie uma série temporal.

    1. Na aba Query Data, clique em Add Time Series.

    2. Na caixa de diálogo Add Time Series, adicione metadados para a série temporal, como o nome da métrica e a source de dados.

      Neste exemplo, defina Metric Name como car_tsdata, selecione uma Data Source e, na seção Tag, adicione uma condição de filtro onde a chave é car_model, o operador é = e o valor é model_A. Em seguida, clique em Add.

    3. Clique em Add.

  3. Insira os dados.

    1. Na coluna Actions da série temporal que deseja gerenciar, clique em Query Data.

    2. Clique em Insert Data.

      O sistema obtém automaticamente os metadados da série temporal selecionada.

    3. Na caixa de diálogo Insert Data, configure as colunas de tempo e atributos.

      Defina o nome da métrica como car_tsdata. Adicione uma tag cuja chave seja car_model e o valor seja model_A. Defina o horário como February 5, 2025, 00:00:00. As colunas de atributos necessárias incluem: vin_id (string), model (string, valor model_A), speed (double, valor 75.90), gps (string, valor 30.23,52.78), current_mileage (double, valor 10), remaining_oil (double, valor 20), available_mileage (double, valor 198) e tire_pressure (double, valor 2.4). Após configurar os parâmetros, clique em OK.

    4. Clique em OK.

Etapa 3: Consultar dados de séries temporais

Consulte dados de uma série temporal dentro de um intervalo de tempo especificado.

Para consultar dados em uma tabela usando SQL, consulte Query time series data by using SQL .
Caso não tenha certeza sobre as informações da série temporal a ser consultada, recupere séries temporais especificando várias condições. Para mais informações, consulte Retrieve time series .
  1. Na aba Query Data da tabela de séries temporais, localize a série temporal desejada e clique em Query Data na coluna Actions.

  2. Configure as condições de consulta.

    1. Por padrão, os resultados da consulta são classificados em ordem crescente de tempo. Para consultar dados em ordem decrescente, defina Reverse Chronological Order como Yes.

    2. Selecione um método de consulta e especifique um intervalo de tempo.

  3. Clique em Query.

    Os dados que atendem às condições de consulta são exibidos na aba Query Data. É possível visualizar os resultados da consulta em formato de lista ou gráfico.

Usar um índice Lastpoint

Um índice Lastpoint permite recuperar rapidamente o ponto de dados mais recente de cada série temporal em uma tabela de séries temporais.

  1. Acesse a página Instance Management.

    1. Faça login no console do Tablestore.

    2. Na barra de navegação superior, selecione um grupo de recursos e uma região.

    3. Na página Overview, clique no nome da instância ou em Manage Instance na coluna Actions da instância.

  2. Acesse a página de gerenciamento da tabela de séries temporais.

    1. Na aba Instance Details, clique na aba Time Series Tables.

    2. Na aba Time Series Tables, clique no nome da tabela de séries temporais.

  3. Crie um índice Lastpoint.

    1. Na aba Basic Information da página de gerenciamento da tabela de séries temporais, clique em Create Lastpoint Index.

    2. Na caixa de diálogo Create Lastpoint Index, configure o nome do índice Lastpoint e o modo de sincronização.

      Por exemplo, defina Lastpoint Index Name como lastpoint_car_example, configure Synchronization Mode como Full Synchronization e clique em Create.

    3. Clique em Create.

  4. Consulte dados utilizando o índice Lastpoint.

    1. Na coluna Actions do índice Lastpoint, clique em Query.

    2. Na caixa de diálogo Search, defina Mode como Range Search e mantenha as configurações padrão para os demais parâmetros.

      Por padrão, os valores iniciais de chave primária para _#h , _m_name , _data_source e _tags são definidos como mínimo, e os valores finais de chave primária são definidos como máximo.
    3. Clique em Query.

      Os dados que atendem às condições de consulta são exibidos na seção Lastpoint Index da aba Basic Information.

Recuperar séries temporais

Caso não tenha certeza sobre o nome exato da métrica ou a source de dados de uma série temporal, pesquise-a especificando múltiplas condições.

  1. Na aba Query Data da tabela de séries temporais, clique em Query Time Series no canto superior direito.

  2. Na caixa de diálogo Query Data, insira o nome da métrica ou a source de dados da série temporal e clique em Add para especificar condições de correspondência para tags, atributos ou horário de atualização.

    A condição neste exemplo serve para consultar todas as séries temporais que contêm a tag car_model=model_A.

  3. Clique em OK.

    Os dados que atendem às condições de consulta são exibidos na aba Query Data.

Cenário de exemplo

Em um cenário de Internet dos Veículos (IoV), os veículos usam sensores para relatar dados de séries temporais à cloud. O armazenamento, a consulta e a análise desses dados possibilitam recursos de negócios como relatórios de status do veículo, localização veicular, gestão de tráfego e projeção de trajetórias. Este tópico utiliza uma tabela de séries temporais em um cenário de IoV como exemplo para descrever como criar uma tabela de séries temporais e executar operações de leitura e gravação. A tabela armazena dados de trajetória de veículos.

Parâmetro

Tipo

Descrição

_m_name

String

Nome da métrica, que indica a grandeza física ou a métrica de monitoramento medida pelos dados da série temporal.

_data_source

String

Identificador da source de dados que gera a série temporal. Este campo pode ficar vazio.

_tags

String

Tags da série temporal, definidas como um ou mais pares chave-valor do tipo string.

_time

Integer

Momento em que os dados foram relatados.

vin_id

String

Número de identificação do veículo (VIN), que é único.

model

String

Modelo do veículo.

speed

Double

Velocidade atual.

gps

String

Coordenadas GPS do veículo, no formato latitude,longitude. A latitude deve ser um valor entre -90 e 90, e a longitude deve ser um valor entre -180 e 180. Por exemplo, 30.23,52.78.

current_mileage

Double

Quilometragem atual.

remaining_oil

Double

Combustível restante.

available_mileage

Double

Distância percorrida restante.

tire_pressure

Double

Dados de pressão dos pneus.

Documentos relacionados

Para mais informações sobre índices Lastpoint, consulte Lastpoint index.