Запрос 1С: как проверить значение на вхождение в массив

В языке запросов 1С проверка значения на вхождение в список выполняется оператором В (аналог SQL-конструкции IN). Чаще всего условие записывается как ГДЕ Поле В (&Массив), где параметром передаётся массив, список значений или таблица значений. Это стандартный способ отфильтровать записи по набору ссылок, номенклатурных позиций, контрагентов или любых других значений без построения громоздкой цепочки условий ИЛИ.

Такая конструкция встречается в типовых механизмах повсюду: отбор документов по выбранным контрагентам, проверка остатков по списку складов, ограничение отчёта выбранными элементами справочника. При этом у разработчиков регулярно возникают вопросы: что именно можно передать в параметр, как обработать пустой массив, чем отличается В от В ИЕРАРХИИ и почему запрос иногда возвращает пустой результат при вполне корректном на вид условии.

Как устроен оператор В в языке запросов 1С

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

Базовый пример с явным перечислением выглядит так:

ВЫБРАТЬ
Номенклатура.Ссылка КАК Ссылка
ИЗ
Справочник.Номенклатура КАК Номенклатура
ГДЕ
Номенклатура.Код В ("000001", "000002", "000003")

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

Передача массива в параметр запроса

Чтобы использовать массив в условии ГДЕ, его передают методом УстановитьПараметр объекта запроса. Платформа сама преобразует коллекцию в набор значений для сравнения. Типичный фрагмент кода:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|	Товары.Ссылка КАК Ссылка,
|	Товары.Наименование КАК Наименование
|ИЗ
|	Справочник.Номенклатура КАК Товары
|ГДЕ
|	Товары.Ссылка В (&СписокНоменклатуры)";

МассивНоменклатуры = Новый Массив;
МассивНоменклатуры.Добавить(Ссылка1);
МассивНоменклатуры.Добавить(Ссылка2);

Запрос.УстановитьПараметр("СписокНоменклатуры", МассивНоменклатуры);
Результат = Запрос.Выполнить().Выгрузить();

Запрос.УстановитьПараметр("СписокНоменклатуры", МассивНоменклатуры);

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

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

Пустой массив и его обработка

Наиболее частая ловушка: если передать пустой массив, условие Поле В (&Массив) не выполнится ни для одной строки, и запрос вернёт пустой результат. Формально это корректное поведение, но в логике прикладного кода пустой отбор часто означает «отбор не задан, показать всё». Эти две трактовки нужно различать явно.

Стандартное решение — проверять заполненность массива до выполнения запроса и либо не добавлять условие в текст, либо использовать приём с признаком «отбор отключён»:

ГДЕ
(&БезОтбора ИЛИ Товары.Ссылка В (&СписокНоменклатуры))

Параметр &БезОтбора устанавливается в Истина, когда массив пуст, и в Ложь, когда отбор нужен. Учтите, что такая конструкция мешает оптимизатору использовать индекс по полю отбора, поэтому на больших таблицах предпочтительнее динамически формировать текст запроса через СтрЗаменить или схему компоновки данных.

Сравнение с вложенным запросом и соединением

Оператор В принимает и вложенный запрос: ГДЕ Поле В (ВЫБРАТЬ ...). Это удобно, когда набор значений нужно получить из базы, а не из кода. Однако при больших объёмах данных вложенный запрос в условии часто работает медленнее, чем соединение с временной таблицей.

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

Оператор В ИЕРАРХИИ и особые случаи

Для иерархических справочников есть отдельный оператор В ИЕРАРХИИ: он проверяет, находится ли элемент внутри указанной группы или в любой её подгруппе. Условие ГДЕ Номенклатура.Ссылка В ИЕРАРХИИ (&Группа) выберет все элементы ветки без рекурсивного обхода в коде. Параметром можно передать и массив групп — тогда отбор сработает по совокупности веток.

Отдельный сценарий — проверка по нескольким полям одновременно. Язык запросов 1С не поддерживает кортежное сравнение вида (Поле1, Поле2) В (...) напрямую. Обходной путь — соединение с временной таблицей пар значений или разворот условия через И/ИЛИ для каждой пары, что приемлемо только при малом числе комбинаций.

Типичные ошибки и как их найти

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

Вторая типичная проблема — дубли в массиве. Они не ломают запрос, но при большом числе повторов увеличивают накладные расходы. Удалить дубли можно через соответствие или свёртку таблицы значений перед выгрузкой колонки. Третья ошибка — использование условия В с полем, содержащим NULL после левого соединения: NULL никогда не равен элементу списка, поэтому такие строки отбрасываются. При необходимости их учитывать добавляйте условие ИЛИ Поле ЕСТЬ NULL.

Проверка результата и производительность

Перед включением запроса в рабочий код проверьте его в консоли запросов с теми же параметрами, что формирует код. Убедитесь, что количество строк соответствует ожиданию: сравните с результатом без условия В и с ручным отбором по одному элементу списка. Расхождение без видимых причин почти всегда указывает на типы данных или NULL в проверяемом поле.

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

Частые вопросы