Как получить запрос из СКД в 1С

Работа с отчетами в платформе 1С:Предприятие часто требует понимания того, какой именно SQL-запрос формируется системой. Разработчикам и аналитикам необходимо видеть «под капот» отчетов для оптимизации производительности или отладки сложных выборок. Стандартный интерфейс конструктора запросов скрывает итоговый текст, генерируемый движком схемы компоновки данных (СКД).

Существует несколько проверенных способов извлечь этот скрытый код. Вы можете воспользоваться встроенными средствами отладки в конфигураторе, проанализировать логи сервера или обратиться к объектной модели напрямую через код. Выбор конкретного метода зависит от вашей цели: разовая проверка или программная доработка функционала.

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

Использование режима отладки в Конфигураторе

Самый простой и наглядный способ увидеть текст запроса — запустить отчет в режиме отладки непосредственно из среды разработки. Для этого вам необходимо открыть конфигурацию в режиме Конфигуратор и найти нужный объект метаданных.

Перейдите в дерево конфигурации и найдите ваш отчет. Обычно он расположен в ветке Отчеты. Дважды кликните на объект, чтобы открыть его форму. В верхней панели инструментов нажмите кнопку Отладка (или нажмите клавишу F10).

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

Найдите в логе строки, содержащие вызов метода СкомпоноватьРезультат. Рядом с этим вызовом или в деталях выполнения будет отображен сгенерированный текст запроса к базе данных. Это наиболее точный вариант, так как показывает запрос именно в том виде, в котором он ушел на сервер СУБД.

⚠️ Внимание: Режим отладки значительно замедляет работу системы. Не используйте его на продуктивной базе с большим объемом данных, так как это может привести к зависанию сеансов у других пользователей.

Просмотр запроса через панель администрирования

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

Необходимо включить регистрацию технологического журнала (ТЖ) на сервере 1С. В файле конфигурации сервера ragent.cfg или через консоль управления кластером серверов задайте параметры логирования. Вам нужно включить логирование событий CALL и EXCP.

После включения логирования воспроизведите формирование отчета в клиентском приложении. Затем откройте файлы логов, расположенные в каталоге log рабочего каталога сервера 1С. Файлы имеют расширение .lgp и могут быть открыты любым текстовым редактором.

В тексте лога ищите блоки, связанные с выполнением запросов. Система 1С выводит текст запроса перед его отправкой в СУБД. Обратите внимание, что в логах могут присутствовать служебные таблицы и временные наборы данных, созданные платформой.

• 🔍 Ищите ключевые слова ВЫБРАТЬ или SELECT в начале строки лога.
• ⚙️ Убедитесь, что уровень детализации лога установлен на Debug или Info.
• 📂 Файлы логов могут быстро расти в размерах, поэтому вовремя очищайте архив.

Программное получение текста запроса

Для автоматизации процесса или создания инструментов анализа часто требуется получить текст запроса программно. Объект КомпоновщикНастроек предоставляет методы для формирования макета компоновки, из которого можно извлечь исходный запрос.

Основной алгоритм действий заключается в создании экземпляра обработчика компоновки данных. Затем необходимо вызвать метод СкомпоноватьРезультат, передав ему пустую таблицу результатов. После этого объект обработчика будет содержать сформированный запрос.

Ниже приведен пример кода на встроенном языке 1С, который демонстрирует этот процесс. Обратите внимание на использование объекта ОбработчикКомпоновкиДанных.

Компоновщик = Новый КомпоновщикНастроек;
Компоновщик.Инициализировать(ИмяМакетаКомпоновки);

Обработчик = Новый ОбработчикКомпоновкиДанных;
Обработчик.Инициализировать(Компоновщик, , Истина);

// Формируем запрос, но не выполняем выборку данных
Запрос = Обработчик.СкомпоноватьРезультат(Новый ТаблицаЗначений, , Ложь);

// Получаем текст запроса
ТекстЗапроса = Запрос.Текст;
Сообщить(ТекстЗапроса);

Использование флага Ложь в методе СкомпоноватьРезультат критически важно. Он указывает системе, что не нужно выполнять сам запрос к базе данных, а нужно лишь подготовить объектную модель запроса. Это позволяет получить текст мгновенно, даже если выборка должна вернуть миллионы записей.

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

Анализ параметров и временных таблиц

При получении запроса из СКД вы заметите, что он отличается от простого запроса, написанного вручную. Система активно использует временные таблицы и параметры для реализации логики отчета. Понимание этой структуры необходимо для правильной интерпретации кода.

СКД разбивает сложный отчет на несколько подзапросов. Каждый набор данных может быть представлен как отдельная временная таблица. В итоговом запросе эти таблицы объединяются с помощью операторов ОБЪЕДИНИТЬ ВСЕ или вложенных выборок.

