Skip to content

Унифицированное имя ресурса (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 для термина: urn🇱🇮glossaryTerm:attr

Создание URN

Ограничения

При создании URN существуют следующие ограничения на использование символов. Пожалуйста, не используйте эти символы при создании или генерации URN: - Запятые , являются зарезервированными символами, - Скобки (, ) являются зарезервированными символами, - Двоеточия : являются зарезервированными символами.

Сложный URN

Также в Каталоге данных можно встретить и более сложный URN. Сложный URN может даже содержать другие URN в качестве полей ID. Этот тип URN также называется вложенным.

Примеры сложного URN:

  • URN датасета:
    urn🇱🇮dataset:(urn🇱🇮dataPlatform:oracle,EXD.dmfr.st_ass_deal_mtsproduct,PROD)

  • URN платформ-инстанса:
    urn🇱🇮dataPlatformInstance:(urn🇱🇮dataPlatform:elasticsearch,MOOS)