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

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

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

Архитектура взаимодействия запроса и табличного параметра

Механизм работы основан на возможности платформы передавать в текст запроса ссылку на объект типа ТаблицаЗначений. Когда интерпретатор 1С встречает в тексте запроса имя такого параметра, он автоматически создает временную таблицу в базе данных (или использует параметры запроса, в зависимости от версии платформы и типа СУБД), наполняет её данными и подключает к основному тексту выборки. Это позволяет использовать конструкцию ВЫБРАТЬ ... ИЗ &ПараметрТаблица так же легко, как и из обычной справочной таблицы.

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

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

⚠️ Внимание: Размер передаваемой таблицы значений не безграничен. При передаче огромных массивов данных (сотни тысяч строк) через параметры запроса может наблюдаться деградация производительности из-за накладных расходов на сериализацию и передачу данных между клиентом и сервером 1С, а затем в СУБД.

Синтаксис и методы подключения в тексте запроса

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

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

ВЫБРАТЬ
ДокументыРеализация.Ссылка,
ДокументыРеализация.Дата
ИЗ
&ТаблицаНомеров КАК ТаблицаНомеров
ЛЕВОЕ СОЕДИНЕНИЕ РегистрНакопления.Продажи КАК Продажи
ПО ТаблицаНомеров.НомерДокумента = Продажи.ДокументПродажи

Обратите внимание на использование псевдонимов. Поскольку имя параметра может быть длинным, в самом запросе удобно использовать короткий псевдоним (как ТаблицаНомеров в примере выше) для улучшения читаемости кода. Это особенно актуально при построении сложных запросов с множественными соединениями.

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

Наиболее частый сценарий использования — это фильтрация по списку элементов, который пользователь выбрал в интерфейсе. Вместо того чтобы генерировать огромный текст запроса с конструкцией В (Значение1, Значение2, ...), что имеет лимиты на длину строки запроса в некоторых СУБД, мы передаем компактную таблицу. Это делает код чище и устойчивее к нагрузкам.

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

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

Сравнение производительности: Таблица значений vs Временные таблицы

Часто возникает вопрос: что лучше использовать — параметр-таблицу значений или явную временную таблицу? Разница заключается в жизненном цикле данных. Параметр существует только в контексте выполнения одного конкретного запроса и не занимает место в постоянной базе данных (хранится в оперативной памяти или temp-сегменте СУБД на время выполнения).

Временные таблицы, создаваемые через ВЫБРАТЬ ... ПОМЕСТИТЬ, физически существуют в базе данных до конца сеанса или явного удаления. Они полезны, когда одни и те же промежуточные данные нужно использовать в нескольких разных запросах последовательно. Если же данные нужны только для одной выборки, параметр-таблица предпочтительнее.

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

Характеристика	Параметр (Таблица Значений)	Временная таблица
Область видимости	Только внутри одного запроса	Весь сеанс или до удаления
Накладные расходы	Минимальные (передача в память)	Высокие (запись на диск/в temp)
Повторное использование	Невозможно без повторной передачи	Возможно в нескольких запросах
Индексация	Автоматическая (зависит от СУБД)	Можно управлять вручную

Типичные ошибки и способы их устранения

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

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

⚠️ Внимание: При передаче ссылок на объекты метаполитена (справочники, документы) убедитесь, что в таблице значений колонка имеет тип Ссылка с указанием конкретного вида объекта, либо универсальный тип Строка с хранением UUID, иначе соединение может не сработать.

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

Почему запрос работает медленно с большой таблицей параметров?

При очень большом объеме данных (более 10-20 тысяч строк) передача через параметр может стать узким местом. В таких случаях рекомендуется разбивать данные на пакеты или использовать временные таблицы с индексами.

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

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

Да, вы можете передать таблицу значений как аргумент серверной процедуры. Однако, если вы используете вызов через Выполнить() или формируете запрос на клиенте, данные должны быть корректно сериализованы. Лучшая практика — формировать таблицу на сервере или передавать её как значение параметра объекта Запрос.

Как добавить колонку с типом "Дата" в таблицу значений?

Используйте метод Колонки.Добавить("ИмяКолонки", Тип("Дата")). Важно указать тип явно, иначе при добавлении первой строки с датой тип может определиться некорректно, если до этого в таблице были другие данные или она была пустой.

Влияет ли использование таблицы значений на блокировки в базе данных?

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

Можно ли использовать таблицу значений в СКД (Системе Компоновки Данных)?

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

Есть ли ограничения на количество колонок в таблице значений?

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