Создание и управление набором тегов

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

Дополнительные сведения о тегах см. в разделе "Теги" в Microsoft Fabric.

Как администратор фабрики или домена, вы можете:

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

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

Предварительные условия

Для создания тегов уровня клиента и управления ими необходимо иметь роль администратора Fabric .

Для создания тегов уровня домена в назначенных доменах необходимо иметь роль администратора Структуры или администратора домена .

Ограничения

  • В клиенте можно создать до 10 000 тегов всех типов.
  • Администраторы рабочей области могут применять до 10 тегов на рабочую область.
  • Для выбора в параметрах рабочей области доступны только теги, определенные на уровне клиента или домена.

Создание тегов уровня арендатора

В этом разделе показано, как администраторы Fabric создают набор тегов уровня клиента. Эти теги доступны во всем клиенте Fabric.

  1. Откройте портал администрирования и выберите теги. Откроется вкладка "Теги ". На вкладке перечислены все текущие определенные теги уровня арендатора.

  2. Выберите +Создать тег. Если теги еще не определены, нажмите кнопку "Добавить первые теги".

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

    Снимок экрана: создание двух новых тегов.

  4. Затем выберите Создать. Новые теги добавляются в набор тегов.

Создание тегов уровня домена

В этом разделе показано, как администраторы домена создают теги, относящиеся к назначенным доменам, и управляют ими. Эти теги доступны только для элементов в рабочих областях, назначенных данному домену и поддоменам.

Правила уникальности тегов

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

  • Тег, созданный на уровне клиента, не может быть дублирован на уровне домена и наоборот. Если вы пытаетесь создать тег, дублирующий существующий в другой области (арендатор или домен), сообщение об ошибке указывает существующий тег и его область.

    Снимок экрана: ошибка, которая отображается, когда тег уже существует.

  • Вы можете создать одно и то же имя тега в разных доменах. Например, можно добавить тег с именем FY2025 отдельно в доменах Sales и Marketing.

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

Действия по созданию тегов уровня домена

  1. Откройте портал администрирования.
  2. На портале администрирования выберите "Домены".
  3. Выберите конкретный домен, для которого требуется создать или управлять тегами.
  4. В параметрах домена выберите теги , чтобы отобразить все определенные теги уровня домена для этого домена.
  5. Чтобы создать новый тег домена, выберите +Создать тег или добавьте первые теги , если нет.
  6. В диалоговом окне укажите имена для новых тегов. Имена, разделенные запятыми, можно использовать для одновременного создания нескольких тегов.
  7. Имена тегов могут содержать буквы, цифры, пробелы (не в начале) и специальные символы (также должны содержать буквы и /или цифры).
  8. Выберите "Создать", чтобы добавить новые теги в набор тегов домена.

Переименование тега

Вы можете переименовать теги уровня клиента и домена.

  1. Откройте портал администрирования и выберите теги (для тегов уровня клиента) или перейдите в домены , а затем теги в определенном домене (для тегов уровня домена).

  2. Откройте меню параметров тега, который вы хотите переименовать, и выберите " Переименовать".

    Снимок экрана: переименование тега.

  3. Измените имя по желанию и нажмите кнопку "Переименовать". Новое имя отражается везде, где применяется тег.

Удаление тега из набора тегов

Вы можете удалить теги уровня клиента и домена.

  1. Откройте портал администрирования и выберите теги (для тегов уровня клиента) или перейдите в домены , а затем теги в определенном домене (для тегов уровня домена).

  2. Откройте меню параметров тега, который вы хотите удалить, и нажмите кнопку "Удалить".

    Снимок экрана: удаление тега из набора тегов.

    Тег удаляется из набора определенных тегов и удаляется из всех элементов, где он был применен ранее.

Создание тегов и управление ими программным способом

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

Теги REST API

Используйте Fabric REST Admin API для тегов, чтобы программно создавать, перечислять, переименовывать и удалять теги на уровне арендатора и домена, что позволяет автоматизировать жизненный цикл тегов и рабочие процессы управления. См. дополнительные сведения в REST API управления Fabric для тегов.

Теги в API сканирования метаданных (сканер)

API сканера включают примененные теги для каждого сканированного элемента. Для каждого применимого элемента, возвращаемого при сканировании, нагрузка включает tags поле, содержащее список примененных идентификаторов тегов. Чтобы преобразовать идентификаторы тегов в имена тегов, используйте REST API List Tags Admin.

Дополнительные сведения см. в обзоре сканирования метаданных.

Связанный контент

  • Last updated on