Como criar domínios no Microsoft Fabric

No Microsoft Fabric, você pode criar domínios e subdomínios que elevam a governança do seu Tenant, segregando os workspaces de acordo com:

  • Capacidades
  • Áreas de negócio
  • Administradores dos workspaces
  • Personas ( Engenharia/BI )
  • Branches do git
  • entre outros…

Eu publiquei um vídeo no YouTube onde demonstro na prática a criação de dominios. Confira abaixo.

Como criar utilizando o portal de administração

Para criar domínios você precisa ser administrador do Fabric.

Vá até o portal de administração do Microsoft Fabric

E encontre a seção domínios e inice a partir do scratch para criar um domínio.

Você pode dar um nome para o seu domínio por exemplo Comercial onde vou atribuir todos os workspaces da área Comercial.

Neste momento também é possível definir os admistradores daquele domínio. Os administradores do domínio podem alterar as configurações e adiconar ou remover workspaces do domínio.

O domínio é criado.

Atribuindo workspaces ao domínio

Basta clicar no nome do domínio recém-criado e depois em atribuir workspaces.

Nesta tela agora você pode escolher entre 3 formas de atribuir workspaces:

  • Pelo nome dos workspaces
  • Pelo administrador dos workspaces
  • Pelas capacidades dos workspaces

Atribuir workspaces pelo nome é a maneira mais simples e direta. Basta começar a digitar o nome dos workspaces, selecionar os desejados e aplicar.

Também é possível atribuir os workspaces ao domínio pelo administrador do workspace. No exemplo abaixo quero adicionar pelo Service Principal AppFabric.

A última forma é pela capacidade do workspace. Voce seleciona a capacidade desejada e aplica. Todos os workspaces cujo aquela capacidade está atribuída fara parte do domínio.

Subdomínios

Dentro de um domínio é possível criar subdomínios, ou seja, uma subdivisão dentro daquele domínio.

No exemplo abaixo estou criando subdomínios de engenharia e BI para dividir os workloads em cada subdomínio.

Basta clicar em criar subdomínio, dar o nome desejado. Serão mostrados como se fossem pastas dentro do domínio.

Você selecionar e mover os workspaces para o subdomínio clicando no botão mover para.

Note a hierarquia demonstrada com os workspaces atribuídos no subdomínio.

Quando criamos domínios e subdomínios podemos fixar na exibição dos workspaces usando os filtros. Fica muito mais organizado!

Outra forma de atribuir workspaces a um domínio ou subdomínio já criado é entrando pelas configurações dos workspaces e escolhendo o domínio.

Importante! Um workspace pode estar em apenas um domínio ou subdomínio, ou seja, um mesmo workspace não poder pertencer a mais de um domínio, por isso a estratégia de divisão de domínios deve ser sempre bem pensada e alinhada com o administrador do Tenant.

Outras configurações

Retornando ao portal de administração, entre no domínio e clique configurações do domínio.

Além de alterar o nome na aba geral e colocar uma descrição é possível:

Definir uma imagem de capa para seu domínio que irá aparecer no menu do workspaces.

Definir os administradores do domínio. Estes podem alterar as configurações e adicionar ou removers workspaces do domínio.

Pode ainda definir os contribuidores. Os contribuidores podem atribuir workspaces para um domínio a partir das configurações do workspaces.

Esta opção por padrão vem para toda a organização, mas pode ser alterado para pessoas ou grupos específicos ou ainda restringir somente para os administradores do Tenant e domínio somente.

A última opção é para que você possa especificar usuários e/ou grupos cujos novos workspaces que eles criarem e não forem atribuídos a nenhum domínio sejam atribuídos a este domínio por padrão. Este é recurso útil para definir que qualquer domínio criado por um Service Principal por exemplo seja atribuído a ele.

O menu de configurações dos subdomínios seguem o mesmo padrão dos domínios porém não possui a opção de adicionar imagem e de administradores do domínio pois herdam do nível superior.

Criando domínios e subdomínios com PyFabricOps

Utilizando a biblioteca PyFabricOps você pode criar domínios e atribuir workspaces programaticamente utilizando os notebooks.

Confira neste artigo como instalar: pyFabricOps na prática: Automatizando Microsoft Fabric e Power BI com Python e REST APIs – Alison Pezzott

Crie um notebook no Microsoft Fabric e cole o código abaixo:

Python
# Install if you haven't already.
%pip install -U -qq pyfabricops 

# Authentication
import pyfabricops as pf
pf.set_auth_provider("fabric")

# Setup logger
pf.setup_logging('info', 'minimal') 
logger = pf.get_logger(__name__)

domain = "Comercial"
subdomains = [
  {
    "name": "Engenharia",
    "workspaces":  ["Comercial-ENG-DEV", "Comercial-ENG-PRD"] 
  },
  {
    "name": "BI", 
    "workspaces": ["Comercial-BI-DEV", "Comercial-BI-PRD"]
  } 
]

# Check if domain exists, if not create it
domain_id = pf.get_domain_id(domain)
if not domain_id:
    domain_created = pf.create_domain(domain, df=False) 
    if domain_created:
        domain_id = domain_created['id']
        logger.success(f'Domain {domain} created with ID {domain_id}')

# Create subdomains
for subdomain in subdomains:
    subdomain_id = pf.get_domain_id(subdomain["name"])
    if not subdomain_id:
        subdomain_created = pf.create_domain(subdomain["name"], parent_domain=domain_id, df=False)
        if subdomain_created:
            subdomain_id = subdomain_created['id']
            logger.success(f'Subdomain {subdomain["name"]} created with ID {subdomain_id}')
        
    # Assign workspaces
    ws_ids = []
    for ws in subdomain["workspaces"]:
        ws_id = pf.get_workspace_id(ws)
        if ws_id is not None:
            ws_ids.append(ws_id)
        if len(ws_ids) > 0:
            pf.assign_domain_workspaces_by_ids(subdomain_id, ws_ids)
            logger.success(f'Workspaces {subdomain["workspaces"]} successfully assigned to domain {domain}/{subdomain["name"]}')

            

Considerações finais

Os domínios são elementos cruciais para elevar a governança do ambiente do Microsoft Fabric seja para a administração dos workspaces, inclusive ainda existem outras questões como rótulos de confidencialidade em sinergia com o Microsoft Purview, que podemos abordar em outro post.

Além disso são aliados para facilitar a organização dos workspaces principalmente de Tenants com grande quantidade de deles.

Deixe seu comentário sobre o que achou e assine o blog para ser avisado dos meus novos posts.

Confira aqui a documentação oficial sobre domínio no Microsoft Learn.

Forte abraço e até a próxima!

Compartilhe:

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *