Передача временной таблицы в параметр запроса 1С

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

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

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

Концепция передачи табличных данных в запрос

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

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

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

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

Синтаксис и объявление параметров в тексте запроса

Для корректной работы механизма необходимо правильно оформить текст запроса. Параметр, принимающий таблицу, объявляется в секции параметров или непосредственно в теле запроса в зависимости от контекста. Однако, наиболее важным аспектом является то, как вы обращаетесь к этому параметру внутри условия ГДЕ или СОЕДИНЕНИЕ.

В языке запросов 1С нет явного ключевого слова для объявления типа "таблица" в параметрах, как в некоторых других СУБД. Вместо этого вы просто используете имя параметра, и система определяет его тип по переданному объекту. Если вы передаете таблицу значений, то в запросе вы можете обращаться к её полям так, как будто это обычная таблица. Синтаксис выглядит следующим образом:

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

Здесь &ПараметрТаблица — это имя параметра, в который мы передадим объект ТаблицаЗначений. Обратите внимание на точку после имени параметра: она указывает на обращение к конкретной колонке внутри переданной таблицы. Это позволяет делать фильтрацию по конкретному полю, игнорируя остальные, если они есть.

Также возможен вариант использования псевдонима для параметра-таблицы в секции ИЗ, если требуется полноценное соединение (JOIN). В этом случае параметр выступает в роли правой таблицы соединения. Это дает больше гибкости, позволяя выбирать поля не только из основной таблицы, но и из переданного набора данных.

• 🔹 Используйте точечную нотацию (&Параметр.Поле) для фильтрации в условии ГДЕ.
• 🔹 Применяйте псевдонимы для параметра-таблицы при выполнении соединений JOIN.
• 🔹 Убедитесь, что имена полей в таблице значений совпадают с именами полей в запросе (регистронезависимо).

Особенности работы с NULL

Если в колонке переданной таблицы значений есть значения НЕОПРЕДЕЛЕНО, они будут участвовать в сравнении. Будьте внимательны при фильтрации, так как условие "Равно НЕОПРЕДЕЛЕНО" работает иначе, чем в стандартном SQL.

Создание и заполнение Таблицы Значений в коде

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

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

Рассмотрим пример, где мы формируем список ссылок на документы для последующей выборки их движений. Мы создаем таблицу с одной колонкой "ДокументСсылка", заполняем её и передаем в запрос. Тип колонки должен быть указан явно, желательно с использованием предопределенных типов или типа Строка фиксированной длины, если это идентификаторы.

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

Для Каждого Элемент Из МассивЭлементов Цикл
НоваяСтрока = ТаблицаПараметр.Добавить();
НоваяСтрока.Ссылка = Элемент.Ссылка;
КонецЦикла;

Запрос = Новый Запрос(ТекстЗапроса);
Запрос.УстановитьПараметр("ПараметрТаблица", ТаблицаПараметр);

Обратите внимание на использование ТипОписанияТипов. Это позволяет задать точный тип данных, что исключает ошибки приведения типов на уровне СУБД. Если тип указан неверно или слишком обобщенно (например, просто Строка вместо СправочникСсылка), сервер 1С может выполнить дополнительное преобразование данных перед передачей в базу, что негативно скажется на производительности.

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

Оптимизация производительности при больших объемах

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

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

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

Объем данных	Рекомендуемый метод	Риски
До 1 000 строк	Параметр-таблица	Минимальные
1 000 - 10 000 строк	Параметр-таблица	Рост времени выполнения
Более 10 000 строк	Временная таблица на сервере	Блокировки, нагрузка на диск
Миллионы строк	Регистр сведений / Таблица БД	Требует управления жизненным циклом

Для очень больших массивов данных (сотни тысяч строк) рассмотрите альтернативу: запись данных во временную таблицу на стороне СУБД через отдельный запрос ВЫБРАТЬ.. ВTempTable или использование регистра сведений с признаком "Ведение итогов" отключенным. Это позволит базе данных использовать свои механизмы оптимизации и статистики.

Обработка ошибок и отладка запросов

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

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

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

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

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

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

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

В этом примере мы создаем таблицу с одной колонкой "Склад", заполняем её выбранными элементами и передаем в запрос. Запрос соединяет таблицу остатков с нашей таблицей параметров, возвращая только нужные записи. Это делает код чистым, читаемым и независимым от количества выбранных складов.

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

Запрос = Новый Запрос(ТекстЗапроса);
Запрос.УстановитьПараметр("СписокСкладов", ТаблицаСкладов);
Результат = Запрос.Выполнить();

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

Расширенный пример

Вы можете передавать таблицу значений с несколькими колонками (например, Склад и Период) и использовать сложное условие соединения ПО Склад =.. И Период =.., что позволяет реализовывать многофакторную фильтрацию в одном запросе.

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

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

Есть ли ограничение на количество строк в таблице параметра?

Жесткого программного ограничения нет, оно зависит от доступной оперативной памяти сервера 1С и настроек кластера. Однако на практике передача более 50-100 тысяч строк в одном параметре считается плохой практикой из-за риска таймаутов и блокировок.

Как передать таблицу значений в хранимую процедуру на стороне SQL?

Напрямую через механизм параметров запроса 1С передать таблицу в хранимую процедуру SQL нельзя. Для этого нужно сначала записать данные во временную таблицу СУБД (через запрос 1С с помещением в TempDB), а затем передать имя этой таблицы или выбрать из неё данные внутри хранимой процедуры.

Влияет ли порядок колонок в Таблице Значений на работу запроса?

Нет, порядок колонок в объекте ТаблицаЗначений не важен. Связь между данными и запросом осуществляется по именам колонок. Главное, чтобы имя колонки в таблице значений совпадало с именем, используемым в запросе после точки.

Можно ли использовать таблицу значений для вставки данных (INSERT)?

В языке запросов 1С конструкция ВСТАВИТЬ не поддерживает прямую вставку из параметра-таблицы в одну команду. Обычно делают выборку из параметра-таблицы (ВЫБРАТЬ.. ИЗ &Параметр) и вставляют результат этой выборки в целевую таблицу.