Загрузка Таблицы Значений в запрос 1С: Предприятие

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

Использование временных таблиц или таблиц значений в теле запроса кардинально меняет подход к оптимизации кода. Вместо того чтобы выполнять сотни отдельных обращений к базе данных в цикле, вы формируете единый набор данных в памяти и «скармливаете» его движку запросов. Это позволяет СУБД построить оптимальный план выполнения, используя эффективные соединения (JOIN) вместо последовательного перебора.

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

Концепция работы с временными таблицами в 1С

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

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

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

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

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

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

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

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

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

Особое внимание стоит уделить типу данных колонки «Ссылка». Если вы планируете соединять таблицу значений с регистрами сведений или накопления, тип должен быть максимально точным. Использование общего типа СправочникСсылка возможно, но конкретизация до вида справочника (СправочникСсылка.Номенклатура) часто помогает оптимизатору запросов выбрать более быстрый план выполнения.

Синтаксис запроса с использованием переменной

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

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

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

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

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

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

Типы соединений и производительность

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

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

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

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

Почему левое соединение может работать медленнее?

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

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

После выполнения запроса результат возвращается в виде объекта ВыборкаИзРезультатаЗапроса. Вы можете iterating по нему стандартным циклом Для Каждого.

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

Еще один нюанс касается составных типов. Если в колонке таблицы значений допустимы разные типы (например, СправочникСсылка.Номенклатура И СправочникСсылка.Характеристики), убедитесь, что в запросе вы корректно обрабатываете эти варианты, возможно, используя функцию ЕСТЬNULL или приводя типы к общему знаменателю.

Тип ошибки	Симптом	Причина	Решение
Неверный тип	Ошибка выполнения запроса	Тип колонки не совпадает с типом в запросе	Проверить описание типов в Колонки.Добавить
Пустая таблица	Запрос выполняется, но нет данных	Таблица значений не заполнена перед запросом	Добавить проверку Количество() > 0
Дублирование	Лишние строки в результате	Некорректное соединение (многие-ко-многим)	Использовать РАЗЛИЧНЫЕ или проверить уникальность
Ошибка компиляции	Текст запроса не проходит проверку	Опечатка в имени поля или переменной	Внимательно проверить имена колонок и алиасы

Расширенные возможности и оптимизация

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

Для дальнейшей оптимизации можно использовать конструкцию РЕГИСТРВРЕМЕННЫХТАБЛИЦ. Она позволяет явно управлять жизненным циклом временной таблицы, создавать индексы для ускорения соединений и использовать одну и ту же таблицу в нескольких запросах в рамках одной транзакции. Это особенно полезно в сложных отчетных формах.

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

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

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

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

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

Да, в СКД можно использовать таблицу значений как источник данных. Для этого нужно передать её в параметр схемы компоновки и указать в настройках источника, что данные берутся из параметра типа «Таблица значений». Это часто используется для отчетов по произвольному списку объектов.

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

Технического жесткого ограничения нет, но оно ограничено оперативной памятью сервера и клиента. На практике передача таблиц более 100 000 строк может вызвать задержки из-за сериализации. Для больших объемов лучше использовать временные таблицы на стороне СУБД.

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

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

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

Порядок колонок в объекте Таблица Значений не влияет на производительность запроса напрямую. Однако для удобства чтения кода и отладки рекомендуется располагать колонки в том же порядке, в котором они используются в секции ВЫБРАТЬ запроса.

Что делать, если запрос с таблицей значений выполняется медленно?

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