Преобразование УникальногоИдентификатора в строку в языке запросов 1С

Использование уникальных идентификаторов (UUID) является фундаментом архитектуры платформенных решений 1С:Предприятие. В отличие от простых целочисленных ссылок, эти 16-байтовые значения гарантируют глобальную уникальность объектов, что критически важно при распределенной работе и обмене данными между информационными базами. Однако при работе с отчетами, выгрузке в CSV или интеграции через HTTP-сервисы часто возникает необходимость представления этого бинарного значения в текстовом формате.

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

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

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

Тип данных УникальныйИдентификатор хранится внутри платформы как 16-байтовый массив. Это не строка и не число, а специфическая бинарная структура. Когда вы видите значение вида {12345678-1234-1234-1234-1234567890AB} в отладчике или печатной форме, это уже результат форматирования, выполненного системой отображения.

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

Важно понимать, что база данных (например, MS SQL Server или PostgreSQL) также хранит эти значения в своих специфических типах (например, uniqueidentifier), и при выборке данных драйвер 1С выполняет преобразование типов "на лету".

Поэтому, когда мы говорим о получении строки, мы должны четко разграничивать: нам нужно строковое представление для пользователя (с дефисами и фигурными скобками) или "чистая" строка для передачи во внешнюю систему (только HEX-символы).

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

Метод ToString() в выражениях запроса

Самым надежным и рекомендуемым способом получения строкового представления идентификатора является использование метода ToString(). Этот метод доступен для объектов типа УникальныйИдентификатор непосредственно в тексте запроса.

При вызове этого метода платформа генерирует строку в стандартном формате: 32 шестнадцатеричных символа, разделенных дефисами на группы 8-4-4-4-12. Фигурные скобки при этом обычно не добавляются, если не specified иное в настройках формата, но стандартный вывод дает именно дефисы.

Пример использования в запросе выглядит следующим образом:

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

Использование метода ToString() предпочтительнее, так как оно выполняется на стороне сервера 1С и не зависит от особенностей конкретной СУБД. Это обеспечивает переносимость кода между файловым и клиент-серверным вариантами работы.

Альтернативный способ через СтрЗаменить

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

Однако важно помнить: функция СтрЗаменить работает со строками. Если вы попытаетесь передать в нее поле типа УникальныйИдентификатор, система сначала неявно преобразует его в строку (обычно в формат с фигурными скобками), а затем выполнит замену.

Рассмотрим пример удаления фигурных скобок и дефисов для получения "чистого" HEX-кода:

ВЫБРАТЬ
СтрЗаменить(
СтрЗаменить(
СтрЗаменить(
Справочник.Контрагенты.УникальныйИдентификатор(),
"{", ""
),
"}", ""
),
"-", ""
) КАК ЧистыйUUID
ИЗ
Справочник.Контрагенты

Такой подход является более ресурсоемким, так как требует нескольких проходов по строке. Кроме того, он менее читаем и сложнее в поддержке.

Работа с GUID во внешних источниках данных

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

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

В таблице ниже приведено сравнение результатов различных методов преобразования для одного и того же идентификатора:

Метод получения	Пример результата	Длина строки	Наличие разделителей
Неявное приведение	{C6A75B1D-...}	38 символов	Да (+ скобки)
Метод .ToString()	C6A75B1D-...	36 символов	Да (дефисы)
СтрЗаменить (полная очистка)	C6A75B1D...	32 символа	Нет
Формат "ЧГ"	Зависит от локали	Переменная	Зависит

Выбор конкретного метода зависит от требований принимающей системы. Например, многие веб-сервисы ожидают UUID без дефисов, в то время как стандарты XML или JSON могут требовать классического формата.

Особенности форматирования и локаль

Одной из скрытых проблем при работе с идентификаторами является зависимость от региональных настроек. Хотя сам УникальныйИдентификатор не зависит от локали, способы его строкового представления могут варьироваться.

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

Рекомендуется всегда явно указывать формат или использовать методы, гарантирующие инвариантность результата. Метод ToString() в большинстве реализаций 1С возвращает результат, независимый от текущей локали сеанса, что делает его безопасным выбором.

Если вы формируете строку вручную через конкатенацию частей байтового массива (что иногда делают в низкоуровневом программировании), убедитесь, что порядок байт (Endianness) соответствует ожидаемому стандарту UUID.

⚠️ Внимание: При выгрузке данных в текстовые файлы (CSV, TXT) убедитесь, что кодировка файла поддерживает символы, используемые в UUID. Хотя стандартный UUID содержит только латиницу и цифры, проблемы могут возникнуть, если вы добавляете дополнительные служебные символы или комментарии.

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

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

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

Кроме того, если поле УникальныйИдентификатор участвует в условии отбора (WHERE) или группировки (GROUP BY), лучше использовать исходный тип данных, а не его строковое представление. Преобразование в строку перед группировкой может помешать использованию индексов базы данных.

Стратегия оптимизации должна быть следующей: храните и фильтруйте данные в родном типе UUID, а преобразование в строку выполняйте только на самом последнем этапе — непосредственно перед выводом пользователю или отправкой во внешний файл.

Техническая деталь о хранении UUID

Внутри таблицы SQL Server тип uniqueidentifier занимает 16 байт. При хранении в виде строки (nvarchar(36)) он занимает 72 байта (36 символов * 2 байта на символ). Это увеличивает размер индекса и страницы данных почти в 4.5 раза, что напрямую влияет на скорость выборки и объем занимаемой памяти.

Частые ошибки и способы их устранения

Разработчики часто допускают ошибку, пытаясь сравнить строковое значение с полем типа UUID напрямую в запросе. Например, конструкция ГДЕ ПолеУникальногоИдентификатора = "СтрокаСID" в большинстве случаев вызовет ошибку типов или вернет пустой результат.

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

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

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

Как получить пустой UUID программно?

Используйте конструктор Новый УникальныйИдентификатор("") или Новый УникальныйИдентификатор(0). В запросах можно использовать константу, предварительно созданную в коде и переданную как параметр.

Можно ли преобразовать строку обратно в УникальныйИдентификатор внутри запроса?

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

Почему мой UUID в выгрузке содержит фигурные скобки?

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

Влияет ли регистр букв (A-F или a-f) на уникальность?

Нет, для логики работы 1С и большинства внешних систем регистр шестнадцатеричных символов в UUID не имеет значения. Однако для единообразия и соответствия стандартам (RFC 4122) рекомендуется использовать строчные или заглавные буквы последовательно.

Как ускорить запрос, если нужно отфильтровать по списку UUID из строки?

Лучший способ — передать список UUID как параметр запроса типа Массив или Список Значений с типом элементов УникальныйИдентификатор, а не передавать одну длинную строку и парсить её внутри запроса.