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:

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:

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

Screenshot of Fabric switch enabled.

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

    Screenshot of workspace with workspace settings icon displayed on top.

    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. Screenshot of workspace with workspace settings link displayed from ellipsis.

  3. Selecionar 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.

    Screenshot of workspace settings window with Git integration selected.

  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.

Screenshot of source control icon and other Git information.

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.

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. Screenshot of source control icon with the number 2 indicating that there are two changes to commit.

  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.

    Screenshot of source control window with two changes selected to commit.

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.

Screenshot of source control window stating that there are no changes to commit.

Depois que as confirmações são concluídas com êxito, o status dos itens selecionados muda de Não confirmado para Sincronizado.

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.

Screenshot of source control pane with the update tab open and the updating all button selected.

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.

Screenshot of source control window stating that you successfully updated the workspace.

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

    Screenshot of workspace settings screen with disconnect workspace option.

  4. Selecione Desconectar novamente para confirmar.

    Screenshot of workspace settings screen asking if you're sure you want to disconnect.

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.