Comece com a integração do Git

Este artigo orienta você pelas seguintes tarefas básicas na 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

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

Pré-requisitos

Para integrar o Git ao workspace Microsoft Fabric, você precisa configurar os pré-requisitos a seguir para o Fabric e o Git.

Pré-requisitos do Fabric

Para acessar o recurso de integração do Git, você precisa de uma Fabric capacity. É exigida uma capacidade do Fabric para usar todos os itens do Fabric com suporte. Caso não tenha uma ainda, inscreva-se para uma avaliação gratuita. Clientes que já têm uma capacidade do Power BI Premium podem usá-la, mas saiba que determinadas SKUs do Power BI dão suporte apenas itens do Power BI.

Além disso, as seguintes alternâncias de locatário devem ser habilitadas no portal de administração:

• Os usuários podem criar itens do Fabric – necessário quando se utiliza artefatos do Fabric
• Os usuários podem sincronizar itens do espaço de trabalho com seus repositórios do Git
• Crie espaços de trabalho (somente se você quiser mudar para um novo espaço de trabalho.)
• Usuários podem sincronizar itens de workspace com repositórios do GitHub: somente para usuários do GitHub

Essas opções podem ser habilitadas pelo administrador de locatários, pelo administrador de capacidade ou pelo administrador do espaço de trabalho, dependendo das configurações da organização.

Pré-requisitos do Git

Atualmente, há suporte para a integração do Git para Azure DevOps e GitHub. Para usar a integração do Git ao workspace do Fabric, você precisa do seguinte em Azure DevOps ou GitHub:

Azure DevOps

• Uma conta ativa do Azure DevOps registrada no usuário do Fabric (com suporte, mesmo que a organização do Azure DevOps resida em um tenant diferente do tenant do Fabric). Criar uma conta gratuita.
• Access para um repositório existente.

GitHub

• Uma conta de GitHub ativa. Criar uma conta GitHub.

• Um dos seguintes tokens de acesso pessoais :

  • Um token fine-grained (recomendado) com permissões de leitura e gravação de Contents, sob as permissões do repositório:

    

    Para usar esse token com o GitHub Enterprise, siga estas instruções.

  • Crie um token clássico do GitHub com permissões de repositório habilitadas:

    

Conectar o espaço de trabalho ao repositório do Git

Conectar-se a um repositório Git

Somente um administrador do espaço de trabalho pode conectar um espaço de trabalho a um repositório, 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 workspace a um repositório Azure ou GitHub, siga estas etapas:

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

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

   

3. Selecionar Integração do Git.

4. Selecione seu provedor Git. Atualmente, há suporte para Azure DevOps e GitHub.

Azure DevOps Connect

Se você selecionar Azure DevOps, selecione Connect para entrar automaticamente na conta de Azure Repos registrada no usuário do Microsoft Entra conectado ao Fabric.

Se você já tiver entrado no Azure do Fabric usando uma conta diferente, selecione sua conta na lista e selecione Connect.

Se for a primeira vez que você entra no Fabric ou deseja adicionar uma nova conta, selecione Adicionar conta.

Se for a primeira vez que se conectar, você precisará autorizar seu usuário. Insira as seguintes informações:

• Nome de exibição – deve ser exclusivo para cada usuário
• URL do Azure DevOps - URL do repositório do Azure DevOps. A URL deve estar no formato https://dev.azure.com/{organization}/{project}/_git/{repository} ou https://{organization}.visualstudio.com/{project}/_git/{repo}.
• Autenticação – você pode autenticar com OAuth2 ou um Principal de Serviço. Para obter mais informações, consulte Azure DevOps – Integração do Git com a entidade de serviço

Depois de entrar, selecione Connect para permitir que Fabric acesse sua conta

GitHub Connect

Se você selecionar GitHub, precisará entrar em sua conta GitHub. Se você já entrou no GitHub, selecione sua conta na lista e selecione Connect.

Se for a primeira vez que você entra no Fabric ou deseja adicionar uma nova conta, selecione Adicionar conta.

Se for a primeira vez que se conectar, você precisará autorizar o seu usuário do GitHub. Insira as seguintes informações:

• Display name - deve ser exclusivo para cada usuário GitHub
• Token de acesso pessoal - seu token de acesso pessoal clássico ou granular
• Repository URL (opcional para github.com, obrigatório para ghe.com) – se você não inserir uma URL, poderá se conectar a qualquer repositório github.com ao qual tem acesso. Se você inserir uma URL, só poderá se conectar a esse repositório.

