Gerenciar ramificações nos espaços de trabalho do Microsoft Fabric

O espaço de trabalho do Fabric é um ambiente compartilhado que acessa itens ativos. Quaisquer alterações feitas diretamente no espaço de trabalho substituem e afetam todos os outros usuários do espaço de trabalho. Entretanto, a melhor prática do Git é que os desenvolvedores trabalhem isoladamente fora dos espaços de trabalho compartilhados. Existem duas maneiras de um desenvolvedor trabalhar em seu próprio espaço de trabalho protegido.

• Desenvolver utilizando ferramentas de clientes, como o Power BI Desktop para relatórios e modelos semânticos, ou o VS Code para notebooks.
• Desenvolva em um espaço de trabalho separado. Cada desenvolvedor tem seu próprio espaço de trabalho, no qual conecta sua própria ramificação separada, sincroniza o conteúdo nesse espaço de trabalho e, em seguida, confirma de volta à ramificação.

Importante

Esse recurso está em versão prévia.

Para trabalhar com ramificações usando a integração do Git, primeiro conecte o espaço de trabalho da equipe de desenvolvimento compartilhado a uma única ramificação compartilhada. Por exemplo, se a sua equipe utiliza um espaço de trabalho compartilhado, conecte-o à ramificação principal no repositório da sua equipe e sincronize entre o espaço de trabalho e o repositório. Se o fluxo de trabalho da sua equipe tiver várias ramificações compartilhadas, como Desenvolvimento/Teste/Produção, cada ramificação poderá ser conectada a um espaço de trabalho diferente.

Assim, cada desenvolvedor pode escolher o ambiente isolado no qual trabalhará.

Desenvolver utilizando ferramentas de clientes

O fluxo de trabalho para desenvolvedores que utilizam uma ferramenta cliente, como o Power BI Desktop, deve ser mais ou menos assim:

1. Clone o repositório em um computador local. (Você só precisa realizar essa etapa uma vez.)

2. Abra o projeto no Power BI Desktop utilizando a cópia local do PBIProj.

3. Faça alterações e salve os arquivos atualizados localmente. Confirmar no repositório local.

4. Quando estiver pronto, faça push da ramificação e confirmações no repositório remoto.

5. Teste as alterações em relação a outros itens ou mais dados, conectando a nova ramificação a um espaço de trabalho separado e fazendo upload do modelo semântico e dos relatórios utilizando o botão atualizar tudo no painel de controle do código-fonte. Faça quaisquer testes ou alterações de configuração que existam antes de mesclar com a ramificação principal.

   Se nenhum teste for exigido no espaço de trabalho, o desenvolvedor poderá mesclar as alterações diretamente na ramificação principal, sem a necessidade de outro espaço de trabalho.

6. Depois que as alterações são mescladas, o espaço de trabalho da equipe compartilhada é solicitado a aceitar a nova confirmação. As alterações são atualizadas no espaço de trabalho compartilhado e todos podem conferir as alterações nesses modelos semânticos e relatórios.

Para obter diretrizes específicas sobre como utilizar o novo formato de arquivo do Power BI Desktop no Git, confira Formato de código-fonte.

Desenvolver utilizando outro espaço de trabalho

Para um desenvolvedor que trabalha na Web, o fluxo seria o seguinte:

1. Crie um novo espaço de trabalho (ou use um espaço existente que você já utiliza).

2. Atribua a esse espaço de trabalho uma licença Premium.

3. Vá para Integração do Git nas configurações do espaço de trabalho e especifique os detalhes do repositório.

4. No menu suspenso Ramificação, selecione Criar um nova ramificação e faça a ramificação a partir da ramificação principal.

5. Em Pasta do Git, insira o nome da pasta com a qual deseja sincronizar em seu repositório.

   O espaço de trabalho é sincronizado com sua ramificação de recursos e se torna uma cópia do espaço de trabalho da equipe de desenvolvimento, conforme ilustrado. Agora você pode trabalhar nesse novo ambiente isolado.

   

6. Salve suas alterações e confirme elas na ramificação do recurso.

7. Quando estiver pronto, crie um PR para a ramificação principal. Os processos de revisão e mesclagem são feitos por meio do Azure Repos com base na configuração que sua equipe definiu para esse repositório.

Quando a revisão e a mesclagem forem concluídas, uma nova confirmação será criada na ramificação principal. Essa confirmação solicita que o usuário atualize o conteúdo no espaço de trabalho da equipe de desenvolvimento com as alterações mescladas.

Alternar branches

Se seu espaço de trabalho estiver conectado a uma ramificação do Git e você quiser alternar para outra ramificação, poderá fazer isso rapidamente nas configurações do espaço de trabalho sem precisar desconectar e reconectar.
Quando você alterna as ramificações, o espaço de trabalho é sincronizado com a nova ramificação e todos os itens no espaço de trabalho são substituídos. Se existirem versões diferentes do mesmo item em cada ramificação, o item será substituído. Se um item estiver na ramificação antiga, mas não na nova, ele será excluído. Para alternar entre as ramificações, siga estas etapas:

1. Verifique se a ramificação atual está sincronizada e se todas as alterações foram confirmadas.

2. Em Configurações do espaço de trabalho, selecione Integração do Git

3. No menu suspenso, especifique a ramificação à qual deseja se conectar. Essa ramificação deve conter o mesmo diretório que a ramificação atual.

4. Selecione Conectar e sincronizar.

   

5. Selecione Alternância e sincronização novamente para confirmar. Se houver alterações não salvas no espaço de trabalho, elas serão perdidas se você alternar as ramificações sem salvá-las primeiro. Selecione Cancelar para retornar e salvar suas alterações antes de alternar as ramificações.

   

Conteúdo relacionado

• Resolução de erros e conflitos
• Melhores práticas de integração do Git