Как запустить запрос в 1С: пошаговая инструкция

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

Язык запросов 1С похож на SQL, но имеет собственный синтаксис и особенности: виртуальные таблицы, итоги, параметры с типом «Момент времени» и «Граница». Поэтому переносить готовые SQL-запросы напрямую нельзя — их нужно адаптировать. Ниже разобраны практические способы запуска с примерами кода и проверкой результата.

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

Способы запуска запроса: что выбрать под задачу

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

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

Запуск через консоль запросов

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

Порядок работы простой: вставьте текст запроса в поле, при необходимости заполните список параметров (консоль обычно находит их автоматически по символу «&»), нажмите кнопку выполнения. Результат отобразится в виде таблицы, которую можно свернуть по группировкам или выгрузить.

1. 1
   Откройте консоль запросов в режиме «Предприятие» через «Файл → Открыть» или из списка внешних обработок.
2. 2
   Вставьте текст запроса в поле редактора, например выборку справочника номенклатуры.
3. 3
   Проверьте список параметров: задайте значения для всех параметров, отмеченных символом «&».
4. 4
   Нажмите «Выполнить» и изучите таблицу результата: количество строк, значения полей, итоги.
5. 5
   При ошибке прочитайте текст сообщения — в нём указаны строка и причина: неверное имя поля, таблицы или тип параметра.

Типичный пример запроса для проверки — выборка элементов справочника:

ВЫБРАТЬ
Номенклатура.Ссылка,
Номенклатура.Наименование,
Номенклатура.Артикул
ИЗ
Справочник.Номенклатура КАК Номенклатура
ГДЕ
НЕ Номенклатура.ПометкаУдаления

Если запрос выполняется медленно, обратите внимание на виртуальные таблицы: параметры в них нужно задавать в скобках сразу после имени таблицы, а не в секции ГДЕ — это критично для производительности.

Программный запуск запроса из кода

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

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

Обратите внимание: параметры объявляются в тексте с символом «&», а устанавливаются методом УстановитьПараметр без этого символа. Если параметр не установлен, при выполнении возникнет ошибка. Для параметра типа «МоментВремени» или «Граница» значение нужно формировать соответствующими конструкторами, а не простой датой.

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

Конструктор запроса: как собрать текст без ошибок

Конструктор запроса вызывается из конфигуратора или из консоли: правой кнопкой по тексту модуля — «Конструктор запроса». В нём вы выбираете таблицы из списка объектов конфигурации, перетаскиваете нужные поля, настраиваете соединения, отборы, группировки и итоги. На выходе конструктор формирует корректный текст запроса.

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

После генерации текста вставьте его в консоль и проверьте на реальных данных: совпадает ли количество строк с ожидаемым, нет ли задвоений из-за соединения. Задвоение строк — частый признак того, что соединение выполнено по неуникальному полю.

Параметры, временные таблицы и пакетные запросы

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

Пакетный запрос — это несколько запросов в одном тексте, разделённые точкой с запятой. Типичный сценарий: сначала поместить отобранные документы во временную таблицу (ПОМЕСТИТЬ ВТ_Документы), затем соединить её с регистрами. Временные таблицы живут внутри одного объекта Запрос или в общем менеджере временных таблиц.

Для уничтожения временной таблицы после использования добавьте в пакет запрос УНИЧТОЖИТЬ ВТ_Документы. Это освобождает память сервера, что важно при массовых обработках.

Проверка результата и типичные ошибки

После выполнения запроса проверьте не только факт отсутствия ошибки, но и содержимое результата. Пустой результат — тоже результат: возможно, отбор слишком строгий или параметр периода задан неверно. Метод Результат.Пустой() помогает явно обработать эту ситуацию в коде.

Отдельная группа ошибок связана с правами: если у пользователя нет права «Чтение» на объект, запрос в режиме предприятия завершится ошибкой доступа. В коде это обходится установкой привилегированного режима (УстановитьПривилегированныйРежим(Истина)), но делать это нужно осознанно, чтобы не раскрыть данные, которые пользователю видеть не положено.

Отладка и ускорение медленных запросов

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

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

Часто задаваемые вопросы