Data Points Storage
Visão Geral
O Data Points Storage é um banco de dados projetado para armazenar dados do tipo time-series. Ele é otimizado para lidar com conjuntos de dados em larga escala e é ideal para consultas de dados históricos, como buscar os últimos 10 mil registros, filtrar por um intervalo de tempo definido (ex.: início em 20/05/2024 e fim em 20/06/2024), ou realizar cálculos como max, min, sum ou average.
Veja a estrutura de um Data Point abaixo:
- Variable: Nome ou rótulo legível para o objeto.
- Value: Campo de valor personalizado
- Time: Timestamp indicando o momento
{
"variable": "temperature",
"value": 23.5,
"time": "2023-10-15T14:30:00Z"
}
Os Data Points da Valeiot seguem uma estrutura específica (apresentada acima), que deve ser respeitada para garantir que possam ser armazenados corretamente no Data Points Storage. Para saber mais sobre a estrutura de um Data Point, leia a seção Valeiot Data Point.
Para acessar o Data Points Storage, selecione o Data Source que deseja visualizar e localize a tabela na aba Data Points.

Características Principais
- Imutável: Após criados, os Data Points não podem ser editados, apenas excluídos.
- Sistema de Retenção de Dados: Os Data Points possuem um tempo de vida configurável (TTL) com base na política de
Data Retention. Dados mais antigos do que o período definido são removidos automaticamente (ex.: se a retenção for de 30 dias, todos os dados com mais de 30 dias — com base no campotimedo Data Point — serão automaticamente removidos). - Eficiente e Robusto: Projetado para armazenar e recuperar grandes volumes de dados temporais com eficiência.
Casos de Uso
- Armazenamento de milhões de Data Points de sensores IoT (ex.: temperatura, umidade, pressão, localização).
- Registro de atividades, métricas de aplicações e sistemas ao longo do tempo (ex.: atividade de usuários, logs de dispositivos).
- Obtenção da média, máximo ou mínimo de uma variável específica (ex.: velocidade).
Bucket
Os Data Points estão associados a um bucket. Ao criar um novo Data Source, você deve selecionar um bucket identificado por um bucket_id. Cada bucket possui propriedades únicas, como tempo de retenção e intervalos de chunk. Para instruções detalhadas de configuração, veja a seção Bucket.
Data Retention
Os Data Points possuem um tempo de vida (TTL) no sistema, determinado pela configuração de Data Retention. Por exemplo, se a retenção for definida para 30 dias, todos os dados com mais de 30 dias (com base no campo time do Data Point) serão automaticamente removidos. Para saber mais, leia a seção sobre Data Retention.