Introdução à integração do Git

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.

Pré-requisitos

Para integrar o Git ao seu espaço de trabalho do Microsoft Fabric, você precisará configurar os pré-requisitos a seguir no Fabric e no Git.

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. Caso não tenha uma ainda, inscreva-se para uma avaliação gratuita.

Além disso, as seguintes opções de locatário devem ser habilitadas no portal do administrador:

• Usuários podem criar itens do Fabric
• Os usuários podem sincronizar itens do espaço de trabalho com seus repositórios do Git
• Apenas para usuários do GitHub: eles podem sincronizar itens do espaço de trabalho com seus repositó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, a integração do Git é compatível com o Azure DevOps e o GitHub. Para usar a integração do Git com seu espaço de trabalho do Fabric, você precisa do seguinte no Azure DevOps ou no GitHub:

Limitações 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.

Limitações do GitHub

• Uma conta do GitHub ativa. Crie uma conta do GitHub.

• Um dos seguintes tokens de acesso pessoal:

  • Um token refinado (recomendado) com permissão de leitura e gravação de conteúdo nas permissões do repositório:

    

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

  • Criar um token clássico do GitHub com escopos de repositório habilitado:

    

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 espaço de trabalho a um repositório do Azure ou do 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, o Azure DevOps e o GitHub são compatíveis.

Conexão do Azure DevOps

Se você selecionar Azure DevOps, selecione Conectar para automaticamente entrar na conta do Azure Repos registrada do usuário do Microsoft Entra que entrou no Fabric.

Conexão do GitHub

Se você selecionar GitHub, precisará entrar na sua conta do GitHub.
Selecione Adicionar conta se esta for a primeira vez que você iniciou uma sessão no Fabric, ou selecione uma das contas listadas. Depois de entrar, selecione Conectar para permitir que o Fabric acesse sua conta do GitHub.

Se esta for a primeira vez que está se conectando, você precisará Autorizar seu usuário do GitHub. Insira as seguintes informações:

• Nome de exibição: deve ser exclusivo para cada usuário do GitHub
• Token de acesso pessoal - seu token de acesso pessoal clássico ou refinado
• URL do repositório (opcional): se você não inserir uma URL, poderá se conectar a qualquer repositório ao qual tenha acesso. Se você inserir uma URL, só poderá se conectar a esse repositório.

Conectar-se a um workspace

Se o espaço de trabalho já estiver conectado ao GitHub, siga as instruções para Conectar-se a um espaço de trabalho compartilhado.

Conexão de ramificação do Azure DevOps

1. 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 (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. Só é possível se conectar a uma pasta por vez.)

Conexão de ramificação do GitHub

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

   • URL do repositório. Se você se conectou ao 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. Só é possível se conectar a uma pasta por 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 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 Alterações no 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 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. 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 transferir as últimas alterações, mesclas 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 Atualizações no 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 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.

Considerações e limitações

Limitações gerais da integração do Git

• O método de autenticação no Fabric deve ser pelo menos tão forte quanto o método de autenticação do Git. Por exemplo, se o Git exigir autenticação multifator, o Fabric também precisará exigir autenticação multifator.
• No momento, não há suporte para os conjuntos de dados do Power BI conectados ao Analysis Services.
• Espaços de trabalho com aplicativos de modelo instalados não podem ser conectados ao Git.
• Nuvens soberanas não são compatíveis.

Limitações do Azure DevOps

• A conta do Azure DevOps deve ser registrada para o mesmo usuário que está utilizando o workspace do Fabric.
• O administrador de locatários deverá habilitar exportações entre áreas geográficas se o espaço de trabalho e o repositório do Git estiverem em duas regiões geográficas diferentes.
• Se a sua organização configurar o acesso condicional, certifique-se de que o Serviço do Power BI tenha as mesmas condições definidas para que a autenticação funcione conforme o esperado.
• O tamanho do commit é limitado a 125 MB.

Limitações do GitHub

• O GitHub não pode impor validações entre áreas geográficas.
• O tamanho total agregado dos arquivos a serem confirmados ao mesmo tempo é limitado a 50 MB. Portanto, se você tiver vários itens para fazer commit, às vezes pode ser necessário separá-los em alguns commits separados. Para obter mais informações sobre como fazer commit de arquivos, confira nosso guia de solução de problemas.

Limitações do GitHub Enterprise

Algumas configurações do GitHub Enterprise não são compatíveis. Por exemplo:

• Lista de IPs permitidos
• Rede privada
• Domínios personalizados

Limitações do workspace

• Somente o administrador do espaço de trabalho pode gerenciar as conexões com o repositório do Git, como conectar, desconectar ou adicionar uma ramificação.
  Uma vez conectado, qualquer pessoa com permissão pode trabalhar no workspace.
• A estrutura de pastas do espaço de trabalho não é refletida no repositório do Git. Os itens de espaço de trabalho em pastas são exportados para o diretório raiz.

Limitações de branch e pasta

• O nome do branch pode ter no máximo 244 caracteres.
• O caminho completo de nomes de arquivo pode ter no máximo 250 caracteres. Os nomes mais longos falham.
• O arquivo pode ter no máximo 25 MB.
• Você não pode baixar um relatório/conjunto de dados como .pbix do serviço depois de implantá-los com a Integração do Git.
• A pasta do Git usará a ID lógica (Guid) como um prefixo antes do tipo se o nome de exibição do item:
  • Tiver mais de 256 caracteres
  • Terminar com . ou um espaço
  • Contiver qualquer um dos seguintes caracteres: " / : < > \ * ? |

Limitações de ramificação

• A ramificação requer permissões listadas na tabela de permissões.
• É necessário haver uma capacidade disponível para essa ação.
• Todas as limitações de nomenclatura de espaço de trabalho e de branch se aplicam ao fazer a ramificação para um novo espaço de trabalho.
• Ao fazer a ramificação, um novo espaço de trabalho é criado e as configurações do espaço de trabalho original não são copiadas. Ajuste quaisquer configurações ou definições para garantir que o novo espaço de trabalho atenda às políticas da sua organização.
• Somente os itens com suporte do Git estão disponíveis no novo espaço de trabalho.
• A lista de branches relacionados mostra apenas branches e espaços de trabalho que você tem permissão para exibir.
• A integração do Git deve estar habilitada.

Limitações de sincronização e confirmação

• Você só pode sincronizar em uma direção por vez. Você não pode confirmar e atualizar ao mesmo tempo.
• Não há suporte para rótulos de confidencialidade e a exportação de itens com rótulos de confidencialidade pode estar desabilitada. Para confirmar itens que têm rótulos de confidencialidade sem o rótulo de confidencialidade, peça ajuda ao administrador.
• Funciona com itens limitados. Itens não compatíveis na pasta serão ignorados.
• Nomes duplicados não são permitidos. Mesmo se o Power BI permitir a duplicação de nomes, a ação de atualizar, fazer commit ou desfazer falhará.
• Não há suporte para B2B.
• A resolução de conflitos é realizada parcialmente no Git.
• Durante o processo de Confirmar para o Git, o serviço do 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.
• Atualizar um modelo semântico usando a API de atualização aprimorada resulta em uma comparação do Git após cada atualização.

Conteúdo relacionado

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