Как в запросе 1С получить GUID (Уникальный Идентификатор)

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

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

Особое внимание стоит уделить различию между генерацией нового значения и получением ссылки на существующий объект. Ошибки в этом вопросе часто приводят к нарушениям ссылочной целостности или невозможности корректно считать данные из внешних источников. Мы рассмотрим как стандартные методы, так и нестандартные приемы, используемые опытными архитекторами систем.

Синтаксис генерации нового идентификатора в запросе

Для создания нового уникального значения непосредственно в тексте запроса используется специальная функция НОВЫЙ УНИКАЛЬНЫЙ ИДЕНТИФИКАТОР. Этот оператор гарантирует, что каждое значение будет уникальным в рамках всей распределенной системы, что исключает коллизии при синхронизации данных между узлами.

Использование данной конструкции позволяет заполнять регистры сведений или справочники без необходимости предварительного создания объектов в коде. Например, при массовой загрузке данных из внешнего файла вы можете сгенерировать ключи "на лету". Это существенно упрощает логику обработки и уменьшает объем кода.

ВЫБРАТЬ
НОВЫЙ УНИКАЛЬНЫЙ ИДЕНТИФИКАТОР КАК НовыйКлюч,
"ТестовоеЗначение" КАК Описание
ПОМЕСТИТЬ ВРТаблица

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

⚠️ Внимание: Функция генерации работает на стороне сервера 1С или СУБД. При использовании в циклах или больших выборках убедитесь, что алгоритм распределения нагрузки сбалансирован, чтобы не создавать узких мест при записи.

Извлечение УИД из ссылок на объекты метаданных

Частой задачей является получение "чистого" идентификатора из полноценной ссылки на объект конфигурации, такой как Документ или Справочник. Ссылка в 1С является составным типом, содержащим не только УникальныйИдентификатор, но и информацию о типе объекта и его виде.

Для извлечения непосредственно значения идентификатора в языке запросов используется метод .УИД (или .UUID в некоторых версиях платформы, но стандарт — УИД). Это свойство доступно для любого ссылочного типа данных и возвращает значение типа УникальныйИдентификатор.

• 🔍 Позволяет получить технический ключ объекта без учета его вида.
• 🔗 Используется при построении связей между разнородными объектами в регистрах накопления.
• ⚙️ Необходим для передачи данных в внешние системы, где не поддерживается тип "Ссылка".

Рассмотрим пример выборки, где нам нужно получить только технические идентификаторы контрагентов для последующей сверки с внешней CRM-системой. Мы игнорируем наименование и другие реквизиты, фокусируясь исключительно на внутреннем ключе.

ВЫБРАТЬ
СправочникКонтрагенты.Ссылка.УИД КАК ИдентификаторКонтрагента,
СправочникКонтрагенты.Код
ИЗ
Справочник.Контрагенты КАК СправочникКонтрагенты

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

Работа с таблицей значений и временными таблицами

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

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

Метод создания	Область видимости	Производительность	Тип данных
Временная таблица запроса	Только в рамках запроса	Высокая	Любой (авто)
Таблица значений (код)	Вся сессия/процедура	Средняя	Строгий
Регистр сведений	Глобально в ИБ	Низкая (дисковая)	Строгий

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

При заполнении таблицы значений из кода 1С перед передачей в запрос, убедитесь, что колонка создана с типом УникальныйИдентификатор. Если вы создадите колонку типа "Строка" длиной 36 символов, вы потеряете возможность использовать нативные функции сравнения и индексации, оптимизированные под бинарный формат GUID.

Преобразование типов: Строка, Двоичные данные и GUID

Одной из самых проблемных зон является конвертация между строковым представлением GUID и нативным типом УникальныйИдентификатор. Внешние системы часто передают идентификаторы в виде строк формата {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX} или без фигурных скобок.

В языке запросов 1С нет прямой функции приведения строки к УИД внутри текста запроса (как CAST в SQL). Поэтому такую конвертацию обычно выполняют на этапе подготовки параметров запроса в коде 1С. Однако, если данные уже лежат в таблице в виде строк, ситуация усложняется.

⚠️ Внимание: Формат строки критичен. Наличие или отсутствие фигурных скобок, дефисов и регистр букв могут привести к ошибке преобразования типа. Всегда валидируйте входящие строки перед попыткой конвертации.

Для решения задачи преобразования в коде используется конструктор типа или метод ЗначениеИзСтрокиВнутр, если строка имеет внутренний формат представления 1С. Если же строка имеет стандартный вид GUID, необходимо использовать функцию Новый УникальныйИдентификатор(Строка).

