Partilhar via


Introdução à integração com o Git

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

Recomendamos ler a 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ê precisa configurar os seguintes pré-requisitos para o Fabric e o Git.

Pré-requisitos do tecido

Para aceder ao recurso de integração do Git, precisa de uma capacidade do Fabric. Uma capacidade de malha é necessária para usar todos os itens de malha suportados. Se você ainda não tem uma, inscreva-se para uma avaliação gratuita. Os clientes que já têm uma capacidade Power BI Premium, podem usar essa capacidade, mas lembre-se de que determinadas SKUs do Power BI oferecem suporte apenas a itens do Power BI.

Além disso, as seguintes opções de locatário devem ser habilitadas no Portal de administração:

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

Pré-requisitos do Git

Atualmente, a integração do Git é suportada para 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:

  • Uma conta ativa do Azure registada para o mesmo utilizador que está a usar o espaço de trabalho Fabric. Crie uma conta gratuita.
  • Acesso a um repositório existente.

Conectar um espaço de trabalho a um repositório Git

Conectar-se a um repositório Git

Somente um administrador de 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 administrador para se conectar. Para conectar um espaço de trabalho a um Azure ou GitHub Repo, siga estas etapas:

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

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

    Captura de ecrã da área de trabalho com o ícone de definições da área de trabalho apresentado na parte superior.

  3. Selecione Integração Git.

  4. Selecione seu provedor Git. Atualmente, o Azure DevOps e o GitHub são suportados.

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

Captura de tela da janela de configurações do espaço de trabalho com a integração do Git selecionada.

Conectar-se a um espaço de trabalho

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

  1. No menu suspenso, especifique os seguintes detalhes sobre a filial à qual deseja conectar-se:

    • 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 (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.)

Captura de tela para a conexão do Azure.

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.

Captura de tela do ícone de controle do código-fonte e outras informações do Git.

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.

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

  1. Ir para o espaço de trabalho.

  2. Selecione o ícone controlo de código. Este ícone mostra o número de alterações não confirmadas. Captura de tela do ícone de controle do código-fonte com o número 2 indicando que há duas alterações a serem confirmadas.

  3. Selecione as Alterações no controlo de origem. É 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 de seleção no topo.

  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.

    Captura de tela da janela de controle do código-fonte com duas alterações selecionadas para confirmação.

Depois de as alterações serem commitadas, os itens que foram commitados são removidos da lista, e o espaço de trabalho aponta para o novo commit com o qual foi sincronizado.

Captura de tela da janela de controle do código-fonte informando que não há alterações a serem confirmadas.

Depois que a confirmação for concluída com êxito, o status dos itens selecionados mudará 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 aparece no espaço de trabalho relevante. Use o painel de controlo de código-fonte para extrair as alterações, fusões ou reversões mais recentes para a área de trabalho e atualizar itens dinâmicos. As alterações nas pastas também são atualizadas. Leia mais sobre atualizar.

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

  1. Ir para o espaço de trabalho.
  2. Selecione o ícone controlo de código.
  3. Selecione Atualizações no painel de controle Origem . Uma lista é exibida com todos os itens que foram alterados na ramificação desde a última atualização.
  4. Selecione Atualizar tudo.

Captura de tela do painel de controle do código-fonte com a guia Atualizar aberta e o botão Atualizar tudo selecionado.

Depois de atualizar com êxito, a lista de itens é removida e o espaço de trabalho aponta para o novo espaço de trabalho com o qual está sincronizado.

Captura de tela da janela de controle do código-fonte informando que você atualizou com êxito o espaço de trabalho.

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 Git. 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 repositório Git. Para obter uma discussão mais detalhada sobre permissões, consulte Permissões.

Considerações e limitações

Limitações gerais de 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 para o Git. Por exemplo, se o Git exigir autenticação multifator, o Fabric também precisará exigir autenticação multifator.
  • Os conjuntos de dados do Power BI conectados ao Analysis Services não são suportados no momento.
  • Os espaços de trabalho com aplicativos de modelo instalados não podem ser conectados ao Git.
  • Não há suporte para submódulos.
  • Nuvens soberanas não são suportadas.
  • A conta do Azure DevOps deve ser registrada para o mesmo usuário que está usando o espaço de trabalho Fabric.
  • O Azure DevOps não é suportado se a validação da política Ativar Acesso Condicional de IP estiver ativada.
  • O administrador do locatário deve habilitar as exportações entre regiões geográficas se o espaço de trabalho e o repositório Git estiverem em duas regiões geográficas diferentes.
  • Se a sua organização configurou acesso condicional, certifique-se de que o Serviço Power BI tem 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 Enterprise

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

