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.
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
Ative o service Tablestore. Para mais informações, consulte Activate Tablestore.
-
Crie uma instância do modelo TimeSeries.
Faça login no console do Tablestore.
Na barra de navegação superior, selecione um grupo de recursos e uma região.
Na página Overview, clique em Create Instance for TimeSeries Model.
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.
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 .
-
Acesse a página Instance Management.
Faça login no console do Tablestore.
Na barra de navegação superior, selecione um grupo de recursos e uma região.
Na página Overview, clique no nome da instância ou em Manage Instance na coluna Actions da instância.
Na aba Instance Details, clique na aba Time Series Tables.
-
Na aba Time Series Tables, clique em Create Time Series Table.
NotaVocê 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.
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.
-
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
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.
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.
-
(Opcional) Crie uma série temporal.
Na aba Query Data, clique em Add Time Series.
-
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. Clique em Add.
-
Insira os dados.
Na coluna Actions da série temporal que deseja gerenciar, clique em Query Data.
-
Clique em Insert Data.
O sistema obtém automaticamente os metadados da série temporal selecionada.
-
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 sejacar_modele o valor sejamodel_A. Defina o horário comoFebruary 5, 2025, 00:00:00. As colunas de atributos necessárias incluem:vin_id(string),model(string, valormodel_A),speed(double, valor75.90),gps(string, valor30.23,52.78),current_mileage(double, valor10),remaining_oil(double, valor20),available_mileage(double, valor198) etire_pressure(double, valor2.4). Após configurar os parâmetros, clique em OK. 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 .
Na aba Query Data da tabela de séries temporais, localize a série temporal desejada e clique em Query Data na coluna Actions.
-
Configure as condições de consulta.
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.
Selecione um método de consulta e especifique um intervalo de tempo.
-
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.
-
Acesse a página Instance Management.
Faça login no console do Tablestore.
Na barra de navegação superior, selecione um grupo de recursos e uma região.
Na página Overview, clique no nome da instância ou em Manage Instance na coluna Actions da instância.
-
Acesse a página de gerenciamento da tabela de séries temporais.
Na aba Instance Details, clique na aba Time Series Tables.
Na aba Time Series Tables, clique no nome da tabela de séries temporais.
-
Crie um índice Lastpoint.
Na aba Basic Information da página de gerenciamento da tabela de séries temporais, clique em Create Lastpoint Index.
-
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. Clique em Create.
-
Consulte dados utilizando o índice Lastpoint.
Na coluna Actions do índice Lastpoint, clique em Query.
-
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.
-
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.
Na aba Query Data da tabela de séries temporais, clique em Query Time Series no canto superior direito.
-
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. -
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 |
|
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.