Как написать запрос в 1С 8.3: руководство с примерами

Язык запросов — основной способ получения данных в 1С 8.3: через него строятся отчёты, обработки, динамические списки и проверки внутри проведения документов. Синтаксис напоминает SQL, но оперирует объектами конфигурации — справочниками, документами, регистрами, — а не физическими таблицами базы данных. Это снимает с разработчика заботу о структуре хранения, но требует понимания виртуальных таблиц и типовых конструкций платформы.

Написать рабочий запрос можно двумя путями: вручную в модуле или через конструктор запроса, который генерирует текст по выбранным полям и условиям. Для простых выборок достаточно конструктора, для сложных отчётов с виртуальными таблицами и итогами нужно понимать синтаксис. Ниже разобраны оба подхода, структура запроса, работа с параметрами, соединения, итоги и типичные ошибки.

Где пишутся запросы и как устроен объект Запрос

Текст запроса размещается в модуле — документа, обработки, отчёта или общем модуле. Сам по себе текст — просто строка; выполняет его объект встроенного языка Запрос. Минимальный порядок работы: создать объект, присвоить свойству Текст строку с запросом, установить параметры через УстановитьПараметр(), вызвать Выполнить() и обработать результат через Выбрать() или Выгрузить().

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

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Номенклатура.Ссылка КАК Товар,
| Номенклатура.Наименование КАК Наименование
|ИЗ
| Справочник.Номенклатура КАК Номенклатура
|ГДЕ
| Номенклатура.Родитель = &Группа";
Запрос.УстановитьПараметр("Группа", ГруппаТоваров);
Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
 Сообщить(Выборка.Наименование);
КонецЦикла;

Как собрать запрос конструктором

Конструктор запроса — встроенный визуальный инструмент конфигуратора. Он избавляет от необходимости помнить точные имена таблиц и полей и снижает количество синтаксических ошибок. Чтобы открыть его, установите курсор внутрь строки с текстом запроса (или в пустое место модуля), нажмите правую кнопку мыши и выберите «Конструктор запроса».

1. 1
   Откройте модуль, поставьте курсор в нужное место, вызовите конструктор запроса через контекстное меню
2. 2
   На закладке «Таблицы и поля» выберите источник данных слева и перенесите нужные поля в список полей
3. 3
   На закладке «Условия» задайте отбор, используя параметры вида &ИмяПараметра
4. 4
   При необходимости настройте закладки «Связи», «Группировка», «Порядок», «Итоги»
5. 5
   Нажмите «ОК» — конструктор вставит готовый текст запроса в модуль
6. 6
   Запустите отладку (F5) и проверьте результат на тестовых данных

Конструктор закрывает большинство задач: выборки из справочников и документов, обращение к виртуальным таблицам регистров, соединения и группировки. Ограничение — он не заменяет понимания логики: при неправильном типе соединения или отсутствии отбора в виртуальной таблице конструктор честно сгенерирует медленный или неверный запрос.

Базовый синтаксис: ВЫБРАТЬ, ИЗ, ГДЕ

Минимальный запрос состоит из секции ВЫБРАТЬ со списком полей и секции ИЗ с указанием источника. Источник записывается через тип объекта и имя: Справочник.Номенклатура, Документ.РеализацияТоваровУслуг, РегистрНакопления.ОстаткиТоваров. После имени таблицы принято указывать псевдоним через КАК — это делает текст читаемым и обязательно при соединениях.

Условия задаются в секции ГДЕ. Операторы сравнения стандартные: =, <>, >, <, а также В для списков и ПОДОБНО для поиска по шаблону строки. Логика объединяется через И, ИЛИ, НЕ. Порядок строк определяет секция УПОРЯДОЧИТЬ ПО, ограничение количества — ВЫБРАТЬ ПЕРВЫЕ 100.

Для проверки заполненности ссылочных полей используйте сравнение со значением ЗНАЧЕНИЕ(Справочник.Номенклатура.ПустаяСсылка). Проверка на NULL уместна только после соединений: Поле ЕСТЬ NULL.

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

Параметры — именованные места в тексте запроса, начинающиеся с символа &: &Период, &Склад. Они выполняют две функции: защищают от подстановки непроверенных данных в текст и позволяют платформе оптимизировать выполнение. Прямая конкатенация значений в строку запроса — грубая ошибка: она ломает план выполнения и создаёт риск некорректной выборки.

Значение передаётся методом Запрос.УстановитьПараметр("Имя", Значение) до вызова Выполнить(). В параметр можно передать примитивные типы, ссылки, даты, а также массивы и списки значений — последние используются с оператором В (&Список). Передача таблицы значений в параметр возможна только для временных таблиц через менеджер временных таблиц.

Виртуальные таблицы регистров

Остатки и обороты получают не из физических таблиц регистров, а из виртуальных: РегистрНакопления.ТоварыНаСкладах.Остатки, РегистрНакопления.Продажи.Обороты, РегистрСведений.ЦеныНоменклатуры.СрезПоследних. Виртуальная таблица принимает параметры в скобках — период и условия, например: Остатки(&Дата, Склад = &Склад).

Ключевое правило производительности: условия на измерения передавайте в параметры виртуальной таблицы, а не в секцию ГДЕ всего запроса. Фильтр в параметрах отсекает данные на этапе расчёта виртуальной таблицы; фильтр в ГДЕ заставляет платформу сначала вычислить остатки по всей базе, а потом отбрасывать лишнее — на больших регистрах разница по времени многократная.

Соединения и объединения таблиц

Соединения собирают данные из нескольких источников по ключу. В языке запросов 1С доступны ЛЕВОЕ СОЕДИНЕНИЕ, ПРАВОЕ, ВНУТРЕННЕЕ и ПОЛНОЕ. На практике чаще всего нужны два: внутреннее — когда нужны только совпадающие записи, левое — когда основная таблица должна сохраниться полностью, а данные правой могут отсутствовать (тогда её поля будут NULL).

Условие связи пишется в секции ПО: ПО Товары.Номенклатура = Цены.Номенклатура. Отсутствие или неполнота условия связи — классическая причина «дублирования» строк: декартово произведение перемножает каждую строку левой таблицы на каждую строку правой.

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

Группировки, итоги и проверка результата

Агрегирование выполняется функциями СУММА, КОЛИЧЕСТВО, СРЕДНЕЕ, МАКСИМУМ, МИНИМУМ вместе с секцией СГРУППИРОВАТЬ ПО. Правило: все поля в списке выборки либо входят в группировку, либо обёрнуты агрегатной функцией. Условие на агрегаты задаётся через ИМЕЮЩИЕ, а не ГДЕ.

Иерархические итоги формируются секцией ИТОГИ ПО — например, ИТОГИ СУММА(Сумма) ПО Склад. Тогда результат выгружается деревом, и по нему можно обойти группы и детальные записи. Для отчётов на СКД итоги обычно настраиваются в схеме компоновки, а в тексте запроса секцию ИТОГИ опускают.

Для отладки удобна консоль запросов — внешняя обработка, позволяющая выполнить текст запроса с параметрами и увидеть результат без запуска всей конфигурации. Также полезно временно убирать части запроса (соединения, условия), чтобы локализовать, на каком шаге появляются дубли или пропадают строки.

Частые вопросы