Limitações do espaço de trabalho

  • Somente o administrador do espaço de trabalho pode gerenciar as conexões com o repositório Git , como conectar, desconectar ou adicionar uma ramificação.
    Uma vez conectado, qualquer pessoa com permissão pode trabalhar no espaço de trabalho.

Limitações de ramificações e pastas

  • O comprimento máximo do nome da ramificação é de 244 caracteres.
  • O comprimento máximo do caminho completo para nomes de arquivo é de 250 caracteres. Nomes longos podem falhar.
  • O tamanho máximo do ficheiro é de 25 MB.
  • A estrutura de pastas é mantida até 10 níveis de profundidade.
  • Não é possível baixar um relatório/conjunto de dados como .pbix do serviço depois de implantá-los com a integração do Git.
  • Se o nome de exibição do item tiver alguma dessas características, a pasta Git será renomeada para a ID lógica (Guid) e digite:
  • Quando você conecta um espaço de trabalho que tem pastas ao Git, você precisa confirmar alterações no repositório Git se essa estrutura de pastas for diferente.

Limitações do nome do diretório

  • O nome do diretório que se conecta ao repositório Git tem as seguintes restrições de nomenclatura:

    • O nome do diretório não pode começar ou terminar com um espaço ou tab.
    • O nome do diretório não pode conter nenhum dos seguintes caracteres: "/:<>\*?|
  • A pasta do item (a pasta que contém os arquivos do item) não pode conter nenhum dos seguintes caracteres: ":<>\*?|. Se você renomear a pasta para algo que inclua um desses caracteres, o Git não poderá se conectar ou sincronizar com o espaço de trabalho e ocorrerá um erro.

Ramificando limitações

  • A ramificação requer permissões listadas na tabela de permissões.
  • Tem de haver uma capacidade disponível para esta ação.
  • Todas as limitações de nomenclatura de espaço de trabalho e de ramificação aplicam-se ao criar um novo espaço de trabalho.
  • Apenas os itens suportados pelo Git estão disponíveis no novo espaço de trabalho.
  • A lista de ramificações relacionadas mostra apenas ramificações e espaços de trabalho que você tem permissão para exibir.
  • A integração com o Git deve ser habilitada.
  • Ao ramificar, uma nova ramificação é criada e as configurações da ramificação original não são copiadas. Ajuste quaisquer configurações ou definições para garantir que o novo atenda às políticas da sua organização.
  • Ao ramificar para um espaço de trabalho existente:
    • O espaço de trabalho de destino deve suportar uma conexão Git.
    • O usuário deve ser um administrador do espaço de trabalho de destino.
    • O espaço de trabalho de destino deve ter capacidade.
    • O espaço de trabalho não pode ter aplicações modelo.
  • Observe que, ao se ramificar para um espaço de trabalho, quaisquer itens que não estejam guardados no Git podem se perder. Recomendamos que registe os itens que deseja manter antes de se ramificar.

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

  • Você só pode sincronizar em uma direção de cada vez. Não é possível confirmar e atualizar ao mesmo tempo.
  • Não há suporte para rótulos de sensibilidade e a exportação de itens com rótulos de sensibilidade pode ser desativada. Para submeter itens com rótulos de sensibilidade sem o rótulo de sensibilidade, peça ajuda ao administrador.
  • Funciona com itens limitados. Os itens não suportados na pasta são ignorados.
  • Não é permitida a duplicação de nomes. Mesmo que o Power BI permita a duplicação de nomes, a ação de atualização, confirmação ou desfazer falhará.
  • B2B não é suportado.
  • A resolução de conflitos é parcialmente feita no Git.
  • Durante o processo de Commit no Git, o serviço Fabric elimina ficheiros dentro da pasta do item que não fazem parte da definição do 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, poderá notar algumas alterações inesperadas no item que não efetuou. 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 ficheiro que usa quebras de linha CRLF. O serviço usa quebras de linha LF (line feed). 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 arquivo de projeto (.pbip) e carregue-o no Git usando CRLF.
  • A atualização de um modelo semântico usando a API de atualização aprimorada causa um diff do Git após cada atualização.