Форматы записи GUID

Стандартный формат 1С включает фигурные скобки. Внешние системы (MS SQL, Web API) часто используют формат без скобок. При импорте данных необходимо нормализовать строку, добавив или удалив скобки в зависимости от требований функции конструктора.

Если вы храните GUID в базе данных в виде строки (например, для совместимости со сторонним ПО), помните о потере производительности при соединениях. Индексы по строковым полям длиной 36 символов занимают больше места и работают медленнее, чем индексы по нативному типу УникальныйИдентификатор.

Сравнение и фильтрация по уникальным идентификаторам

Фильтрация данных по GUID является одной из самых быстрых операций в 1С, благодаря тому, что этот тип данных часто используется как первичный ключ или часть первичного ключа в таблицах базы данных. Правильное использование условий в секции ГДЕ гарантирует использование индексов.

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

• ✅ Используйте параметры запроса для передачи значений GUID.
• ❌ Избегайте подстановки строковых литералов прямо в текст запроса.
• ⚡ Проверяйте план выполнения запроса для убеждения в использовании индекса.

Рассмотрим пример корректной фильтрации. Мы передаем значение через параметр &ПараметрУИД, который в коде 1С определен как переменная типа УникальныйИдентификатор. Это обеспечивает максимальную производительность выборки даже на больших объемах данных.

ВЫБРАТЬ
РегистрНакопления.Продажи.Период,
РегистрНакопления.Продажи.Сумма
ИЗ
РегистрНакопления.Продажи КАК РегистрНакопления.Продажи
ГДЕ
РегистрНакопления.Продажи.Регистратор.УИД = &ПараметрУИД

Также стоит упомянуть возможность проверки на пустое значение. Уникальный идентификатор может быть неопределенным (пустым). Для проверки используется конструкция ЕСТЬ NULL или сравнение с константой НОВЫЙ УникальныйИдентификатор() (если логика требует именно нулевого GUID, хотя в 1С чаще используется неопределенное значение).

Отладка и визуализация значений УИД

При отладке сложных запросов разработчику часто требуется увидеть человеческое представление уникального идентификатора. По умолчанию консоль запросов или отладчик могут отображать значение в шестнадцатеричном виде или в формате, неудобном для копирования.

Для преобразования значения в строку непосредственно в результате запроса (например, для выгрузки в CSV или отображения в отчете) необходимо использовать функцию СТРОКА(). Эта функция преобразует внутренний бинарный формат в строковое представление, принятое в платформе 1С (со скобками и дефисами).

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

⚠️ Внимание: При выводе GUID в печатные формы или внешние файлы убедитесь, что используемый шрифт поддерживает отображение всех символов hex-кода, чтобы избежать визуальных ошибок (например, путаницы между 0 и O, 1 и l).

В консоли запросов конфигуратора можно настроить отображение колонок. Если колонка имеет тип УникальныйИдентификатор, система обычно показывает её в формате {...}. При экспорте результата в MXL или CSV этот формат сохраняется, что может потребовать дополнительной пост-обработки файла скриптами.

Часто задаваемые вопросы (FAQ)

Можно ли сгенерировать GUID с определенным значением в запросе?

Нет, функция НОВЫЙ УНИКАЛЬНЫЙ ИДЕНТИФИКАТОР всегда генерирует случайное значение. Если вам нужно использовать конкретный GUID, его необходимо передать в запрос как параметр или сконструировать из строки в коде 1С перед выполнением запроса.

Почему сравнение GUID в запросе работает медленно?

Чаще всего причина в несоответствии типов. Если поле в базе имеет тип УникальныйИдентификатор, а в условии ГДЕ участвует строка или параметр другого типа, СУБД может отказаться использовать индекс. Всегда приводите типы заранее.

Как получить GUID текущего документа в запросе?

Если запрос выполняется в контексте объекта, вы можете передать ссылку на объект как параметр и выбрать свойство .УИД. Сам запрос не имеет понятия "текущий документ", это понятие существует только в коде модуля объекта.

Отличается ли GUID в 1С от GUID в SQL Server?

Логически это одно и то же значение (128 бит). Однако порядок байт (Endianness) при хранении может отличаться в зависимости от драйверов и версии платформы. При прямом доступе к таблице SQL извне нужно учитывать возможную инверсию байтов в первых трех секциях.

Можно ли использовать GUID как код элемента справочника?

Технически можно, если в свойствах справочника разрешено использование кодов длиной до 36 символов и типом строки. Но это считается плохой практикой, так как коды предназначены для удобной ручной работы, а GUID — для машинной обработки.