Параметры, определенные в схеме компоновки, заменяются на конкретные значения или остаются как параметры запроса 1С. В тексте запроса они будут выглядеть как &Параметр1, &ПериодС и так далее. Значения этих параметров подставляются драйвером 1С перед отправкой в СУБД.

Элемент СКД	Отражение в запросе	Назначение
Набор данных	Временная таблица (#Таблица1)	Промежуточное хранение выборки
Параметр	&ИмяПараметра	Фильтрация данных пользователем
Поле	ИмяПоля.Представление	Выводимое значение в колонке
Группировка	GROUP BY	Агрегация данных по уровням

Наличие большого количества временных таблиц может свидетельствовать о сложности отчета. Однако иногда это признак неоптимальной настройки. Если вы видите создание временной таблицы только для того, чтобы сразу выбрать из нее все данные без фильтрации, это повод проверить настройки схемы.

Почему запрос такой длинный?

СКД генерирует универсальный код, который должен работать при любых вариантах отбора и группировки, выбранных пользователем. Поэтому он заранее готовит все возможные ветви выборки.

Особенности формирования запросов для разных СУБД

Текст запроса, который вы получаете из СКД, может различаться в зависимости от типа используемой системы управления базами данных. Платформа 1С адаптирует синтаксис под особенности Microsoft SQL Server, PostgreSQL или Oracle.

Например, функции работы с датами или строками могут иметь разные имена. В запросе для PostgreSQL вы увидите DATE_TRUNC, тогда как для MS SQL это будет DATEADD или DATEDIFF. СКД автоматически подставляет нужные функции при компиляции запроса.

Также различается синтаксис временных таблиц. В MS SQL используются таблицы в памяти tempdb (префикс #), в PostgreSQL — обычные временные таблицы сессионного уровня. При анализе текста запроса учитывайте эту специфику, если планируете запускать его вне платформы 1С.

⚠️ Внимание: Копирование запроса из отладчика 1С и попытка выполнить его напрямую в консольном клиенте СУБД (например, pgAdmin или SSMS) часто приводит к ошибкам. Это связано с отсутствием контекста временных таблиц и специфическими функциями 1С.

Для корректного тестирования производительности лучше использовать встроенные средства 1С, такие как ЗамерПроизводительности, или выполнять запрос через объект Запрос в том же сеансе, где были созданы временные таблицы.

Оптимизация и типичные ошибки

Получив текст запроса, разработчик часто хочет его оптимизировать. Однако прямое редактирование сгенерированного кода невозможно, так как он формируется динамически. Оптимизация должна проводиться на уровне настроек схемы компоновки данных.

Частой ошибкой является использование полей, не индексируемых в базе данных, в условиях отбора. В тексте запроса это выглядит как вызов функций над полями в секции WHERE. Например, ГОД(Дата) = 2026 вместо диапазона дат. Это приводит к полному сканированию таблицы.

Еще одна проблема — избыточные соединения. Если в отчете подключены наборы данных, которые не используются в полях или отборах, они все равно могут участвовать в формировании промежуточных таблиц. Проверьте вкладку «Наборы данных» в конструкторе СКД.

• 🚀 Используйте диапазоны значений вместо функций в отборах.
• 🗑️ Удаляйте неиспользуемые наборы данных из схемы.
• 📊 Проверяйте, что поля группировки соответствуют индексам БД.

Анализ плана выполнения запроса, доступный в инструментах администратора СУБД, дает наиболее полное представление о проблемах производительности. Сопоставляйте план выполнения с текстом запроса, полученным из 1С, чтобы находить узкие места.

Можно ли изменить текст запроса вручную?

Нет, текст запроса генерируется движком СКД автоматически на основе настроек схемы. Прямое редактирование невозможно. Для изменения логики выборки необходимо править саму схему компоновки данных: добавлять отборы, менять поля или наборы данных.

Почему в запросе много временных таблиц?

Это особенность работы СКД. Система строит запрос модульно: каждый уровень группировки или каждый набор данных часто выносится во временную таблицу для обеспечения гибкости формирования итогов и промежуточных итогов.

Как получить запрос в управляемом приложении?

В тонком клиенте нет режима отладки, как в конфигураторе. Используйте технологический журнал на сервере или напишите внешнюю обработку, которая использует метод СкомпоноватьРезультат с параметром Ложь, как описано в разделе про программирование.

Влияет ли версия платформы на текст запроса?

Да, с выходом новых версий 1С:Предприятие алгоритмы генерации запросов могут меняться для улучшения производительности. Запрос, полученный на версии 8.3.20, может отличаться от запроса на версии 8.3.10 для той же самой схемы отчета.