Получение УИД (GUID) в запросах 1С: Предприятие

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

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

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

Природа УникальногоИдентификатора в платформе 1С

Тип данных УникальныйИдентификатор служит для однозначной идентификации объектов метаданных и данных независимо от того, в какой физической базе данных они хранятся. Это фундаментальное свойство делает его незаменимым инструментом при настройке синхронизации между двумя разными конфигурациями или при работе с распределенными информационными базами (РИБ). Значение этого типа представляет собой 128-битное число, которое генерируется алгоритмически и имеет крайне низкую вероятность коллизий.

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

⚠️ Внимание: Тип УникальныйИдентификатор доступен только для объектов метаданных, у которых в свойствах установлен флаг «Использовать стандартный реквизит». Для произвольных регистров сведений без измерений-ссылок получение УИД может быть невозможным стандартными средствами.

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

Синтаксис функции УИД() в языке запросов

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

Функция может быть использована как в списке выбираемых полей, так и в условиях отбора. Когда вы добавляете УИД(Ссылка) в список полей, система выполняет преобразование «на лету» для каждой строки результирующей выборки. Это удобно, когда вам нужно выгрузить данные для внешней системы, требующей именно GUID, а не внутреннюю ссылку 1С.

ВЫБРАТЬ
СправочникНоменклатура.Ссылка,
УИД(СправочникНоменклатура.Ссылка) КАК ГлобальныйИдентификатор
ИЗ
Справочник.Номенклатура КАК СправочникНоменклатура

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

Аргументом функции обязательно должно быть поле, имеющее тип Ссылка на объект, поддерживающий стандартные реквизиты. Попытка передать в функцию УИД() числовой идентификатор или строку приведет к ошибке компиляции запроса. Также функция корректно обрабатывает пустые значения: если ссылка не заполнена, результат функции будет равен NULL (Неопределено).

Фильтрация данных по УникальномуИдентификатору

Одной из самых частых задач при интеграции является поиск объекта в базе 1С по его внешнему GUID, полученному, например, из CRM-системы или веб-сервиса. Реализация такой фильтрации в запросе требует понимания того, как параметры передаются в серверный код. Вы не можете просто передать строку вида "550e8400-e29b.." напрямую в сравнение с результатом функции без правильного приведения типов.

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

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

// Пример кода на стороне сервера перед выполнением запроса
Параметры.Вставить("НужныйУИД", Новый УникальныйИдентификатор(СтрокаВнешнегоGUID));

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

⚠️ Внимание: При передаче УИД из внешних систем убедитесь, что формат строки соответствует стандарту (с дефисами или без). Конструктор Новый УникальныйИдентификатор(Строка) в 1С достаточно гибок, но некорректные символы вызовут исключение.

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

Работа с УИД в консоли запросов и СКД

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

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

В СКД ситуация сложнее: если вы добавляете поле УИД(Ссылка) в набор данных, система автоматически определит его тип. Однако при настройке отборов в пользовательском режиме может возникнуть проблема с вводом значения. Пользователю будет предложено ввести значение типа «УникальныйИдентификатор», интерфейс ввода которого не всегда интуитивно понятен для рядового сотрудника.

Метод получения	Производительность	Читаемость	Рекомендуемое использование
Функция УИД() в SELECT	Высокая	Средняя	Выгрузка данных во внешние системы
Фильтрация по параметру	Очень высокая	Высокая	Поиск конкретного объекта по GUID
Преобразование в строку	Средняя	Очень высокая	Отладка и логирование
Получение из объекта (код)	Низкая (цикл)	Высокая	Точечная обработка малых объемов

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

Особенности производительности и индексации

Вопрос производительности при работе с УИД является одним из самых дискуссионных среди архитекторов 1С. Основная проблема заключается в том, что стандартные индексы в таблицах 1С обычно строятся по полям ИдентификаторОбъекта и ВерсияДанных. Поле, хранящее УИД, также индексируется, но использование функции поверх индексируемого поля в условии WHERE может привести к отказу от использования индекса (Index Scan вместо Index Seek).

Если ваш запрос содержит условие ГДЕ УИД(Ссылка) = Значение, оптимизатор запроса СУБД может принять решение о полном переборе таблицы, особенно если статистика распределения данных устарела. Это критично для справочников с миллионами записей, таких как «Номенклатура» или «Контрагенты» в крупных холдингах. В таких случаях задержка выполнения запроса может исчисляться секундами и даже минутами.

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

Влияние СУБД на скорость работы с УИД

В MS SQL Server работа с типом uniqueidentifier оптимизирована хорошо, но фрагментация индексов по GUID-полям может быть высокой из-за случайного характера генерации значений. В PostgreSQL тип UUID также эффективен, но требует внимательной настройки vacuum. В файловом варианте 1С (SQLite) производительность поиска по УИД значительно ниже, чем в клиент-серверном варианте.

Для диагностики проблем с производительностью используйте план выполнения запроса в вашей СУБД. Если вы видите оператор «Clustered Index Scan» или «Table Scan» на больших таблицах при поиске по УИД, это сигнал к пересмотру структуры запроса или проверке актуальности статистики базы данных.

Конвертация типов и взаимодействие с внешними системами

При интеграции 1С с внешним миром (сайты, маркетплейсы, другие ERP) часто возникает задача конвертации УИД в строку и обратно. Стандартное строковое представление в 1С включает дефисы (например, 00000000-0000-0000-0000-000000000000), тогда как некоторые системы могут передавать GUID слитно.

Функция СтрокаПоУИД() и конструктор Новый УникальныйИдентификатор() автоматически обрабатывают большинство форматов, игнорируя лишние символы, такие как фигурные скобки {} или дефисы. Однако при массовой загрузке данных эти преобразования могут стать «узким горлышком». В таких случаях рекомендуется выполнять конвертацию на стороне внешней системы, приводя данные к каноническому виду перед отправкой в 1С.

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

⚠️ Внимание: При работе с историческими данными или миграции из старых версий 1С (до платформы 8.2) учитывайте, что механизм генерации УИД мог отличаться. В редких случаях возможны коллизии или некорректные значения для объектов, созданных очень давно.

Для отладки проблем с форматами используйте встроенные средства 1С или внешние валидаторы GUID. Не полагайтесь на визуальное сходство строк: различие в одном символе сделает идентификатор невалидным, и поиск объекта завершится неудачей.

Можно ли получить УИД для элементов регистров сведений?

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

Почему функция УИД() возвращает пустое значение?

Это происходит в двух случаях: либо ссылка, переданная в функцию, не заполнена (равна NULL), либо объект, на который указывает ссылка, не имеет установленного флага «Использовать стандартный реквизит» в конфигураторе. Также возможно, что объект был создан в версии платформы, не поддерживающей УИД, и не был пересохранен.

Влияет ли использование УИД(Ссылка) на блокировки в базе данных?

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

Как сгенерировать новый УИД прямо в запросе?

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

Можно ли использовать УИД в качестве ключа связи между таблицами?

Технически это возможно, но не рекомендуется в качестве основного способа_join_а таблиц внутри одной базы 1С. Стандартные связи по ссылкам (через ИдентификаторОбъекта) работают быстрее и используют оптимизированные индексы платформы. УИД следует использовать преимущественно для связей с внешними системами или в распределенных базах.