Унифицированное имя ресурса (URN - Uniform Resource Name)
URN (Uniform Resource Name) — это способ уникальной идентификации любого объекта в Каталоге данных. Он предназначен для того, чтобы упростить и ускорить поиск объектов, обеспечивая их однозначное представление. Поскольку URN может быть создан пользователем, он может иметь интуитивно понятное имя.
Формат URN
URN имеет следующую структуру: urn:<Namespace>:<Entity Type>:<ID>
,
где Namespace - пространство имен. Все URN, доступные в Каталоге данных, используют li в качестве своего пространства имен. Оно может быть изменено на другое пространство имен для вашей организации;
Entity Type - тип объекта. Его можно рассматривать как тип объекта, для каждого экземпляра которого вам нужен уникальный идентификатор.
ID — это уникальная часть URN. Он уникален для определенного типа объекта в определенном пространстве имен. ID может содержать одно поле или несколько полей в случае сложных URN.
Примеры URN:
- URN контейнера: urn
container:443386b2fcdb3ba361381a840a9cd9ca
- URN пользователя: urn
corpuser:ivanov
- URN платформ-инстанса: urn
dataPlatform:kafka
- URN тега: urn
tag:promocodes
- URN продукта: urn
mtsProduct:BI_2681
Создание URN через интерфейс
При создании нового объекта в Каталоге данных (домен, термин, тег, группа) пользователь может создать уникальное имя объекта через интерфейс.
В разделе Advanced при создании объекта нужно ввести ID, который будет отражать суть создаваемого объекта. Затем Каталог данных сформирует URN, добавив недостающие параметры: Namespace и Entity Type. Если в Каталоге данных будет совпадение по URN, то вам не удастся сохранить объект с таким ID.
Пример создания URN для термина: urnglossaryTerm:attr
Ограничения
При создании URN существуют следующие ограничения на использование символов. Пожалуйста, не используйте эти символы при создании или генерации URN:
- Запятые ,
являются зарезервированными символами,
- Скобки (
, )
являются зарезервированными символами,
- Двоеточия :
являются зарезервированными символами.
Сложный URN
Также в Каталоге данных можно встретить и более сложный URN. Сложный URN может даже содержать другие URN в качестве полей ID. Этот тип URN также называется вложенным.
Примеры сложного URN:
-
URN датасета:
urndataset:(urn
dataPlatform:oracle,EXD.dmfr.st_ass_deal_mtsproduct,PROD)
-
URN платформ-инстанса:
urndataPlatformInstance:(urn
dataPlatform:elasticsearch,MOOS)