Разработка сложных отчетов и обработок в платформе 1С:Предприятие 8 часто требует использования многоступенчатой выборки данных. Когда логика получения информации выходит за рамки простого SELECT, разработчик сталкивается с необходимостью встраивать одни запросы внутрь других. Ключевым моментом здесь становится корректная передача значений из внешнего контекста внутрь вложенной структуры.

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

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

Основы языка запросов и область видимости

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

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

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

⚠️ Внимание: При использовании вложенных запросов в тексте всегда проверяйте, что имена параметров не конфликтуют с именами полей таблиц. Идентификаторы регистров сведений или документов могут "перекрыть" имя вашего параметра, что приведет к ошибке выполнения.

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

📊 Какой способ передачи параметров вы используете чаще всего?
Прямая подстановка в текст
Параметры объекта Запрос
Временные таблицы
СКД (Схема компоновки)
Затрудняюсь ответить

Использование параметров объекта Запрос

Самый надежный и рекомендуемый способ передачи данных — использование штатных параметров объекта Запрос. Этот метод обеспечивает защиту от SQL-инъекций (хотя в 1С это менее актуально, чем в вебе, но важно для типизации) и позволяет платформе оптимизировать план выполнения.

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

Рассмотрим пример, где нам нужно выбрать документы, суммы которых больше значения, переданного извне, причем проверка происходит внутри вложенного запроса группировки:

ВЫБРАТЬ

РегистрНакопления.Продажи.Документ.Ссылка КАК Документ,


СУММА(РегистрНакопления.Продажи.Сумма) КАК Сумма


ИЗ


РегистрНакопления.Продажи КАК Продажи


ГДЕ


Продажи.Период МЕЖДУ &НачалоПериода И &КонецПериода


СГРУППИРОВАТЬ ПО


Продажи.Документ.Ссылка


ИМЕЮЩИЕ


СУММА(Продажи.Сумма) > &МинимальнаяСумма

В данном случае параметры &НачалоПериода, &КонецПериода и &МинимальнаяСумма передаются из внешней программы. В коде на встроенном языке 1С это реализуется следующим образом:

Запрос = Новый Запрос(ТекстЗапроса);

Запрос.УстановитьПараметр("НачалоПериода", НачалоДня(ДатаНачала));


Запрос.УстановитьПараметр("КонецПериода", КонецДня(ДатаКонца));


Запрос.УстановитьПараметр("МинимальнаяСумма", 10000);


Результат = Запрос.Выполнить();

Такой подход гарантирует, что типы данных будут проверены платформой. Если вы попытаетесь передать строку вместо числа в параметр &МинимальнаяСумма, система выдаст понятную ошибку еще до начала выполнения выборки.

💡

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

Вложенные SELECT и псевдонимы таблиц

Ситуация усложняется, когда вложенный запрос представляет собой отдельный блок ВЫБРАТЬ... ИЗ (ВЫБРАТЬ...). В таких конструкциях важно правильно организовать связь между внешним и внутренним контекстом через псевдонимы.

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

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

  • 🔹 Используйте псевдонимы для каждой вложенной таблицы, чтобы избежать путаницы в полях.
  • 🔹 Проверяйте типы возвращаемых данных во вложенном запросе — они должны соответствовать ожидаемым во внешнем.
  • 🔹 Избегайте избыточных вложений: если запрос можно переписать с помощью ЛЕВОЕ СОЕДИНЕНИЕ, сделайте это для улучшения производительности.

При работе с вложенными SELECT помните, что область видимости параметров объекта Запрос распространяется на весь текст запроса целиком, независимо от уровня вложенности скобок. Это упрощает задачу, но требует дисциплины в именовании.

Тип конструкции Доступность параметров Рекомендуемое использование
Одинарный SELECT Полная Простые выборки, отчеты
Вложенный SELECT (подзапрос) Полная (глобальная для запроса) Фильтрация по агрегированным данным
Временная таблица Через результат предыдущего шага Многоступенчатая обработка
СКД (Макет) Через набор данных Пользовательские отчеты

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

☑️ Оптимизация вложенного запроса

Выполнено: 0 / 4

Работа с временными таблицами

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

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

Синтаксис создания временной таблицы в 1С позволяет сразу задать структуру и заполнить её данными. Это особенно полезно, когда нужно передать во вложенный запрос не скалярное значение, а целый список идентификаторов.

// Этап 1: Формирование временной таблицы с параметрами

ВЫБРАТЬ


Номенклатура.Ссылка,


Номенклатура.Наименование


