> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/pt-br/example-queries/common-queries.md).

# Consultas comuns

Padrões de SQL de exemplo para informações do Objeto, localizações do dispositivo, atividade do veículo, atribuições do Motorista, dados de sensor e análise de zonas geoespaciais

Ao se conectar ao banco de dados, você poderá recuperar dados por meio de consultas SQL. Esta seção apresenta exemplos de consultas SQL para ajudar você a começar a trabalhar com o Private Telematics Lakehouse. Esses exemplos mostram como acessar e analisar dados do **Dados brutos** camada, que contém dados brutos comerciais e telemáticos com transformação mínima.

{% hint style="danger" %}
Observação: como o banco de dados contém uma quantidade enorme de informações, faça consultas de teste com base em um número limitado de valores recuperados.
{% endhint %}

## Consultas básicas

### Recuperar informações básicas do objeto

Esta consulta retorna informações sobre os objetos (veículos/ativos) do seu sistema:

```sql
SELECT
    o.object_id,
    o.object_label,
    o.model,
    d.device_imei,
    g.group_label
DE
    raw_business_data.objects o
    LEFT JOIN raw_business_data.devices d ON o.device_id = d.device_id
    LEFT JOIN raw_business_data.groups g ON o.group_id = g.group_id
WHERE
    o.is_deleted = false
ORDENAR POR
    o.object_label;
```

### Obter as localizações mais recentes dos dispositivos

Recupere os dados de localização mais recentes de todos os seus dispositivos:

```sql
SELECT
    t.device_id,
    o.object_label,
    -- Converte coordenadas inteiras em escala de volta para o formato decimal
    t.latitude::float / 10000000 AS latitude,
    t.longitude::float / 10000000 AS longitude,
    t.speed,
    t.device_time
DE
    raw_telematics_data.tracking_data_core t
    JOIN raw_business_data.objects o ON t.device_id = o.device_id
WHERE
    t.device_time > (CURRENT_DATE - INTERVAL '1 day')
    AND t.latitude != 0
    AND t.longitude != 0
ORDENAR POR
    t.device_id, t.device_time DESC;
```

{% hint style="info" %}
Os valores das coordenadas são armazenados como inteiros multiplicados por 10^7 para melhorar a eficiência de armazenamento no TimescaleDB. Ao fazer uma consulta, divida por 10000000 para converter os valores de volta para o formato decimal padrão.
{% endhint %}

## Unindo dados empresariais e telemáticos

### Relatório de atividade do veículo

Esta consulta gera um resumo diário de atividades ao combinar dados comerciais e telemáticos:

```sql
SELECT
    o.object_label AS vehicle,
    v.vehicle_type,
    DATE(t.device_time) AS date,
    COUNT(DISTINCT DATE_PART('hour', t.device_time)) AS active_hours,
    MAX(t.speed) AS max_speed,
    AVG(t.speed) AS avg_speed
DE
    raw_telematics_data.tracking_data_core t
    JOIN raw_business_data.objects o ON t.device_id = o.device_id
    LEFT JOIN raw_business_data.vehicles v ON o.object_id = v.object_id
WHERE
    t.device_time BETWEEN '2025-03-01' AND '2025-03-28'
AGRUPAR POR
    o.object_label, v.vehicle_type, DATE(t.device_time)
ORDENAR POR
    o.object_label, DATE(t.device_time);
```

### Atribuições de motoristas e histórico de localização

Acompanhe quais funcionários foram atribuídos a quais veículos e o histórico de localização deles:

```sql
SELECT 
    o.object_label AS vehicle,
    new_row.changed_datetime AS assignment_time,
    e_new.first_name || ' ' || e_new.last_name AS new_driver_name,
    e_old.first_name || ' ' || e_old.last_name AS old_driver_name,
    new_row.address,
    new_row.latitude,
    new_row.longitude
DE 
    raw_business_data.driver_history new_row
JOIN 
    raw_business_data.driver_history old_row
    ON new_row.changed_datetime = old_row.changed_datetime
    AND new_row.object_id = old_row.object_id
LEFT JOIN 
    raw_business_data.employees e_new ON new_row.new_employee_id = e_new.employee_id
LEFT JOIN 
    raw_business_data.employees e_old ON old_row.old_employee_id = e_old.employee_id
LEFT JOIN 
    raw_business_data.objects o ON new_row.object_id = o.object_id
ORDENAR POR 
    assignment_time;
```

