Другое · 7 мин
Как передать массив в запрос 1С как таблицу
Как передать массив в запрос 1С как таблицу: временные таблицы, таблица значений, VALUES, проверка результата и типичные ошибки в 1С:Предприятии.
Массив в языке запросов 1С не является источником данных напрямую. Запрос ожидает таблицу, регистр, справочник или временную таблицу, поэтому передать массив «как есть» через параметр обычно невозможно. Нужно представить массив в виде таблицы значений или временной таблицы, а затем сослаться на неё в тексте запроса.
Перед выбором способа оцените объём данных, тип элементов массива и частоту вызова. Для нескольких значений подходит встроенный конструктор VALUES, для больших наборов — временная таблица, заполняемая из таблицы значений. Неправильный выбор приводит к медленному запросу или ошибке при выполнении.
Почему массив нельзя подставить в запрос напрямую
Язык запросов оперирует наборами записей, а не произвольными массивами языка встроенного подключения. Элементы массива могут быть разного типа, иметь вложенную структуру или отсутствовать, что не соответствует строгой схеме таблицы запроса.
Если попытаться передать массив как параметр там, где платформа не поддерживает такой тип, запрос не скомпилируется или вернёт ошибку при выполнении. Поэтому массив предварительно материализуют в табличную форму с одинаковыми колонками и типами данных.
Основные способы передачи массива как таблицы
Различают три распространённых подхода: загрузка массива во временную таблицу, использование конструктора VALUES для коротких списков и, где поддерживается платформой, передача таблицы значений как параметра. У каждого способа есть свои границы по объёму и удобству отладки.
Выбор зависит от того, сколько элементов будет в массиве, нужно ли повторно использовать таблицу в нескольких запросах и допустима ли временная нагрузка на сеанс пользователя.
Временная таблица из таблицы значений
Создайте таблицу значений с колонками, соответствующими полям элементов массива. Заполните её в цикле, приведя значения к нужным типам, чтобы избежать неявного приведения в запросе.
Затем начните вставку во временную таблицу через менеджер временных таблиц, перенесите строки из таблицы значений и завершите вставку. После этого временную таблицу можно использовать в запросе как обычный источник данных.
- 1Создать таблицу значений с нужными колонками
- 2Заполнить таблицу из массива в цикле
- 3Начать вставку во временную таблицу и перенести строки
- 4Завершить вставку даже при ошибке
- 5Использовать временную таблицу в запросе
Завершение вставки должно выполняться даже при исключении, иначе временная таблица может остаться в неполном состоянии. Используйте конструкцию обработки исключений или эквивалентный механизм завершения операции.
Именуйте временные таблицы уникально в рамках сеанса, особенно если один и тот же код вызывается повторно или в параллельных процессах. Это исключает конфликты имён и случайное использование старых данных.
Маленькие списки через VALUES и параметры
Для небольшого количества значений удобнее сформировать фрагмент запроса с конструкцией VALUES, перечислив элементы массива. Это избавляет от создания временной таблицы и ускоряет простые выборки по списку кодов или идентификаторов.
При росте списка такой подход становится неудобным: текст запроса раздувается, возрастает время разбора и возможны ограничения на размер запроса. В этом случае предпочтительнее временная таблица.
Сравнение вариантов
Подходит для больших и повторно используемых наборов; требует этапов заполнения и очистки.
Удобен для коротких списков; неэффективен при росте количества элементов.
Используется там, где платформа поддерживает такой тип; требует проверки совместимости версии.
Проверка результата и границы применения
После заполнения временной таблицы проверьте количество записей перед выполнением запроса. Пустой массив не должен приводить к неопределённому поведению: запрос просто не найдёт строк, что может быть ожидаемым результатом или признаком ошибки заполнения.
Сравните типы колонок временной таблицы с типами полей, по которым идёт соединение или отбор. Несоответствие типов может привести к пропуску записей или ошибке сравнения без явного сообщения о несовместимости.
Как проверить результат
Соответствует числу элементов массива
Ноль строк при непустом массиве или лишние записи
Типы совместимы для соединения и отбора
Неявное приведение или отсутствие совпадений
Выполнено после любого исхода кода
Операция прервана исключением
Для больших массивов учитывайте время жизни временной таблицы в сеансе. Если таблица не нужна дальше, удалите её или пересоздайте при следующем вызове, чтобы не накапливать неиспользуемые данные в памяти пользователя.
Не храните в временных таблицах конфиденциальные данные дольше необходимого и не передавайте пользовательский ввод напрямую в текст запроса без предварительной валидации.
Типичные ошибки и как их избегать
Частая ошибка — попытка использовать временную таблицу до завершения вставки или после ошибочного прерывания. Тогда запрос видит неполный набор или вообще не находит таблицу. Всегда доводите вставку до конца и проверяйте флаг готовности.
Другая ошибка — использование одинаковых имён временных таблиц в разных процедурах. При повторном вызове данные могут перезаписываться или конфликтовать, что трудно отлаживать без уникальных имён.
Перед выгрузкой большого массива убедитесь, что цикл заполнения не пропускает элементы и не дублирует строки из-за логических условий. Дубли в временной таблице могут умножить результаты соединения в запросе.
Если массив содержит ссылки на объекты или составные типы, передавайте в запрос только примитивные поля, которые можно сравнивать и соединять. Сложные структуры не подходят для прямого использования в условиях отбора.
Как выбрать подходящий способ
Для одноразовой проверки нескольких значений используйте VALUES или параметр, если платформа позволяет. Для отчётов, регистров и повторных выборок оформляйте временную таблицу из таблицы значений.
Если структура массива меняется часто, предпочитайте динамическое создание колонок таблицы значений с явным указанием имён, чтобы запрос не зависел от порядка элементов в массиве.
Что важно запомнить
Массив передаётся в запрос через табличную форму: временную таблицу, таблицу значений или VALUES для коротких списков. Проверяйте заполнение, типы и уникальность имён временных таблиц.
Можно ли передать массив в запрос как параметр напрямую?
Обычно нет: язык запросов требует табличный источник. Массив нужно сначала представить как таблицу значений или временную таблицу, а в поддерживаемых случаях — передать таблицу значений параметром.
Что делать, если массив пустой?
Создайте временную таблицу с правильной структурой, но без строк. Запрос вернёт ноль записей; код должен обрабатывать этот результат как допустимый или как признак отсутствия данных, в зависимости от задачи.
Нужно ли удалять временную таблицу после запроса?
Рекомендуется завершать работу с временной таблицей и не оставлять её в сеансе без необходимости, особенно при повторных вызовах. Это снижает риск конфликтов имён и лишнего потребления ресурсов.
Когда VALUES лучше временной таблицы?
Для очень коротких списков значений, когда не хочется создавать отдельную таблицу и выполнять этапы вставки. При росте списка VALUES становится неудобным и менее эффективным.