Partilhar via

O que é a integração do Microsoft Fabric Git?

Este artigo explica aos desenvolvedores como integrar o controle de versão do Git com a ferramenta Microsoft Fabric Application lifecycle management (ALM).

Nota

Alguns dos itens para integração com o Git estão em pré-visualização. Para obter mais informações, consulte a lista de itens suportados.

A integração do Git no Microsoft Fabric permite que os desenvolvedores integrem seus processos de desenvolvimento, ferramentas e práticas recomendadas diretamente na plataforma Fabric. Ele permite que os desenvolvedores que estão desenvolvendo no Fabric:

  • Fazer backup e versionar o seu trabalho
  • Reverter para estágios anteriores conforme necessário
  • Colabore com outras pessoas ou trabalhe sozinho usando ramificações do Git
  • Aplique os recursos das ferramentas familiares de controle do código-fonte para gerenciar itens do Fabric

A integração com o controle do código-fonte está em um nível de espaço de trabalho. Os desenvolvedores podem fazer versões de itens que desenvolvem em um espaço de trabalho em um único processo, com visibilidade total de todos os seus itens. A estrutura do espaço de trabalho, incluindo subpastas, é preservada no repositório Git.

Consulte a lista de itens suportados.

Informações de privacidade

Antes de ativar a integração com o Git, leia as seguintes declarações de privacidade:

Provedores Git suportados

Os seguintes provedores Git são suportados:

Itens suportados

Os seguintes itens atualmente suportam a integração do Git:

Se o espaço de trabalho ou o diretório Git tiver itens sem suporte, ele ainda poderá ser conectado, mas os itens não suportados serão ignorados. Eles não são salvos ou sincronizados, mas também não são excluídos. Eles aparecem no painel de controle do código-fonte, mas você não pode confirmá-los ou atualizá-los.

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.
  • Se você usar uma identidade de espaço de trabalho em um artefato e confirmá-la no Git, ela poderá ser atualizada (de volta a um espaço de trabalho de malha) somente em um espaço de trabalho conectado à mesma identidade. Tenha cuidado, pois isso também afeta recursos como ramificação.
  • Não há suporte para submódulos.
  • Nuvens soberanas não são suportadas.

Limitações do GitHub Enterprise

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

  • GitHub Enterprise Cloud com residência de dados (ghe.com)
  • Não há suporte para o GitHub Enterprise Server com um domínio personalizado, mesmo que a instância esteja acessível publicamente
  • Github Enterprise Server hospedado em uma rede privada
  • Lista de IPs permitidos

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.
  • Os espaços de trabalho com aplicativos de modelo instalados não podem ser conectados ao Git.
  • MyWorkspace não consegue se conectar a um provedor Git.

Limitações de branches 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 mais longos não funcionam.
  • O tamanho máximo do ficheiro é de 25 MB.
  • A estrutura de pastas é mantida até uma profundidade de 10 níveis.
  • Não é recomendável baixar um relatório/conjunto de dados como .pbix do serviço depois de implantá-los com a integração do Git, pois os resultados não são confiáveis. Recomendamos usar o PowerBI Desktop para baixar relatórios/conjuntos de dados como .pbix.
  • 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 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 se aplicam quando se ramifica para 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 expandir 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 de modelo predefinido.
  • 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 confirme quaisquer itens que deseja manter antes de 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 processar itens com rótulos de sensibilidade sem usar 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, as ações de atualização, confirmação ou desfazer falharão.
  • B2B não é suportado.
  • A resolução de conflitos é parcialmente feita no Git.
  • Durante o processo Commit para o Git, o serviço Fabric exclui arquivos dentro da pasta do item que não fazem parte da definição de item. Arquivos não relacionados que não estão em uma pasta de item não são excluídos.
  • Depois de confirmares as alterações, podes notar algumas mudanças inesperadas no item que não fizeste. 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 utiliza quebras de linha CRLF. O serviço usa LF (line feed) para quebras de linha. Se tinha arquivos no repositório Git com quebras de linha CRLF, quando faz a confirmação 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 gera um diff do Git após cada atualização.

Conteúdos relacionados