## Análise dos dados do sensor

### Monitoramento do nível de combustível

Esta consulta mostra como analisar dados do sensor de nível de combustível:

```sql
SELECT
    o.object_label AS vehicle,
    t.device_time,
    i.value::numeric AS fuel_level
DE
    raw_telematics_data.inputs i
    JOIN raw_business_data.objects o ON i.device_id = o.device_id
    JOIN raw_telematics_data.tracking_data_core t ON
        i.device_id = t.device_id AND
        i.device_time = t.device_time
WHERE
    i.sensor_name = 'fuel'
    AND t.device_time > (CURRENT_DATE - INTERVAL '7 days')
ORDENAR POR
    o.object_label, t.device_time;
```

## Análise geoespacial

### Veículos em geocercas

Identifique quais veículos entraram em geocercas específicas:

```sql
SELECT
    o.object_label AS vehicle,
    z.zone_label AS geozone,
    t.device_time AS entry_time
DE
    raw_telematics_data.tracking_data_core t
    JOIN raw_business_data.objects o ON t.device_id = o.device_id
    JOIN raw_business_data.zones z ON
        -- Calcular se o ponto está dentro da zona circular
        -- Converter coordenadas de inteiros escalados para decimais
        (
            CASE
                WHEN z.zone_type = 'circle' THEN
                    ST_DWithin(
                        ST_MakePoint(t.longitude::float/10000000, t.latitude::float/10000000)::geography,
                        ST_MakePoint(z.circle_center_longitude, z.circle_center_latitude)::geography,
                        z.radius
                    )
                ELSE false
            END
        )
WHERE
    t.device_time > (CURRENT_DATE - INTERVAL '1 day')
ORDENAR POR
    z.zone_label, o.object_label, t.device_time;
```

{% hint style="info" %}
Esta consulta usa funções espaciais do PostGIS. Se ocorrerem erros, verifique se a extensão PostGIS está habilitada no seu banco de dados.
{% endhint %}

## Dicas de otimização de desempenho

Ao trabalhar com o Cloud Data Warehouse, considere estas técnicas de otimização:

1. **Use a filtragem baseada em tempo**: Sempre inclua um filtro de tempo em `device_time` ou `record_added_at` colunas para limitar os dados examinados.\
   **Boa prática**:

```sql
SELECT * FROM raw_telematics_data.tracking_data_core 
WHERE device_time > (CURRENT_DATE - INTERVAL '7 days');
```

**Evite isso** (varre a tabela inteira)

```sql
SELECT * FROM raw_telematics_data.tracking_data_core;
```

2. **Aproveitar índices**: O banco de dados tem índices em `(device_id, device_time)`  pares. Estruture suas consultas para usar esses índices sempre que possível.
3. **Usar junções com critério**: Junte tabelas somente quando necessário e tente filtrar os dados antes de juntar tabelas grandes.
4. **Conversão de inteiros escalonados**: Lembre-se de que os dados de coordenadas são armazenados como inteiros escalonados. Faça a conversão somente no SELECT final, não nas cláusulas WHERE.
5. **Limitar os conjuntos de resultados**: Sempre use LIMIT em consultas exploratórias para evitar retornar milhões de linhas.

```sql
SELECT * FROM raw_telematics_data.tracking_data_core 
WHERE device_time > (CURRENT_DATE - INTERVAL '1 day')
LIMIT 1000;
```

6. **Usar relações hierárquicas**: Estruture consultas complexas seguindo a hierarquia de entidades (**provedor de serviços telemáticos → cliente → usuário/dispositivo → objeto**) para fazer junções e filtragens mais eficientes.
7. **Gerenciar conexões corretamente**: Feche as conexões com o banco de dados quando não estiverem em uso, especialmente em ferramentas de BI ou scripts agendados, para evitar bloqueios de recursos ou problemas de tempo limite.

## Próximas etapas

Estes exemplos são um ponto de partida para trabalhar com seus dados. À medida que você se familiarizar com o esquema, poderá desenvolver consultas mais complexas para atender às necessidades específicas do seu negócio.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/analytics/pt-br/example-queries/common-queries.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
