> 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/ru/example-queries/common-queries.md).

# Распространенные запросы

Примеры SQL-шаблонов для информации об объектах, местоположений устройств, активности транспорта, назначений водителей, данных датчиков и анализа геопространственных зон

После подключения к базе данных вы сможете получать данные с помощью SQL-запросов. В этом разделе приведены примеры SQL-запросов, которые помогут вам начать работу с Private Telematics Lakehouse. В этих примерах показано, как получать доступ к данным из **Сырые данные** слой, содержащий исходные бизнес- и телематические данные с минимальной трансформацией.

{% hint style="danger" %}
Обратите внимание: поскольку база данных содержит огромный объем информации, обязательно выполняйте тестовые запросы с ограниченным количеством извлекаемых значений.
{% endhint %}

## Базовые запросы

### Получение основных сведений об объекте

Этот запрос возвращает информацию об объектах (транспорте/активах) в вашей системе:

```sql
SELECT
    o.object_id,
    o.метка_объекта,
    o.model,
    d.device_imei,
    g.group_label
ОТ
    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
ГДЕ
    o.is_deleted = false
ORDER BY
    o.object_label;
```

### Получение актуальных местоположений устройств

Получите самые актуальные данные о местоположении всех ваших устройств:

```sql
SELECT
    t.device_id,
    o.метка_объекта,
    -- Преобразование координат из масштабированного целочисленного формата обратно в десятичный
    t.latitude::float / 10000000 AS latitude,
    t.longitude::float / 10000000 AS longitude,
    t.speed,
    t.device_time
ОТ
    raw_telematics_data.tracking_data_core t
    JOIN raw_business_data.objects o ON t.device_id = o.device_id
ГДЕ
    t.device_time > (CURRENT_DATE - INTERVAL '1 day')
    AND t.latitude != 0
    AND t.longitude != 0
ORDER BY
    t.device_id, t.device_time DESC;
```

{% hint style="info" %}
Для повышения эффективности хранения в TimescaleDB значения координат хранятся в виде целых чисел, умноженных на 10^7. При выполнении запроса разделите их на 10000000, чтобы преобразовать обратно в стандартный десятичный формат.
{% endhint %}

## Объединение бизнес-данных и телематических данных

### Отчет об активности транспортного средства

Этот запрос формирует ежедневную сводку активности, объединяя бизнес-данные и телематические данные:

```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
ОТ
    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
ГДЕ
    t.device_time BETWEEN '2025-03-01' AND '2025-03-28'
ГРУППИРОВАТЬ ПО
    o.object_label, v.vehicle_type, DATE(t.device_time)
ORDER BY
    o.object_label, DATE(t.device_time);
```

### Назначения водителей и история местоположений

Отслеживайте, каким сотрудникам были назначены какие транспортные средства, и просматривайте историю их местоположения:

```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
ОТ 
    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
ORDER BY 
    assignment_time;
```

## Анализ данных датчиков

### Мониторинг уровня топлива

В этом запросе показано, как анализировать данные датчика уровня топлива:

```sql
SELECT
    o.object_label AS vehicle,
    t.device_time,
    i.value::numeric AS fuel_level
ОТ
    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
ГДЕ
    i.sensor_name = 'fuel'
    AND t.device_time > (CURRENT_DATE - INTERVAL '7 days')
ORDER BY
    o.object_label, t.device_time;
```

## Геопространственный анализ

### Транспорт в геозонах

Определите, какие транспортные средства въехали в определенные геозоны:

```sql
SELECT
    o.object_label AS vehicle,
    z.zone_label AS geozone,
    t.device_time AS entry_time
ОТ
    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
        -- Рассчитать, находится ли точка внутри круговой зоны
        -- Преобразовать координаты из масштабированных целых чисел в десятичные
        (
            Регистр
                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
            КОНЕЦ
        )
ГДЕ
    t.device_time > (CURRENT_DATE - INTERVAL '1 day')
ORDER BY
    z.zone_label, o.object_label, t.device_time;
```

{% hint style="info" %}
В этом запросе используются пространственные функции PostGIS. Если возникнут ошибки, убедитесь, что в базе данных включено расширение PostGIS.
{% endhint %}

## Советы по оптимизации производительности

При работе с Cloud Data Warehouse учитывайте следующие методы оптимизации:

1. **Используйте фильтрацию по времени**: Всегда включайте фильтр времени для `device_time` или `record_added_at` столбцов, чтобы ограничить объем сканируемых данных.\
   **Рекомендации**:

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

**Избегайте этого** (сканирует всю таблицу)

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

2. **Использование индексов**: В базе данных есть индексы по `(device_id, device_time)` пар. По возможности составьте запросы так, чтобы использовать эти индексы.
3. **Используйте объединения выборочно**: Объединяйте таблицы только при необходимости и старайтесь фильтровать данные до объединения больших таблиц.
4. **Преобразование целого числа в масштабированное значение**: Помните, что координаты хранятся в виде масштабированных целых чисел. Преобразуйте их только в итоговом SELECT, а не в условиях WHERE.
5. **Ограничение результирующих наборов**: Всегда используйте LIMIT в исследовательских запросах, чтобы избежать возврата миллионов строк.

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

6. **Использование иерархических связей**: Структурируйте сложные запросы в соответствии с иерархией сущностей (**поставщик телематических услуг → клиент → пользователь/устройство → объект**) для более эффективного объединения таблиц и фильтрации.
7. **Правильное управление подключениями**: Закрывайте подключения к базе данных, когда они не используются, особенно в BI-инструментах или запланированных скриптах, чтобы избежать блокировки ресурсов и проблем с тайм-аутами.

## Дальнейшие шаги

Эти примеры помогут вам начать работу с данными. По мере знакомства со схемой вы сможете создавать более сложные запросы, отвечающие конкретным потребностям вашего бизнеса.


---

# 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/ru/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.
