Criar e gerenciar um conjunto de tags

Este artigo descreve como criar e gerir um conjunto de etiquetas no Microsoft Fabric. O público-alvo é o Fabric e os administradores de domínio que desejam definir e gerenciar tags dentro de sua organização ou domínios específicos.

Para obter mais informações sobre tags, consulte Tags no Microsoft Fabric.

Como administrador de malha ou domínio, você pode:

  • Crie um conjunto de etiquetas que os utilizadores na sua organização ou domínio possam usar para categorizar os seus itens de Fabric.
    • Renomeie etiquetas. Se desejar ou necessário, você pode renomear uma tag. Quando você renomeia uma tag, seu nome muda sempre que a tag é aplicada.
    • Elimina uma tag. Se decidir que uma etiqueta não é necessária, pode eliminá-la do conjunto de etiquetas que definiu. Quando você exclui uma tag do conjunto de tags definidas, ela é removida de todos os itens em que foi aplicada anteriormente.

As etiquetas que defines também podem ser aplicadas aos espaços de trabalho pelos administradores através das definições do espaço de trabalho. As etiquetas de áreas de trabalho aplicadas são visíveis como indicadores nas páginas das áreas de trabalho e podem ser usadas para pesquisa e filtragem nas listas de áreas de trabalho e no OneLake Catalog Explorer.

Pré-requisitos

Você deve ter uma função de administrador do Fabric para criar e gerenciar etiquetas no nível do locatário.

Você deve ter uma função de administrador de malha ou administrador de domínio para criar e gerenciar marcas de nível de domínio em seus domínios atribuídos.

Limites

  • Até 10.000 tags de todos os tipos podem ser criadas em um tenant.
  • Os administradores de espaços de trabalho podem aplicar até 10 etiquetas por espaço de trabalho.
  • Apenas etiquetas definidas ao nível do tenant ou domínio estão disponíveis para seleção nas configurações do espaço de trabalho.

Criar tags no nível do inquilino

Esta secção mostra como os administradores do Fabric criam um conjunto de etiquetas ao nível do inquilino. Essas tags estão disponíveis em todo o locatário do Fabric.

  1. Abra o portal de administração e selecione Tags. A aba Tags é aberta. Todas as tags de nível de inquilino definidas atualmente são listadas no separador.

  2. Selecione + Nova tag. Se nenhuma tag estiver definida ainda, selecione Adicionar suas primeiras tags.

  3. Na caixa de diálogo exibida, forneça nomes para suas novas tags. Use nomes separados por vírgulas para criar mais de uma tag de cada vez. Os nomes das etiquetas podem ter até 40 caracteres e podem conter letras, números, espaços (não no início) e caracteres especiais (devem também conter letras e/ou números).

    Captura de ecrã a mostrar como criar duas novas etiquetas.

  4. Quando terminar, selecione Criar. As novas tags são adicionadas ao conjunto de tags.

Criar tags no nível do domínio

Esta seção mostra como os administradores de domínio criam e gerenciam tags específicas para seus domínios atribuídos. Essas tags só estão disponíveis para itens dentro de espaços de trabalho atribuídos a esse domínio e subdomínios sob ele.

Regras de exclusividade de tags

Ao criar tags no nível do domínio, considere as seguintes regras de exclusividade:

  • Uma tag criada no nível do locatário não pode ser duplicada no nível do domínio e vice-versa. Se você tentar criar uma tag que duplique uma existente em um escopo diferente (locatário ou domínio), uma mensagem de erro indicará a tag existente e seu escopo.

    Captura de ecrã a mostrar o erro que aparece quando já existe uma etiqueta.

  • Você pode criar o mesmo nome de tag em domínios diferentes. Por exemplo, você pode adicionar uma tag chamada "FY2025" separadamente nos domínios "Vendas" e "Marketing".

  • Se você reatribuir um espaço de trabalho de um domínio para outro, todas as tags específicas do domínio já aplicadas aos itens nesse espaço de trabalho permanecerão nesses itens. Essa abordagem mantém a continuidade e ajuda a evitar confusões sobre a marcação anterior. No entanto, não é possível reaplicar tags de um domínio anterior a itens se o espaço de trabalho não estiver mais associado a esse domínio.

Etapas para criar tags no nível do domínio

  1. Abra o portal de administração.
  2. No portal de administração, selecione Domínios.
  3. Escolha o domínio específico para o qual você deseja criar ou gerenciar tags.
  4. Nas configurações de domínio, selecione Tags para exibir todas as tags de nível de domínio definidas atualmente para esse domínio.
  5. Para criar uma nova etiqueta de domínio, selecione + Nova etiqueta ou Adicionar as suas primeiras etiquetas , caso não exista.
  6. Na caixa de diálogo, forneça nomes para suas novas tags. Você pode usar nomes separados por vírgulas para criar várias tags simultaneamente.
  7. Os nomes das tags podem conter letras, números, espaços (não no início) e caracteres especiais (também devem conter letras e/ou números).
  8. Selecione Criar para adicionar as novas tags ao conjunto de tags do domínio.

Renomear uma tag

Você pode renomear as tags de nível de locatário e de domínio.

  1. Abra o portal de administração e selecione Tags (para tags no nível do locatário) ou navegue até Domínios e, em seguida, Tags dentro do seu domínio específico (para tags no nível do domínio).

  2. Abra o menu de opções da tag que você deseja renomear e selecione Renomear.

    Captura de ecrã a mostrar como mudar o nome de uma etiqueta.

  3. Altere o nome conforme desejado e selecione Renomear. O novo nome é refletido onde quer que a tag seja aplicada.

Excluir uma tag do conjunto de tags

Você pode excluir tags de nível de locatário e de domínio.

  1. Abra o portal de administração e selecione Tags (para tags no nível do locatário) ou navegue até Domínios e, em seguida, Tags dentro do seu domínio específico (para tags no nível do domínio).

  2. Abra o menu de opções da tag que deseja excluir e selecione Excluir.

    Captura de ecrã a mostrar como eliminar uma etiqueta do conjunto de etiquetas.

    A tag é excluída do conjunto de tags definidas e é removida de todos os itens onde foi aplicada anteriormente.

Criar e gerenciar tags programaticamente

Todas as ações relacionadas à criação e gerenciamento de tags podem ser executadas programaticamente por meio de APIs. Além disso, as tags são incluídas nas APIs do Metadata Scanning (Scanner) para que as soluções de governança e descoberta possam coletar atribuições de tags em escala.

Tags REST APIs

Use as APIs de administração REST do Fabric para tags para criar, listar, renomear e excluir tags de nível de locatário e domínio de forma programática, permitindo automatizar o ciclo de vida das tags e os fluxos de trabalho de governança. Para obter mais informações, consulte APIs de administração REST Fabric para tags.

Tags em APIs de verificação de metadados (scanner)

As APIs do Scanner incluem tags aplicadas para cada item digitalizado. Para cada item aplicável retornado numa verificação, o payload inclui um campo tags contendo uma lista de UUIDs de tags aplicados. Para resolver IDs de etiquetas para nomes de etiquetas, use a API REST de administração Lista de Etiquetas.

Para obter mais informações, consulte Visão geral da verificação de metadados.

Conteúdos relacionados

  • Last updated on