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

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

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

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

Основы механизма передачи данных

Ключевым моментом взаимодействия является метод УстановитьПараметр объекта запроса. Именно он позволяет "пробросить" структуру данных из языка запросов внутрь текста SQL-подобного выражения, используемого платформой 1С. Без этого шага система просто не увидит ваши данные.

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

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

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

Рассмотрим простейший пример инициализации. Сначала мы создаем саму таблицу, определяем её колонки, заполняем данными, и только затем передаем в запрос. Нарушение этой последовательности сделает параметр пустым или невалидным.

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

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

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ ...";
Запрос.УстановитьПараметр("МояТаблица", ТаблицаКритериев);

Синтаксис обращения в тексте запроса

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

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

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

• 📌 Используйте алиасы для таблиц, чтобы избежать путаницы в сложных запросах с несколькими источниками.
• 📌 Поля таблицы значений доступны для условий в блоке ГДЕ так же, как и поля обычных таблиц.
• 📌 Можно выполнять агрегатные функции (СУММА, КОЛИЧЕСТВО) по данным из переданной таблицы.

Пример корректного синтаксиса в тексте запроса выглядит следующим образом. Здесь мы фильтруем регистр накопления по списку контрагентов, переданному из кода.

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

Типы соединений и логика выборки

Выбор правильного типа соединения критически важен для получения ожидаемого результата. В 1С доступны все стандартные типы: ВНУТРЕННЕЕ, ЛЕВОЕ, ПРАВОЕ и ПОЛНОЕ соединение. Понимание разницы между ними определяет логику работы вашего отчета или обработки.

Внутреннее соединение (INNER JOIN) оставит только те записи из основной таблицы, для которых нашлось совпадение в таблице значений. Это идеальный вариант для строгой фильтрации "по списку". Если элемента нет в списке — он исключается из выборки.

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

⚠️ Внимание: При использовании ПРАВОГО или ПОЛНОГО соединения убедитесь, что ваша логика обработки NULL-значений корректна. Пустые значения могут исказить итоги расчетов, если не использовать функцию ЕСТЬNULL.

Частая ошибка новичков — путаница в порядке таблиц при использовании левого и правого соединения. Помните, что "левая" таблица — это та, которая идет первой в предложении ИЗ. Таблица значений может стоять как слева, так и справа, в зависимости от задачи.

Рассмотрим таблицу, демонстрирующую влияние типа соединения на результат выборки при наличии и отсутствии совпадений:

Тип соединения	Есть совпадение в Таблице Значений	Нет совпадения в Таблице Значений	Результат для основной таблицы
ВНУТРЕННЕЕ	Да	Нет	Запись включается
ЛЕВОЕ	Да	Нет	Запись включается (поля ТВ = NULL)
ПРАВОЕ	Да	Нет	Запись включается только если есть в ТВ
ПОЛНОЕ	Да	Нет	Включаются все записи из обеих таблиц

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

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

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

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

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

• 🚀 Фильтруйте данные в коде 1С перед созданием таблицы значений, чтобы уменьшить её размер.
• 🚀 Избегайте передачи таблиц значений внутри циклов по другим таблицам — это убивает производительность.
• 🚀 Используйте составные индексы, если соединение идет по нескольким полям одновременно.

Секрет быстрой работы

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

Работа с составными типами данных

Особую сложность представляет работа с полями, имеющими составные типы, например, СправочникСсылка.Номенклатура и ДокументСсылка.РеализацияТоваровУслуг одновременно. В таких случаях тип описания должен включать все возможные варианты.

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

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

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

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

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

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

Самая распространенная ошибка — попытка обратиться к параметру, который не был установлен. Сообщения вида "Не найдено значение параметра" указывают на опечатку в имени или пропущенный вызов УстановитьПараметр. Всегда проверяйте имена на идентичность.

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

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

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

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

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

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

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

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

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

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

Как отладить запрос, если он падает с ошибкой синтаксиса?

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

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

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