Интеграция и миграция: как перевести запрос SQL в 1С

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

Понимание различий между стандартным Transact-SQL или PL/SQL и встроенным языком запросов 1С является критически важным этапом оптимизации производительности системы. Ошибки в трансляции могут привести к блокировкам таблиц, неверным результатам агрегации или полному отказу выполнения запроса на уровне СУБД. В этой статье мы детально разберем алгоритм перевода, сопоставим конструкции и рассмотрим подводные камни, с которыми вы столкнетесь при работе со сложной выборкой.

Фундаментальные различия синтаксиса и структуры

Первое, что бросается в глаза при попытке конвертации — это отсутствие ключевого слова SELECT в начале строки в привычном виде и специфическое обращение к полям. В 1С запрос начинается с ключевого слова ВЫБРАТЬ, за которым следует список полей, но сами поля часто требуют явного указания псевдонимов через конструкцию КАК. Это не просто стилистическое требование, а механизм строгой типизации платформы.

Обращение к данным происходит не к физическим таблицам базы данных, а к объектам метаданных. Имя таблицы в SQL-запросе заменяется на имя объекта конфигурации, например, Справочник.Номенклатура или Документ.РеализацияТоваровУслуг. Важно понимать, что платформа автоматически подставляет префиксы таблиц СУБД, и попытка указать их вручную приведет к ошибке синтаксиса.

Различия касаются и разделителей. Если в классическом SQL точкой с запятой завершается инструкция, то в 1С точка с запятой используется для разделения нескольких запросов в одном тексте, а сам запрос может не требовать явного завершителя в консоли запросов. Кроме того, использование квадратных скобок для экранирования имен полей здесь неприменимо.

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

Трансформация секции FROM и работа с псевдонимами

Секция ИЗ (аналог FROM) является точкой входа в данные. Здесь вы должны заменить физические имена таблиц на логические имена объектов конфигурации. Например, таблица _Reference123 превращается в Справочник.Контрагенты. Если вам нужны данные из регистра сведений, конструкция будет выглядеть как РегистрСведений.ЦеныНоменклатуры.

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

При работе с виртуальными таблицами регистров накопления, такими как остатки или обороты, синтаксис усложняется добавлением параметров периода. Вы не можете просто написать имя таблицы, необходимо указать срез: РегистрНакопления.ТоварыНаСкладах.Остатки( , КАК Остатки). Это фундаментальное отличие от SQL, где виртуальные представления часто создаются вручную через VIEW.

Эквиваленты соединений (JOIN) в запросах 1С

Механизм соединения таблиц в 1С реализован через ключевые слова ЛЕВОЕ СОЕДИНЕНИЕ, ВНУТРЕННЕЕ СОЕДИНЕНИЕ и ПОЛНОЕ СОЕДИНЕНИЕ. Логика их работы полностью соответствует стандартному SQL, однако синтаксическое оформление условия соединения вынесено в отдельный блок ПО, который идет после указания соединяемой таблицы.

Условие соединения записывается после слова ПО и может включать сложные логические выражения. Все связи должны быть явно описаны через конструкцию JOIN.

Рассмотрим пример перевода классического LEFT JOIN. В SQL вы пишете условие сразу после ON. В 1С структура сохраняется, но ключевые слова русифицированы или используют английский синоним в зависимости от локали, но стандарт рекомендует использовать русские ключевые слова для читаемости кода в русскоязычной среде разработки.

Конструкция SQL	Конструкция 1С	Особенности
LEFT JOIN	ЛЕВОЕ СОЕДИНЕНИЕ	Сохраняет все записи левой таблицы
INNER JOIN	ВНУТРЕННЕЕ СОЕДИНЕНИЕ	Только совпадающие записи
RIGHT JOIN	ПРАВОЕ СОЕДИНЕНИЕ	Редко используется, лучше менять местами таблицы
FULL JOIN	ПОЛНОЕ СОЕДИНЕНИЕ	Все записи из обеих таблиц

Оптимизация соединений

При использовании ЛЕВОГО СОЕДИНЕНИЯ старайтесь фильтровать правую таблицу внутри условия ПО, а не в секции ГДЕ, чтобы не превратить соединение во ВНУТРЕННЕЕ непреднамеренно.

Фильтрация данных: секция WHERE и условия

Секция ГДЕ служит для наложения фильтров на выборку и полностью аналогична SQL WHERE. Однако, операторы сравнения и логические связки могут иметь свои нюансы в написании. Оператор НЕ используется для отрицания, а И / ИЛИ для группировки условий. Приоритет операций стандартный, но рекомендуется активно использовать скобки для явного указания порядка вычислений.

Особое внимание следует уделить работе с nullable-полями (полями, которые могут быть пустыми). В SQL часто используют IS NULL. В 1С для проверки на неопределенное значение используется конструкция ЕСТЬ NULL или сравнение с NULL. Но чаще всего разработчики сталкиваются с необходимостью проверки на пустую ссылку, что требует использования оператора ЕСТЬ в контексте соединений или специальных функций.

