Gerenciar um espaço de trabalho com o Git (visualização)

Este artigo orienta você pelas seguintes tarefas básicas na ferramenta de integração Git do Microsoft Fabric:

• Conectar-se a um repositório Git
• Confirmar alterações
• Atualização do Git
• Desconectar do Git

É recomendável ler a visão geral da integração do Git antes de começar.

Importante

Este recurso está em pré-visualização.

Pré-requisitos

Para integrar o Git ao seu espaço de trabalho do Microsoft Fabric, você precisa configurar os seguintes pré-requisitos no Azure DevOps e no Fabric.

Pré-requisitos do Azure DevOps

• Uma conta ativa do Azure registrada para o mesmo usuário que está usando o espaço de trabalho Malha. Crie uma conta gratuita.
• Acesso a um repositório existente.

Pré-requisitos de malha

Para acessar o recurso de integração do Git, você precisa de uma das seguintes opções:

• Licença do Power BI Premium. Uma licença premium do Power BI suporta apenas todos os itens do Power BI.
• Capacidade do tecido. Uma capacidade de malha é necessária para usar todos os itens de malha suportados.

Além disso, o administrador da sua organização precisa habilitar a opção Usuários podem criar locatário de itens de malha a partir do Portal de administração.

Conectar um espaço de trabalho a um repositório do Azure

Somente um administrador de espaço de trabalho pode conectar um espaço de trabalho a um Repositório do Azure, mas, uma vez conectado, qualquer pessoa com permissão pode trabalhar no espaço de trabalho. Se você não for um administrador, peça ajuda ao administrador para se conectar. Para conectar um espaço de trabalho a um Azure Repo, siga estas etapas:

1. Entre no Power BI e navegue até o espaço de trabalho ao qual você deseja se conectar.

2. Vá para Configurações do espaço de trabalho

   

   Nota

   Se não vir o ícone Definições da área de trabalho, selecione as reticências (três pontos) e, em seguida, as definições da área de trabalho.

3. Selecione Integração Git. Você está automaticamente conectado à conta do Azure Repos registrada no usuário do Microsoft Entra conectado ao Fabric.

   

4. No menu suspenso, especifique os seguintes detalhes sobre a ramificação à qual você deseja se conectar:

   Nota

   Você só pode conectar um espaço de trabalho a uma ramificação e uma pasta de cada vez.

   • Organização
   • Projeto
   • Repositório Git
   • Ramificação (Selecione uma ramificação existente usando o menu suspenso ou selecione + Nova ramificação para criar uma nova ramificação. Você só pode se conectar a uma ramificação de cada vez.)
   • Pasta (Selecione uma pasta existente na ramificação ou insira um nome para criar uma nova pasta. Se você não selecionar uma pasta, o conteúdo será criado na pasta raiz. Você só pode se conectar a uma pasta de cada vez.)

5. Selecione Conectar e sincronizar.

Durante a sincronização inicial, se o espaço de trabalho ou a ramificação do Git estiver vazio, o conteúdo será copiado do local não vazio para o local vazio. Se o espaço de trabalho e a ramificação do Git tiverem conteúdo, você será perguntado em qual direção a sincronização deve seguir. Para obter mais informações sobre essa sincronização inicial, consulte Conectar e sincronizar.

Depois de se conectar, o espaço de trabalho exibe informações sobre o controle do código-fonte que permite ao usuário exibir a ramificação conectada, o status de cada item na ramificação e a hora da última sincronização.

Para manter seu espaço de trabalho sincronizado com a ramificação do Git, confirme todas as alterações feitas no espaço de trabalho para a ramificação do Git e atualize seu espaço de trabalho sempre que alguém criar novas confirmações para a ramificação do Git.

Confirmar alterações no git

Depois de se conectar com êxito a uma pasta Git, edite seu espaço de trabalho como de costume. Todas as alterações salvas são salvas somente no espaço de trabalho. Quando estiver pronto, você pode confirmar suas alterações na ramificação do Git ou pode desfazer as alterações e reverter para o status anterior. Leia mais sobre compromissos.

Comprometa-se com o Git

Para confirmar suas alterações na ramificação do Git, siga estas etapas:

1. Aceder à área de trabalho.

2. Selecione o ícone Controle do código-fonte. Este ícone mostra o número de alterações não confirmadas.

3. Selecione a guia Alterações do painel Controle do código-fonte. É apresentada uma lista com todos os itens que alterou e um ícone que indica se o item é novo, modificado, em conflito ou eliminado.

4. Selecione os itens que deseja confirmar. Para selecionar todos os itens, marque a caixa superior.

5. Adicione um comentário na caixa. Se você não adicionar um comentário, uma mensagem padrão será adicionada automaticamente.

6. Selecione Confirmar.

   