Depois de entrar, selecione Connect para permitir que Fabric acesse sua conta do GitHub.

Conectar-se a um espaço de trabalho

Se o workspace já estiver conectado ao Azure DevOps/GitHub, siga as instruções para Conectar a um workspace compartilhado.

Conectar ramo do Azure DevOps

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

   • Organization
   • Project
   • Repositório 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 (Digite o nome de uma pasta existente ou insira um nome para criar uma nova pasta. Se você deixar o nome da pasta em branco, o conteúdo será criado na pasta raiz. Você só pode se conectar a uma pasta de cada vez.)

Conexão de branch do GitHub

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

   • URL do repositório. Se você se conectou a GitHub usando um token com escopo, a URL será preenchida automaticamente e você só poderá se conectar a esse repositório.
   • 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 (Digite o nome de uma pasta existente ou insira um nome para criar uma nova pasta. Se você deixar o nome da pasta em branco, o conteúdo será criado na pasta raiz. Você só pode se conectar a uma pasta de cada vez.)

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 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 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 commits.

Fazer commit no Git

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

1. Vá para o espaço de trabalho.

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

3. Selecione Alterações no painel Controle do código-fonte. Uma lista é exibida com todos os itens que você alterou e um ícone que indica se o item é novo , modificado , conflito , mesma alteração 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 de fazer commit de todas as alterações, os itens com commit serão removidos da lista e o espaço de trabalho apontará para um novo commit com o 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.

Realizar commit para o branch autônomo

Confirmar o branch autônomo é um recurso de integração do Git que permite que você crie um branch novo e confirme as alterações atuais nele em uma única ação. Em outras palavras, em vez de se comprometer com o branch vinculado, você pode criar uma ramificação em tempo real: o sistema criará um novo Branch Git e salvará seu trabalho lá, sem precisar sair ou mudar do branch original.

1. Vá para o espaço de trabalho.
2. Selecione o ícone Controle do código-fonte. Esse ícone mostra o número de alterações não confirmadas.
3. Selecione Alterações no painel Controle do código-fonte. Uma lista é exibida com todos os itens que você alterou e um ícone que indica se o item é novo , modificado , conflito , mesma alteração 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 para novo branch.

Importante

Esteja ciente do seguinte:

• o branch recém-criado não será conectado ao espaço de trabalho existente.
• O branch recém-criado será baseado no último estado de sincronização do workspace atual.
• essa funcionalidade é possível quando há atualizações de entrada, mesmo se a confirmação padrão estiver desabilitada.
• ** O estado atual do workspace não será alterado devido a este commit e permanecerá como está.

Desfazer a alteração salva

Depois de salvar alterações no workspace, 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 suas alterações, siga estas etapas:

1. Vá para o espaço de trabalho.

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 Alterações no 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. Marque a caixa Entendo que os itens do espaço de trabalho podem ser excluídos e não podem ser restaurados e selecione Desfazer.

   

6. Selecione Desfazer novamente para confirmar. A caixa de diálogo que você vê pode variar dependendo se itens que serão excluídos ou não são detectados. A primeira captura de tela não mostra nenhuma exclusão. O segundo, caso sejam detectadas exclusões.

   

   

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 desfazer as alterações, o item será criado novamente como novo, e parte dos metadados pode ser perdida. 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.

Desfazer itens adicionados excluirá permanentemente o item.

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 transferir as últimas alterações, mesclas ou reversões no espaço de trabalho e atualizar os itens ativos. As alterações nas pastas também são atualizadas. Leia mais sobre as atualizações.

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

1. Vá para o espaço de trabalho.
2. Selecione o ícone Controle do código-fonte.
3. Selecione Updates no control panel de origem. É exibida uma lista com todos os itens alterados na ramificação desde a última atualização.
4. Selecione Atualizar tudo.

5. Na caixa de diálogo de confirmação, selecione Atualizar.

Depois que ele é atualizado com êxito, a lista de itens é removida e o espaço de trabalho passa a apontar para o novo espaço de trabalho ao qual está 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 de espaço de trabalho pode desconectar um espaço de trabalho de um Repositório do Git. 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 executar em um espaço de trabalho dependem das permissões que você tem no espaço de trabalho e no repositório do Git. Para uma discussão mais detalhada sobre permissões, confira Permissões.

Conteúdo relacionado

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