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

Разработка эффективных алгоритмов в платформе 1С:Предприятие 8 часто требует выборки данных, соответствующих конкретному набору значений. Прямая передача массива в оператор ВЫБРАТЬ языка запросов невозможна, так как синтаксис не поддерживает конструкции типа ГДЕ Поле В (&Массив). Для решения этой задачи программисты используют механизм временных таблиц, который позволяет «скормить» запросу список нужных элементов.

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

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

Зачем нужна временная таблица для массива

Язык запросов 1С оперирует таблицами базы данных или результатами других запросов. Когда у вас в коде есть обычный Массив или СписокЗначений, запрос «не видит» их содержимое. Попытка сформировать строку запроса путем конкатенации значений (например, 'Значение1', 'Значение2') является плохим тоном и ведет к уязвимостям и проблемам с кэшированием планов выполнения.

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

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

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

Создание структуры ТаблицыЗначений

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

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

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

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

Заполнение данными из массива или списка

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

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

• 📂 Используйте метод Добавить() для создания новой строки и сразу заполняйте её реквизиты.
• 🔄 Если данных очень много, рассмотрите возможность использования метода ЗагрузитьКолонку() для массового копирования массива в колонку таблицы.
• 🛡️ Всегда проверяйте массив на пустоту перед началом цикла, чтобы не создавать лишние объекты в памяти.

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

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

⚠️ Внимание: Если вы работаете с большими объемами данных (более 10-20 тысяч строк), убедитесь, что сервер 1С имеет достаточный объем оперативной памяти. Заполнение таблицы в цикле может занять заметное время процессора.

Формирование запроса с временной таблицей

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

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

Этап	Действие	Результат
1	Создание ТЗ	Объект в памяти 1С
2	Заполнение	Данные в ТЗ
3	Создание ВТ	Таблица в tempdb СУБД
4	Выполнение запроса	Выборка данных

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

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

Оптимизация и работа с индексами

Одним из главных преимуществ временных таблиц является возможность управления индексами. По умолчанию временная таблица может не иметь индексов, что при большом объеме данных приведет к полному сканированию (table scan) и падению производительности. Для ускорения соединения необходимо явно создать индексы.

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

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

ИмяВТ = ТЗ.СоздатьВременнуюТаблицу("ВТ_Номенклатура", "Номенклатура");

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

⚠️ Внимание: Создание индексов тоже требует времени и ресурсов. Не создавайте индексы для таблиц, в которых менее 50-100 строк — накладные расходы могут превысить выгоду. Сверяйте требования к индексации в документации к вашей версии платформы.

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

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

Для удаления временной таблицы используется метод Удалить() у объекта временной таблицы. Это освобождает место в системной базе данных (tempdb) и снимает блокировки, если они были установлены в процессе работы.

• 🗑️ Вызывайте удаление сразу после того, как результаты запроса получены и обработаны.
• 📉 Мониторьте размер tempdb на сервере SQL при интенсивной работе фоновых заданий с временными таблицами.
• ✅ Используйте конструкцию Попытка...Исключение для гарантированного удаления таблицы даже в случае ошибки выполнения запроса.

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

Что будет если не удалить временную таблицу?

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

Частые ошибки при реализации

Разработчики часто допускают ряд типичных ошибок при работе с этим механизмом. Самая распространенная из них — несоответствие типов данных в колонке временной таблицы и в основной таблице запроса. Это приводит к неявному преобразованию типов «на лету», что отключает использование индексов и убивает производительность.

Другая ошибка — попытка передать в запрос слишком большой массив без разбивки на части. Если вы грузите во временную таблицу сотни тысяч записей, рассмотрите возможность пакетной обработки. Разбейте массив на части по 5-10 тысяч и обрабатывайте их последовательно.

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

Можно ли передать массив напрямую в параметр запроса?

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

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

Жесткого ограничения в строках нет, всё упирается в доступную оперативную память сервера 1С и место на диске СУБД. Однако практика показывает, что таблицы свыше 50-100 тысяч строк лучше обрабатывать пакетами или использовать временные таблицы на стороне СУБД через хранимые процедуры.

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

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

Нужно ли указывать тип данных для колонки "Ссылка"?

Да, обязательно. Указывайте конкретный тип, например СправочникСсылка.Номенклатура. Использование общего типа СправочникСсылка возможно, но может привести к менее оптимальному плану выполнения запроса и ошибкам типизации при записи.

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

В отладчике вы можете увидеть объект временной таблицы. На стороне СУБД её можно найти в системных представлениях временных объектов (например, в tempdb.sys.tables для MS SQL), но обычному пользователю 1С это видеть не нужно — система сама управляет их жизненным циклом.