Для фильтрации по списку значений используется оператор В (аналог IN). Список значений передается в скобках через запятую. Если список формируется динамически в коде, удобнее использовать временные таблицы или параметры запроса, передавая их как значения типа СписокЗначений.

• 🔍 Используйте параметризованные запросы для передачи значений в секцию ГДЕ, чтобы избежать инъекций и ускорить компиляцию плана выполнения.
• 🚀 Избегайте функций в левой части условий сравнения (например, ЛЕВО(Поле, 3) = 'ABC'), так как это отключает использование индексов.
• 📦 Для проверки вхождения в список используйте оператор В, а не цепочку условий ИЛИ, если список велик.

Агрегация, группировка и работа с NULL

Группировка данных реализуется через секцию СГРУППИРОВАТЬ ПО. Синтаксис идентичен SQL GROUP BY. Все поля, не входящие в агрегатные функции (SUM, COUNT, AVG, MIN, MAX), должны быть перечислены в этой секции. Забывчивость в этом пункте приведет к ошибке выполнения запроса.

Функция ЕСТЬNULL является аналогом SQL ISNULL или COALESCE. Она позволяет подменить значение NULL на указанное, что критически важно при агрегации, чтобы сумма не стала NULL при наличии пустых значений. Синтаксис: ЕСТЬNULL(Сумма, 0).

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

⚠️ Внимание: Функции агрегации в 1С не игнорируют NULL так же агрессивно, как в некоторых СУБД. Всегда явно обрабатывайте возможные пустые значения с помощью ЕСТЬNULL перед математическими операциями, чтобы результат не стал неопределенным.

Подзапросы и временные таблицы

Вложенные запросы в 1С поддерживаются и синтаксически мало отличаются от SQL. Вы можете разместить запрос в скобках в секции ИЗ. Однако, платформа 1С имеет мощный инструмент — временные таблицы, которые часто эффективнее глубокой вложенности. Временная таблица создается ключевым словом ПОМЕСТИТЬ перед основным запросом.

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

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

ПОМЕСТИТЬ ВременнаяТаблица
ВЫБРАТЬ
Поле1,
Поле2
ИЗ
Справочник.Номенклатура КАК Номенклатура
;

Далее к таблице ВременнаяТаблица можно обращаться в последующих запросах как к обычному объекту метаданных.

Частые ошибки при конвертации и отладка

Одной из самых распространенных ошибок является попытка использовать специфические функции СУБД (например, DATEPART из T-SQL) напрямую в тексте запроса 1С. Платформа 1С предоставляет свой набор встроенных функций, который транслируется в нативный код СУБД. Использование чужеродных функций приведет к ошибке компиляции запроса.

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

Отладку сложных запросов лучше всего проводить через панель «Консоль запросов». Она позволяет не только проверить синтаксис, но и увидеть сформированный SQL-код, который платформа отправляет в СУБД (через вкладку «Текст запроса для СУБД»). Это invaluable инструмент для понимания того, как именно ваши конструкции интерпретируются движком.

• ❌ Не используйте `SELECT ` (ВЫБРАТЬ ) в производственных конфигурациях — выбирайте только нужные поля для экономии трафика и памяти.
• ⚡ Проверяйте планы выполнения запросов для выявления отсутствующих индексов по полям в секции ГДЕ и СОЕДИНЕНИЕ.
• 🛡 Всегда экранируйте пользовательский ввод при формировании динамических запросов через параметры, а не конкатенацию строк.

Можно ли использовать английский синтаксис (SELECT, FROM) в 1С?

Да, платформа 1С поддерживает английский синтаксис запросов (SELECT, FROM, WHERE) наравне с русским. Это удобно для разработчиков, пришедших из мира SQL, и позволяет использовать готовые сниппеты. Однако, в российской разработке стандартом де-факто остается русский синтаксис для лучшей читаемости коллегами.

Как перевести функцию ISNULL из SQL Server в 1С?

Прямым аналогом функции ISNULL в языке запросов 1С является функция ЕСТЬNULL. Синтаксис схож: ЕСТЬNULL(Выражение, ЗаменяющееЗначение). Она возвращает заменяющее значение, если выражение равно NULL.

Почему запрос в 1С работает медленно, хотя в SQL он быстрый?

Причин может быть несколько: отсутствие индексов в метаданных конфигурации, использование функций в условиях соединения, невыборочное чтение полей (ВЫБРАТЬ *), или особенности трансляции запроса платформой. Используйте анализ производительности в консоли запросов.

Можно ли выполнять хранимые процедуры SQL из запроса 1С?

Напрямую в тексте запроса 1С вызвать хранимую процедуру нельзя. Однако, вы можете выполнить произвольный SQL-код через объект АДОДБ.СОЕДИНЕНИЕ или вызвать внешнюю обработку, но это нарушает целостность платформы и не рекомендуется без крайней необходимости.

Как работает оператор ПОДОБНО в 1С?

Оператор ПОДОБНО является аналогом SQL LIKE. Он позволяет искать строки по маске. Символ `%` обозначает любую последовательность символов, а `_` — любой одиночный символ. Например: `ГДЕ Наименование ПОДОБНО "%Товар%"`.