---
title: "Запросы"
id: "1342"
type: "page"
slug: "queries"
published_at: "2026-08-15T23:32:28+00:00"
modified_at: "2026-08-16T11:37:09+00:00"
url: "https://pastukhov.com/analytics-agent/docs/queries"
markdown_url: "https://pastukhov.com/analytics-agent/docs/queries.md"
excerpt: "Блоки данных работают через SQL-запросы к подключённым источникам. Запрос описывается в конфигурации блока, проверяется до…"
---

# Запросы

[https://pastukhov.com/analytics-agent/docs/queries.md](https://pastukhov.com/analytics-agent/docs/queries.md)

Блоки данных работают через SQL-запросы к подключённым источникам. Запрос описывается в конфигурации блока, проверяется до выполнения и кэшируется.

## Выполнение и проверка

- выполнение — `POST /api/query/execute` к любому подключённому источнику;
- проверка до выполнения — `POST /api/query/validate`: синтаксис, колонки, источники;
- у запроса есть таймаут (30 000 мс по умолчанию) и лимит строк (10 000 по умолчанию) — защита от случайных «SELECT * FROM огромная_таблица»;
- описание запроса поддерживает Scriban-переменные документа.

## Кэширование

- кэш результатов ускоряет повторные открытия отчёта;
- статистика кэша — `GET /api/query/cache/statistics`;
- очистка — `POST /api/query/cache/clear`.

## Серверные вычисления

Тяжёлая аналитика считается на сервере: гистограммы (`POST /api/query/histogram`) и box plot (`POST /api/query/boxplot`) не гоняют данные в клиент целиком — на клиент уходит готовый результат.

## Привязка к блоку

Запрос живёт в конфигурации блока и привязывается по `queryId`. Валидатор проверяет существование запроса и его источника — подробнее в разделе [Проверки и авто-коррекция](/analytics-agent/docs/validation)
.

## ИИ и производительность

Не хотите писать SQL? Опишите словами, что нужно — ИИ напишет или исправит запрос (подробнее — [ИИ-агент в отчёте](/analytics-agent/docs/agent)
). Рекомендации по производительности: фильтруйте по датам, считайте агрегаты в SQL, а не в блоке, и используйте лимит строк.

[← Оглавление документации](/analytics-agent/docs)