Gerenciar um espaço de trabalho com o Git (versão prévia).

Este artigo o orienta nas seguintes tarefas básicas da ferramenta de integração do Git do Microsoft Fabric:

• Conectar-se a um repositório Git
• Confirmar alterações
• Atualizar a partir do Git
• Desconectar do Git

Recomenda-se fazer a leitura da visão geral da integração do Git antes de começar.

Importante

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

Pré-requisitos

Para integrar o Git ao seu espaço de trabalho do Microsoft Fabric, você precisará 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á utilizando o espaço de trabalho do Fabric. Criar uma conta gratuita.
• Acesso a um repositório existente.

Pré-requisitos do Fabric

Para acessar o recurso de integração do Git, você precisa de um dos itens a seguir:

• Licença do Power BI Premium. Uma licença do Power BI Premium dá suporte apenas a todos os itens do Power BI.
• Capacidade do Fabric. É exigida uma capacidade do Fabric para usar todos os itens suportados do Fabric.

Além disso, o administrador da sua organização precisa habilitar Usuários podem criar itens do Fabric na opção de locatário no portal do Administrador.

Conectar um espaço de trabalho a um Azure Repos

Somente um administrador do espaço de trabalho pode conectar um espaço de trabalho a um Azure Repos, 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 seu administrador para fazer a conexão. Para conectar um espaço de trabalho a um Azure Repos, siga estas etapas:

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

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

   

   Observação

   Se não estiver conferindo o ícone de configurações do Espaço de Trabalho, selecione as reticências (três pontos) e depois as configurações do espaço de trabalho.

3. Selecione Integração do Git. Você é automaticamente conectado à conta do Azure Repos registrada no usuário do Microsoft Entra que entrou no espaço de trabalho.

   

4. No menu suspenso, especifique os seguintes detalhes sobre a filial à qual você quer se conectar:

   Observação

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

   • Organização
   • Project
   • Repositório do Git
   • Branch(Selecione uma ramificação existente usando o menu suspenso ou selecione + Novo Branch para criar uma nova ramificação. Você só pode se conectar a um branch por 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. Só é possível conectar-se a uma pasta por vez.)

5. Selecione Conectar e sincronizar.

Durante a sincronização inicial, se o espaço de trabalho ou a GIT branch estiver vazia, o conteúdo será copiado do local não vazio para o vazio. Se tanto o espaço de trabalho quanto a GIT branch tiverem conteúdo, você será questionado sobre qual direção a sincronização deve seguir. Para obter mais informações sobre essa sincronização inicial, confira Conectar e Sincronizar.

Após a conexão, o Espaço de Trabalho exibirá informações sobre o controle do código-fonte que permitem ao usuário visualizar a ramificação conectada, o status de cada item na ramificação e o tempo da última sincronização.

Para manter seu espaço de trabalho sincronizado com a GIT branch, confirme todas as alterações que fizer no espaço de trabalho para a GIT branch e atualize seu espaço de trabalho sempre que alguém criar novas confirmações na GIT branch.

Confirmar as alterações para o Git

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

Confirmar para o Git

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

1. Acesse o workspace.

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

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

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 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 as confirmações são concluídas com êxito, o status dos itens selecionados muda de Não confirmado para Sincronizado.

Desfazer a alteração salva

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

1. Acesse o workspace.

2. Selecione o botão Controle do código-fonte. Esse 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. Será exibida uma lista com todos os itens que você alterou e um ícone indicando se o item alterado é novo , modificado , conflito , 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 voltam a ser como eram quando o espaço de trabalho foi sincronizado pela última vez.

Importante

Se você excluir um item e depois desfizer as alterações, o item será criado novamente e alguns metadados poderão ser perdidos. Por exemplo, os rótulos de confidencialidade não serão mantidos e deverão ser redefinidos, e o proprietário do item será 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 é exibida no espaço de trabalho relevante. Utilize o painel Controle do código-fonte para obter as últimas alterações, mesclagens ou reversões no Espaço de Trabalho e atualizar os itens ativos. Leia mais sobre as atualizações.

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

1. Acesse o workspace.
2. Selecione o ícone Controle do código-fonte.
3. Selecione a guia Atualizações do painel Controle do código-fonte. É exibida uma lista com todos os itens 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

Apenas um administrador do espaço de trabalho pode desconectar um espaço de trabalho de um Azure Repos. Se você não for um administrador, peça ajuda ao seu 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 Integração do Git

3. Selecione Desconectar o espaço de trabalho

   

4. Selecione Desconectar novamente para confirmar.

   

Permissões

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

Considerações e limitações

• Durante o processo Confirmar para o Git, o serviço Fabric exclui todos os arquivos dentro da pasta do item que não fazem parte da definição do item. Arquivos não relacionados que não estejam em uma pasta de item não serão excluídos.

• Após confirmar as alterações, você poderá notar algumas mudanças inesperadas no item que não foram feitas por você. Essas alterações são semanticamente insignificantes e podem ocorrer por vários motivos. Por exemplo:

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

  • Confirmações de um arquivo que utiliza as quebras de linha CRLF. O serviço utiliza as quebras de linha LF (avanço de linha). Se você tiver arquivos de itens no repositório do Git com quebras de linha CRLF, quando você confirmar a partir do serviço, esses arquivos serão alterados para LF. Por exemplo, se você abrir um relatório no desktop, salve o projeto .pbip e carregue-o no Git usando CRLF.

• Se estiver tendo problemas com essas ações, verifique se entendeu as limitações do recurso de integração do Git.

Conteúdo relacionado

• Entender o processo de integração do Git
• Gerenciar os GIT branches
• Melhores práticas de integração do Git