Depois que as alterações forem confirmadas, os itens que foram confirmados serão removidos da lista e o espaço de trabalho apontará para a nova confirmação com a qual foi sincronizado.

Depois que a confirmação for concluída com êxito, o status dos itens selecionados mudará de Não confirmado para Sincronizado.

Desfazer alteração salva

Depois de salvar as alterações no espaço de trabalho, se você decidir que não deseja confirmar essas alterações no git, poderá desfazer as alterações e reverter esses itens para o status anterior. Para desfazer as alterações, siga estes passos:

1. Aceder à área de trabalho.

2. Selecione o botão Controle do código-fonte. Este botão também mostra o número de alterações não confirmadas.

3. Selecione a guia Alterações do painel Controle do código-fonte. Uma lista é exibida com todos os itens que você alterou e um ícone indicando se o item alterado é novo, modificado, conflitante ou excluído.

4. Selecione as alterações que deseja desfazer.

5. Selecione Desfazer.

   

6. Selecione Desfazer novamente para confirmar.

   

Os itens selecionados em seu espaço de trabalho revertem para como eram quando o espaço de trabalho foi sincronizado pela última vez.

Importante

Se você excluir um item e, em seguida, desfazer as alterações, o item será criado novamente e alguns dos metadados poderão ser perdidos. Por exemplo, os rótulos de sensibilidade não são mantidos e devem ser redefinidos, e o proprietário do item é definido como o usuário atual.

Atualizar espaço de trabalho a partir do Git

Sempre que alguém confirma uma nova alteração na ramificação do Git conectada, uma notificação aparece no espaço de trabalho relevante. Use o painel Controle do código-fonte para extrair as alterações mais recentes, mesclar ou reverter para o espaço de trabalho e atualizar itens dinâmicos. Leia mais sobre a atualização.

Para atualizar um espaço de trabalho, siga estas etapas:

1. Aceder à área de trabalho.
2. Selecione o ícone Controle do código-fonte.
3. Selecione a guia Atualizações do painel Controle do código-fonte. Uma lista é exibida com todos os itens que foram alterados na ramificação desde a última atualização.
4. Selecione Atualizar tudo.

Depois que a atualização for bem-sucedida, a lista de itens será removida e o espaço de trabalho apontará para a nova confirmação com a qual foi sincronizado.

Depois que a atualização for concluída com êxito, o status dos itens será alterado para Sincronizado.

Desconectar um espaço de trabalho do Git

Somente um administrador de espaço de trabalho pode desconectar um espaço de trabalho de um Repositório do Azure. Se você não for um administrador, peça ajuda ao administrador para desconectar. Se você for um administrador e quiser desconectar seu repositório, siga estas etapas:

1. Vá para Configurações do espaço de trabalho

2. Selecione a integração com o Git

3. Selecione Desconectar espaço de trabalho

   

4. Selecione Desconectar novamente para confirmar.

   

Permissões

As ações que você pode executar em um espaço de trabalho dependem das permissões que você tem no espaço de trabalho e no Azure DevOps. Para obter uma discussão mais detalhada sobre permissões, consulte Permissões.

Considerações e limitações

• Durante o processo Commit to Git , o serviço Fabric exclui todos os arquivos dentro da pasta de item que não fazem parte da definição de item. Arquivos não relacionados que não estão em uma pasta de item não são excluídos.

• Depois de confirmar alterações, você pode notar algumas alterações inesperadas no item que não fez. Estas alterações são semanticamente insignificantes e podem acontecer por várias razões. Por exemplo:

  • Alterar manualmente o arquivo de definição de item. Essas alterações são válidas, mas podem ser diferentes do que se feitas através dos editores. Por exemplo, se você renomear uma coluna de modelo semântico no Git e importar essa alteração para o espaço de trabalho, da próxima vez que confirmar alterações no modelo semântico, o arquivo bim será registrado como alterado e a coluna modificada enviada para a parte de trás da columns matriz. Isso ocorre porque o mecanismo AS que gera os arquivos bim envia colunas renomeadas para o final da matriz. Essa alteração não afeta a maneira como o item opera.

  • Confirmando um arquivo que usa quebras de linha CRLF . O serviço usa quebras de linha LF (alimentação de linha). Se você tinha arquivos de item no repositório Git com quebras de linha CRLF , quando você confirma a partir do serviço, esses arquivos são alterados para LF. Por exemplo, se você abrir um relatório na área de trabalho, salve o projeto .pbip e carregue-o no Git usando CRLF.

• Se você estiver tendo problemas com essas ações, certifique-se de entender as limitações do recurso de integração do Git.

Conteúdos relacionados

• Compreender o processo de integração do Git
• Gerenciar filiais do Git
• Práticas recomendadas de integração com Git