ПОМЕСТИТЬ ВТ_НоменклатураДляОтчета


ИЗ


Справочник.Номенклатура КАК Номенклатура


ГДЕ


Номенклатура.ВидНоменклатуры = &ВидНоменклатуры


;



// Этап 2: Использование временной таблицы во вложенном запросе


ВЫБРАТЬ


Продажи.Номенклатура,


СУММА(Продажи.Количество) КАК ОбщееКоличество


ИЗ


РегистрНакопления.Продажи КАК Продажи


ВНУТРЕННЕЕ СОЕДИНЕНИЕ ВТ_НоменклатураДляОтчета КАК ВТ


ПО Продажи.Номенклатура = ВТ.Ссылка


ГДЕ


Продажи.Период >= &ДатаНачала


СГРУППИРОВАТЬ ПО


Продажи.Номенклатура

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

⚠️ Внимание: Временные таблицы существуют только в рамках одной сессии базы данных и удаляются автоматически при завершении соединения или транзакции. Не пытайтесь обратиться к временной таблице из другого сеанса 1С или после завершения выполнения текущего пакета запросов.

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

Ограничения временных таблиц

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

Специфика Системы Компоновки Данных (СКД)

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

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

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

  • 📊 Объявляйте параметры в корневом элементе схемы компоновки данных для глобального доступа.
  • 📊 Используйте параметризированные выражения в условиях ГДЕ вложенных запросов.
  • 📊 Проверяйте тип параметра в настройках СКД — он должен совпадать с типом поля в базе данных.

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

Для передачи значения из одного набора данных в запрос другого используется механизм "Параметры" в свойствах набора данных. Вы можете сопоставить поле из первого набора с параметром запроса второго набора.

💡

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

Отладка и поиск ошибок передачи

Несмотря на строгую типизацию 1С, ошибки при передаче параметров во вложенные запросы случаются регулярно. Чаще всего это связано с несоответствием типов или неправильным именованием.

Первым инструментом диагностики должна стать Консоль запросов. Она позволяет выполнить текст запроса изолированно от кода обработки и увидеть реальную ошибку СУБД. Если запрос выполняется в консоли при ручной подстановке значений, но не работает в коде — проблема в передаче параметров.

Обращайте внимание на сообщения об ошибках. Фраза "Неизвестный идентификатор" чаще всего указывает на опечатку в имени параметра (например, &ДатаН вместо &ДатаНачала). Ошибка "Преобразование типа" говорит о том, что вы пытаетесь сравнить строку с числом или дату со строкой без явного приведения.

Попытка

Результат = Запрос.Выполнить();


Исключение


Сообщить("Ошибка выполнения запроса: " + ОписаниеОшибки());


// Логирование параметров для анализа


Для Каждого Параметр Из Запрос.Параметры Цикл


Сообщить(Параметр.Имя + ": " + ТипЗнч(Параметр.Значение));


КонецЦикла;


КонецПопытки;

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

⚠️ Внимание: Интерфейс и возможности Консоли Запросов могут отличаться в разных версиях платформы 1С:Предприятие. В некоторых конфигурациях доступ к консоли может быть ограничен правами доступа. Уточняйте актуальные возможности в документации к вашей версии платформы.

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

Можно ли передать массив значений в параметр запроса 1С?

Да, в параметр запроса можно передать массив. В тексте запроса такой параметр будет развернут в список значений для оператора В (IN). Например: ГДЕ Ссылка В (&МассивСсылок). Платформа автоматически обработает массив и подставит значения.

Почему параметр не виден во вложенном запросе внутри СКД?

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

Как передать текущую дату в параметр вложенного запроса?

Используйте функцию СЕГОДНЯ() или ТЕКУЩАЯДАТА() в коде 1С при установке параметра: Запрос.УстановитьПараметр("Дата", ТекущаяДата()). В тексте запроса используйте объявленный параметр &Дата.

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

Использование параметров (в отличие от прямой конкатенации строк) позволяет СУБД кэшировать план выполнения запроса, что обычно повышает производительность при частом вызове с разными значениями. Однако избыточное количество параметров может усложнить компиляцию запроса.

Можно ли использовать результат вложенного запроса как параметр для другого запроса?

Напрямую — нет. Результат запроса — это набор строк. Вы можете сохранить его во временную таблицу и затем использовать эту таблицу в следующем запросе, либо выбрать одно значение (через ВЫБРАТЬ ПЕРВЫЕ 1) и присвоить его переменной языка 1С для передачи в следующий запрос.