При разработке в платформе 1С:Предприятие 8 программисты часто сталкиваются с необходимостью выборки данных, которые находятся не в самом документе, а внутри его структуры. Табличные части (или, как их часто называют в обиходе, "табы") являются неотъемлемым атрибутом большинства первичных документов, таких как заказы, накладные или счета. Понимание того, как корректно построить запрос к табличной части, критически важно для создания быстрых и эффективных отчетов.
Многие начинающие разработчики ошибочно полагают, что достаточно просто указать имя объекта в предложении ИЗ. Однако архитектура системы хранения данных требует использования специальных виртуальных таблиц, если вы обращаетесь к подчиненным записям. Игнорирование этого правила приведет к тому, что ваш код просто не пройдет синтаксический контроль или будет возвращать пустые результаты, что вызовет недоумение у пользователя.
В этой статье мы подробно разберем синтаксис, особенности работы с планом видов характеристик и нюансы фильтрации записей внутри сложных документов. Вы узнаете, как избежать распространенных ошибок при формировании выборок и оптимизировать производительность ваших запросов.
Основы синтаксиса и виртуальные таблицы
Главное правило работы с подчиненными записями в языке запросов 1С гласит: к табличной части нельзя обратиться напрямую по имени объекта, как к обычной таблице. Вместо этого необходимо использовать специальный суффикс, который указывает движку базы данных на необходимость обращения к подчиненным записям. Стандартным разделителем служит точка, после которой указывается имя табличной части, определенной в конфигураторе.
Например, если у вас есть документ РеализацияТоваровУслуг и в нем есть табличная часть Товары, то правильный путь к данным будет выглядеть следующим образом. Вам необходимо соединить имя документа и имя части через точку. Это создает уникальное имя виртуальной таблицы, которое система понимает и корректно обрабатывает при компиляции запроса.
Стоит отметить, что структура запроса остается классической. Вы выбираете поля, задаете условия и сортировку точно так же, как при работе с обычными справочниками. Разница заключается лишь в источнике данных. Использование правильного синтаксиса гарантирует что вы получите именно те строки товаров или услуг, которые относятся к конкретному документу.
⚠️ Внимание: Имя табличной части в запросе должно в точности совпадать с именем, заданным в конфигураторе. Регистр букв имеет значение, если в вашей базе настроен чувствительный к регистру режим работы со строками, хотя по умолчанию платформа часто игнорирует его в именах метаданных.
Выборка конкретных полей и псевдонимы
При формировании списка полей в предложении ВЫБРАТЬ вы можете использовать как полные имена, так и удобные псевдонимы. Это особенно актуально, когда имя табличной части длинное или когда одно и то же поле встречается в разных источниках данных внутри одного запроса. Псевдонимы делают код более читаемым и упрощают дальнейшую обработку результатов в коде 1С.
Рассмотрим ситуацию, когда нам нужно получить номенклатуру и количество из документа. Мы явно указываем поля через точку. Если вы планируете использовать результат запроса для дальнейших вычислений, например, суммирования итогов, то использование псевдонимов для агрегатных функций станет обязательным требованием для чистоты кода.
Также важно помнить о типах данных. Поле, содержащее ссылку на номенклатуру, будет иметь тип СправочникСсылка.Номенклатура, а поле количества — тип Число. Понимание типов данных необходимо для корректной работы с результатами выборки в последующем коде.
ВЫБРАТЬ
РеализацияТоваровУслугТовары.Номенклатура КАК Номенклатура,
РеализацияТоваровУслугТовары.Количество КАК Количество,
РеализацияТоваровУслугТовары.Цена КАК Цена
ИЗ
Документ.РеализацияТоваровУслуг.Товары КАК РеализацияТоваровУслугТовары
Использование ключевого слова КАК позволяет задать понятное имя колонке в результирующей таблице. Это упрощает обращение к данным через объект РезультатЗапроса в коде обработки или отчета.
Используйте префиксы для псевдонимов таблиц (например, РТТ_Товары), чтобы избежать путаницы при объединении нескольких источников данных в одном запросе.
Фильтрация записей и условия отбора
Одной из самых частых задач является отбор только нужных строк из большого объема данных. В табличных частях документов фильтрация происходит аналогично обычным таблицам, с использованием предложения ГДЕ. Вы можете ограничивать выборку по конкретному документу, по виду номенклатуры или по любому другому числовому или строковому параметру.
Часто возникает необходимость получить данные только по одному конкретному документу. Для этого в условие помещается ссылка на объект. Важно правильно передавать параметры в запрос, чтобы избежать проблем с типизацией и обеспечить безопасность от SQL-инъекций (хотя в 1С это менее актуально, но хорошая практика).
- 🎯 Фильтрация по конкретному документу: используйте параметр в условии
ГДЕ. - 🔍 Отбор по свойствам номенклатуры: соединяйте табличную часть со справочником.
- 📅 Ограничение по датам: фильтруйте по дате документа-владельца.
- ❌ Исключение пустых строк: проверяйте поля на
ЕСТЬ NULL.
При написании условий помните о приоритете операций. Если вы используете сложные логические конструкции с И и ИЛИ, обязательно группируйте их скобками. Это предотвратит логические ошибки, когда запрос вернет лишние записи из-за неправильного порядка вычисления условий.
ВЫБРАТЬ
ТабЧасть.Номенклатура
ИЗ
Документ.ЗаказКлиента.Товары КАК ТабЧасть
ГДЕ
ТабЧасть.Ссылка = &СсылкаНаДокумент
И ТабЧасть.Количество > 0
☑️ Проверка условий фильтрации
Соединение с другими таблицами и справочниками
Данные в табличной части документа редко существуют в вакууме. Чаще всего они содержат ссылки на другие объекты метаданных, такие как справочники номенклатуры, контрагентов или статьи затрат. Для получения дополнительной информации (например, артикула товара или его веса) необходимо выполнить соединение (ЛЕВОЕ СОЕДИНЕНИЕ или ВНУТРЕННЕЕ СОЕДИНЕНИЕ) с соответствующими таблицами.
При соединении важно правильно указывать условия связи. Обычно это связь по ссылке на объект. Например, чтобы получить полное наименование товара, мы соединяем поле Номенклатура из табличной части с таблицей справочника Номенклатура. Это позволяет "подтянуть" любые атрибуты справочника в результат запроса.
Особое внимание следует уделить типу соединения. Если вы используете ВНУТРЕННЕЕ СОЕДИНЕНИЕ, то строки, у которых в табличной части не заполнена ссылка на справочник, будут исключены из выборки. Если же вам важно видеть все строки документа, даже если товар не указан, используйте ЛЕВОЕ СОЕДИНЕНИЕ.
| Тип соединения | Описание поведения | Когда использовать |
|---|---|---|
| ЛЕВОЕ СОЕДИНЕНИЕ | Сохраняет все строки из левой таблицы | Когда нужны все позиции документа |
| ВНУТРЕННЕЕ СОЕДИНЕНИЕ | Только строки, где есть совпадение | Для отчетов только по заполненным данным |
| ПОЛНОЕ СОЕДИНЕНИЕ | Все строки из обеих таблиц | Редко, для сложного анализа расхождений |
Правильный выбор типа соединения влияет не только на состав данных, но и на производительность запроса. Внутренние соединения часто выполняются быстрее, так как базе данных не нужно обрабатывать пустые значения для отсутствующих связей.
Работа с планом видов характеристик
В современных конфигурациях, таких как 1С:ERP или Управление торговлей, табличные части часто используют план видов характеристик (ПВХ) для хранения дополнительных реквизитов. Это позволяет гибко настраивать состав полей для разных типов товаров. Запрос к таким данным имеет свои особенности.
Если в конфигураторе для табличной части установлено свойство "Использовать план видов характеристик", то в запросе появляется дополнительная виртуальная таблица. Обычно она имеет суффикс ДополнительныеРеквизиты или подобное название, зависящее от имени плана видов. Обращение к этим данным требует понимания структуры хранения разреженных данных.
Для получения значения конкретного дополнительного реквизита необходимо фильтровать виртуальную таблицу по виду характеристики. Это может усложнить запрос, но дает огромную гибкость. Вы можете dynamically подставлять значения, которые пользователь настроил в интерфейсе, без изменения кода конфигурации.
⚠️ Внимание: При работе с дополнительными реквизитами через запрос учитывайте, что значения хранятся в едином поле с типом ХранилищеЗначения или разбиты по типам. Используйте функцию
ЗНАЧЕНИЕили соответствующие поля виртуальной таблицы для извлечения данных.
Оптимизация и производительность запросов
Запросы к табличным частям документов могут стать узким местом в системе, если документы содержат тысячи строк, а выборка делается без должной оптимизации. Ключевым фактором скорости является использование индексов. Платформа 1С автоматически создает индексы по полям типа Ссылка, Период и Измерения регистров, но в табличных частях ситуация сложнее.
Основное правило оптимизации: условие в предложении ГДЕ должно быть сформулировано так, чтобы база данных могла использовать существующие индексы. Чаще всего самым эффективным фильтром является отбор по ссылке на сам документ (Ссылка). Если вы выбираете данные по всем документам за период, убедитесь, что фильтр по дате стоит на первом месте или скомбинирован оптимально.
Избегайте использования функций в условиях отбора над полями таблиц. Например, конструкция ГДЕ ГОД(Период) = 2026 заставит базу перебирать все записи, игнорируя индекс по полю Период. Правильнее будет указать диапазон дат: ГДЕ Период МЕЖДУ ... И ....
Секрет быстрой выборки
Если вы часто делаете отчеты по определенному полю в табличной части (например, по артикулу), рассмотрите возможность добавления этого поля в список индексируемых в конфигураторе, если это технически возможно для вашей версии платформы.
Также стоит упомянуть о временных таблицах. Если ваш запрос к табличной части является частью сложной цепочки вычислений, имеет смысл выгрузить промежуточный результат во временную таблицу. Это позволит двигателю запросов оптимизировать дальнейшие шаги и снять нагрузку с основных таблиц документов.
Частые ошибки и методы их устранения
Даже опытные разработчики допускают ошибки при работе с подчиненными записями. Одна из самых распространенных проблем — попытка выбрать поле, которое физически не существует в табличной части, или опечатка в имени. Система выдаст ошибку "Неизвестное поле", но иногда, при использовании псевдонимов, ошибка может проявиться только при выполнении.
Другая частая ошибка связана с типами данных при передаче параметров. Если вы передаете неопределенное значение (Неопределено) в параметр, используемый в соединении или строгим условием, результат может быть пустым. Всегда проверяйте параметры перед выполнением запроса или используйте конструкцию ЕСТЬ NULL для обработки таких случаев.
- 🚫 Ошибка в имени табличной части (регистр, опечатки).
- 🚫 Отсутствие условия по ссылке на документ при выборке из всех документов.
- 🚫 Неправильный тип соединения, ведущий к потере данных.
- 🚫 Игнорирование плана видов характеристик при наличии доп. реквизитов.
Для отладки сложных запросов используйте консоль запросов или встроенный отладчик. Визуализация дерева запроса помогает понять, как именно система планирует выполнение и где теряется производительность.
Всегда проверяйте имя табличной части в метаданных конфигуратора перед написанием запроса — это экономит 90% времени на отладку синтаксических ошибок.
Можно ли обновлять данные в табличной части через запрос?
Нет, язык запросов 1С предназначен только для чтения данных (SELECT). Для изменения, удаления или добавления записей в табличные части необходимо использовать объекты доступа в коде 1С (документ.Товары.Добавить()) или специализированные механизмы обновлений, но не через текст запроса.
Как получить количество строк в табличной части запросом?
Используйте агрегатную функцию КОЛИЧЕСТВО() в предложении ВЫБРАТЬ. Например: ВЫБРАТЬ КОЛИЧЕСТВО() ИЗ Документ.Заказ.Товары ГДЕ Ссылка = &Ссылка. Это вернет одну строку с числом позиций.
Что делать, если табличная часть называется "Товары", а в запросе ошибка?
Проверьте, не является ли это зарезервированным словом (редко, но бывает). Попробуйте взять имя в кавычки: "Товары". Также убедитесь, что вы обращаетесь к ней как к виртуальной таблице документа, а не как к отдельному регистру.
Влияет ли проведение документа на доступность данных в запросе?
Нет, запрос к табличной части документа выбирает данные независимо от статуса проведения. Вы можете получить доступ к строкам черновика, проведенного документа или документа, помеченного на удаление (если не стоит фильтр на помеченные).