Как передать таблицу значений в запрос в 1С

В языке запросов 1С нельзя напрямую обратиться к таблице значений как к параметру — запрос работает только с данными информационной базы и временными таблицами. Поэтому передача таблицы значений в запрос всегда выполняется в два этапа: сначала таблица значений помещается во временную таблицу с помощью конструкции ПОМЕСТИТЬ, затем эта временная таблица используется в основном запросе для соединений, отборов или группировок.

Такой подход применяется в типовых задачах: отбор документов по списку, сформированному программно; сравнение данных из файла с данными базы; расчёт по таблице, полученной из другого запроса или из внешнего источника. Механизм одинаково работает в обычных и управляемых формах, на толстом и тонком клиенте через серверный вызов.

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

Базовый принцип: временная таблица и ПОМЕСТИТЬ

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

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

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

Обратите внимание: имя параметра в тексте запроса (&ТаблицаДанных) и имя, переданное в УстановитьПараметр, должны совпадать. Сама таблица значений должна быть создана и заполнена до выполнения запроса.

Как правильно подготовить таблицу значений

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

ТаблицаДанных = Новый ТаблицаЗначений;
ТаблицаДанных.Колонки.Добавить("Номенклатура", Новый ОписаниеТипов("СправочникСсылка.Номенклатура"));
ТаблицаДанных.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(15, 3)));

Строка = ТаблицаДанных.Добавить();
Строка.Номенклатура = СсылкаНаНоменклатуру;
Строка.Количество = 10;

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

Роль менеджера временных таблиц

Временная таблица существует только внутри менеджера временных таблиц. Если создать временную таблицу одним запросом без менеджера, она будет уничтожена сразу после выполнения, и второй запрос её не увидит — типичная причина ошибки «Таблица не найдена».

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

1. 1
   Создайте таблицу значений с типизированными колонками и заполните данными
2. 2
   Создайте МенеджерВременныхТаблиц и назначьте его объекту Запрос
3. 3
   Напишите текст: ВЫБРАТЬ поля ПОМЕСТИТЬ ВТ ИЗ &ТЗ, затем основной запрос с соединением к ВТ
4. 4
   Передайте таблицу через УстановитьПараметр с тем же именем
5. 5
   Выполните запрос и проверьте результат выборкой или выгрузкой
6. 6
   После работы закройте менеджер временных таблиц

Типовые сценарии использования

Отбор по списку значений из таблицы

Когда нужно отобрать документы или остатки по списку, собранному программно, таблица значений соединяется с таблицей базы по ключевому полю. Это надёжнее, чем передача массива в условие В (&Список), если помимо ключа нужны дополнительные данные — количество, цена, признак обработки.

Сравнение внешних данных с базой

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

Многократное использование одной временной таблицы

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

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

Передача таблицы значений во временную таблицу — это физическая выгрузка данных на сервер СУБД. При объёмах в сотни тысяч строк операция занимает заметное время и память, поэтому не стоит передавать «на всякий случай» лишние колонки и строки — отсекайте их до запроса.

По умолчанию временная таблица создаётся без индексов. Если по ней выполняется соединение с крупной таблицей базы, добавьте индекс в конструкции ПОМЕСТИТЬ с помощью предложения ИНДЕКСИРОВАТЬ ПО — это заметно ускоряет соединение на больших объёмах.

// Фрагмент текста запроса с индексом:
// ПОМЕСТИТЬ ВТ_Данные
// ИЗ &ТаблицаДанных КАК ТЗ
// ИНДЕКСИРОВАТЬ ПО
// ТЗ.Номенклатура

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

Частые ошибки и их диагностика

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

FAQ