При разработке в среде 1С:Предприятие часто возникает задача отфильтровать выборку данных по списку определенных элементов. Самым очевидным решением кажется использование оператора В в тексте запроса с передачей массива в качестве параметра. Однако на практике разработчики, особенно начинающие, часто сталкиваются с ошибкой «Ошибка при вызове метода контекста (Выполнить)... Неверные параметры». Сегодня мы подробно разберем, почему возникает эта ошибка, как ее оперативно исправить, а также изучим передовые методы оптимизации запросов с использованием массивов и временных таблиц.
Давайте проанализируем ситуацию, с которой столкнулся автор темы. В коде выполнялось заполнение массива в цикле:
Для Каждого СписокД Из Объект.СписокДокументов Цикл
СтруктураВМассив = Новый Структура;
СтруктураВМассив.Вставить("Ведомость" , СписокД.Ссылка);
Массив.Добавить(СтруктураВМассив);
КонецЦикла;
В данном примере в массив добавлялись не сами ссылки на документы, а объекты типа Структура, содержащие эти ссылки. Когда мы передаем такой массив в параметр запроса:
Запрос.УстановитьПараметр("Массив", Ведомости);
и пытаемся выполнить условие ВедомостьНаВыплатуЗарплатыВБанкЗарплата.Ссылка В (&Массив), платформа 1С совершает сопоставление типов. База данных ожидает список элементов, совместимых по типу с полем Ссылка (в данном случае это ссылки на документы). Вместо этого СУБД получает массив структур. Платформа не может неявно извлечь данные из структуры внутри массива, что и приводит к ошибке выполнения запроса.
Для исправления этой ошибки нам необходимо передавать в параметр чистый массив ссылок без каких-либо промежуточных контейнеров вроде структур. Давайте скорректируем код заполнения массива в цикле:
Массив = Новый Массив;
Для Каждого СписокД Из Объект.СписокДокументов Цикл
// Добавляем напрямую ссылку на документ, а не структуру
Массив.Добавить(СписокД.Ссылка);
КонецЦикла;
После этого изменения параметр будет содержать плоский список ссылок, и запрос отработает абсолютно корректно.
Использование цикла Для Каждого для обхода табличной части на сервере — это не самый эффективный способ с точки зрения лаконичности кода и быстродействия. Если коллекция данных формы (например, табличная часть на управляемой форме СписокДокументов) находится на сервере, мы можем использовать встроенные механизмы платформы 1С для выгрузки данных.
Давайте рассмотрим, как получить массив ссылок всего в одну строчку кода, полностью исключив цикл:
МассивСсылок = Объект.СписокДокументов.Выгрузить().ВыгрузитьКолонку("Ссылка");
Что здесь происходит? Метод Выгрузить() преобразует коллекцию данных формы в полноценную ТаблицуЗначений. Затем у полученной таблицы значений мы вызываем метод ВыгрузитьКолонку(), передавая имя нужной колонки (в нашем случае "Ссылка"). Этот метод возвращает готовый плоский массив, содержащий значения только этой колонки. Данный подход работает быстрее, а код становится более простым для понимания и поддержки.
В реальных базах данных пользователи могут случайно или намеренно продублировать строки в табличной части. Если в массиве окажутся одинаковые ссылки, они все будут переданы в СУБД. Наличие дубликатов внутри оператора В (&Массив) увеличивает объем передаваемых данных и заставляет СУБД тратить лишнее время на построение плана запроса.
Чтобы избежать этой проблемы, нам следует передавать только уникальные элементы. Давайте модернизируем наш код с использованием метода Свернуть():
// Выгружаем табличную часть в таблицу значений
ТаблицаДокументов = Объект.СписокДокументов.Выгрузить();
// Сворачиваем таблицу по колонке "Ссылка", удаляя все повторяющиеся строки
ТаблицаДокументов.Свернуть("Ссылка");
// Выгружаем очищенную от дубликатов колонку в массив
МассивСсылок = ТаблицаДокументов.ВыгрузитьКолонку("Ссылка");
Этот простой шаг гарантирует, что в СУБД уйдет оптимальный набор данных без избыточности.
Передача массива напрямую через параметр В (&Массив) отлично подходит, когда мы точно знаем, что количество элементов невелико (до нескольких десятков или сотен). Если же массив может содержать тысячи элементов, мы рискуем столкнуться с серьезными проблемами:
IN в SQL приводят к тому, что оптимизатор СУБД строит неоптимальные планы выполнения, что вызывает колоссальные задержки и блокировки таблиц.Для решения этой проблемы правильным архитектурным подходом является передача типизированной таблицы значений в запрос и ее последующее помещение во временную таблицу. Давайте детально разберем этот процесс по шагам.
Шаг 1: Создаем типизированную таблицу значений и заполняем ее:
// Создаем таблицу значений с жестко заданной типизацией колонки
ТЗПараметр = Новый ТаблицаЗначений;
ОписаниеТипа = Новый ОписаниеТипов("ДокументСсылка.ВедомостьНаВыплатуЗарплатыВБанк");
ТЗПараметр.Колонки.Добавить("Ссылка", ОписаниеТипа);
// Заполняем таблицу значениями из формы (без дубликатов)
ТЗВременная = Объект.СписокДокументов.Выгрузить();
ТЗВременная.Свернуть("Ссылка");
Для Каждого Строка Из ТЗВременная Цикл
НоваяСтрока = ТЗПараметр.Добавить();
НоваяСтрока.Ссылка = Строка.Ссылка;
КонецЦикла;
Шаг 2: Передаем таблицу значений в запрос и связываем ее через соединение:
Запрос = Новый Запрос;
Запрос.УстановитьПараметр("ТаблицаДокументов", ТЗПараметр);
Запрос.Текст =
"ВЫБРАТЬ
| ТаблицаДокументов.Ссылка КАК Ссылка
|ПОМЕСТИТЬ ВТ_Фильтр
|ИЗ
| &ТаблицаДокументов КАК ТаблицаДокументов
|;
|
|////////////////////////////////////////////////////////////////////////////////
|ВЫБРАТЬ
| ВедомостьЗарплата.Ссылка КАК Ссылка,
| ВедомостьЗарплата.Сотрудник КАК Сотрудник,
| ВедомостьЗарплата.КВыплате КАК КВыплате
|ИЗ
| Документ.ВедомостьНаВыплатуЗарплатыВБанк.Зарплата КАК ВедомостьЗарплата
| // Вместо медленного оператора 'В' используем Внутреннее Соединение
| ВНУТРЕННЕЕ СОЕДИНЕНИЕ ВТ_Фильтр КАК ВТ_Фильтр
| ПО ВедомостьЗарплата.Ссылка = ВТ_Фильтр.Ссылка";
Результат = Запрос.Выполнить();
Использование временных таблиц и внутренних соединений позволяет СУБД легко строить идеальные планы запросов, задействовать индексы и обрабатывать любые объемы данных без угрозы падения производительности.
Если массив, который мы передаем в параметр запроса В (&Массив), окажется пустым, платформа 1С автоматически преобразует это условие в заведомо ложное выражение (например, 1 = 0 в SQL). Запрос выполнится без ошибок и вернет пустой результат. Однако СУБД все равно потратит ресурсы на разбор запроса, компиляцию плана и его выполнение.
Хорошей практикой является добавление предварительной проверки во встроенном языке перед обращением к базе данных. Если массив пуст, выполнять запрос нет никакого практического смысла:
МассивСсылок = Объект.СписокДокументов.Выгрузить().ВыгрузитьКолонку("Ссылка");
Если МассивСсылок.Количество() = 0 Тогда
// Прерываем выполнение процедуры или возвращаем пустой результат
Возврат;
КонецЕсли;
Этот простой прием снижает общую нагрузку на сервер СУБД и предотвращает холостые вызовы.
Если поле, по которому вы производите отбор с помощью оператора В, имеет составной тип данных, СУБД может тратить дополнительное время на приведение типов и сканирование таблиц вместо использования индексов. Чтобы оптимизировать этот процесс, рекомендуется явно указывать ожидаемый тип данных с помощью функции ВЫРАЗИТЬ():
ГДЕ
ВЫРАЗИТЬ(ВедомостьНаВыплатуЗарплатыВБанкЗарплата.Ссылка КАК Документ.ВедомостьНаВыплатуЗарплатыВБанк) В (&Массив)
Благодаря этому оптимизатор СУБД сможет сразу использовать индекс по колонке Ссылка, что значительно ускорит время выполнения операции фильтрации.
Сегодня мы разобрали классическую ошибку передачи массива структур в параметры запроса 1С и изучили правильный способ передачи плоского массива ссылок. Кроме того, мы рассмотрели пять ключевых правил оптимизации при работе со списками в запросах, включая отказ от медленных циклов в пользу выгрузки колонок, устранение дубликатов, использование временных таблиц при больших объемах данных, защиту от холостых вызовов и явное приведение типов. Применяйте эти правила на практике, чтобы ваши решения на платформе 1С:Предприятие работали быстро и надежно!