Conceitos básicos na integração do Git

Este artigo explica os conceitos básicos do Git e o processo de integração do Git ao workspace do Microsoft Fabric.

Importante

Esse recurso está em versão prévia.

Permissões

• Para usar a integração do Git, ela precisa ser habilitada pelo administrador da sua organização.
• Se o espaço de trabalho e o repositório estiverem em duas regiões diferentes, a exportação entre áreas geográficas deve ser habilitada pelo administrador do locatário. Para obter mais informações, consulte Usuários podem exportar itens para repositórios Git em outras localizações geográficas.
• As ações que você pode executar em um workspace dependem das permissões que você tem no workspace e no Azure DevOps.

Permissões do Azure DevOps

A lista a seguir mostra o que diferentes funções de workspace podem fazer dependendo das permissões do Azure DevOps:

• Administrador: pode executar qualquer operação no workspace, limitada apenas pela função do Azure DevOps.
• Membro/Colaborador: uma vez conectado a um workspace, um membro/colaborador pode confirmar e atualizar alterações, dependendo da função do Azure DevOps. Para ações relacionadas à conexão de workspace (por exemplo, conectar, desconectar ou alternar branches) procure ajuda de um Administrador.
• Visualizador: não é possível executar nenhuma ação. O visualizador não pode ver nenhuma informação relacionada ao Git no workspace.

Permissões necessárias para operações comuns

A tabela a seguir descreve as permissões necessárias para executar várias operações comuns:

Operação	Função do espaço de trabalho	permissões do Git
Conectar o workspace ao repositório do Git	Admin	Read=Allow
Sincronizar workspace com o repositório do Git	Admin	Read=Allow
Desconectar workspace do repositório do Git	Admin	Nenhuma permissão é necessária
Alternar branch no workspace (ou qualquer alteração na configuração de conexão)	Admin	Read=Allow (no repositório/diretório/branch de destino)
Ver detalhes de conexão do Git	Administrador, Membro, Colaborador	Leitura ou Nenhum
Ver o workspace “status do Git”	Administrador, Membro, Colaborador	Read=Allow
Atualizar a partir do Git	Todos os seguintes: Colaborador no workspace (permissão WRITE em todos os itens) Proprietário do item (se o comutador de locatário bloquear atualizações para não proprietários) BUILD em dependências externas (quando aplicável)	Read=Allow
Confirmar alterações no workspace para o Git	Todos os seguintes: Colaborador no workspace (permissão WRITE em todos os itens) Proprietário do item (se o comutador de locatário bloquear atualizações para não proprietários) BUILD em dependências externas (quando aplicável)	Read=Allow Contribute=Allow A política de branch deve permitir a confirmação direta
Criar um novo branch do Git de dentro do Fabric	Admin	Role=Write Create branch=Allow

Conectar e sincronizar

Somente um administrador do workspace pode conectar um workspace a um Azure Repos, mas, uma vez conectado, qualquer pessoa com permissões pode trabalhar no workspace. Se você não for um administrador, peça ajuda ao seu administrador para fazer a conexão.

Quando você conecta um workspace ao Git, o Fabric sincroniza entre os dois locais para que eles tenham o mesmo conteúdo. Durante a sincronização inicial, se o workspace ou o branch do Git estiver vazio enquanto o outro tiver conteúdo, o conteúdo será copiado do local não vazio para o vazio. Se tanto o workspace quanto o branch do Git tiverem conteúdo, você deverá decidir qual direção a sincronização deve seguir.

• Se você confirmar seu workspace para o branch do Git, todo o conteúdo do workspace com suporte será exportado para o Git e substituirá o conteúdo do Git atual.
• Se você atualizar o workspace com o conteúdo do Git, o conteúdo do workspace será substituído e você perderá o conteúdo do workspace. Como uma ramificação do Git sempre pode ser restaurada para um estágio anterior, enquanto um espaço de trabalho não pode, se você escolher esta opção, você deverá confirmar.

Se você não selecionar qual conteúdo sincronizar, não poderá continuar trabalhando que o faça:

Status do Git

Depois de se conectar, o workspace exibe uma coluna Status do Git que indica o estado de sincronização de cada item no workspace em relação aos itens no branch remoto.

Cada item tem um dos seguintes status:

• Sincronizado (o item é o mesmo no workspace e no branch do Git)
• Conflito (o item foi alterado no workspace e no branch do Git)
• Item sem suporte
• Alterações não confirmadas no workspace
• Atualização necessária do Git
• O item é idêntico em ambos os locais, mas precisa ser atualizado para a última confirmação

Informação de sincronização

Enquanto você estiver conectado, as seguintes informações serão exibidas na parte inferior da tela:

• Branch conectado
• Hora da última sincronização
• Link para a última confirmação com a qual o workspace está sincronizado

Confirmações e atualizações

Painel de controle do código-fonte

Na parte superior da tela está o ícone Controle do código-fonte. Ele mostra o número de itens diferentes no workspace e no branch do Git. Quando o workspace é sincronizado com o branch do Git, o ícone Controle do código-fonte exibe um 0.

Quando são feitas alterações no workspace ou no branch do Git, o ícone de controle do código-fonte mostra o número de itens diferentes. Selecione o ícone de controle do código-fonte para abrir o painel de Controle do código-fonte.

No painel Controle do código-fonte, a guia Alterações mostra o número de itens que foram alterados no workspace e que precisam ser confirmados no Git; a guia Atualizações mostra o número de itens que foram modificados no branch do Git e precisam ser atualizados para o workspace.

Em cada guia, os itens alterados são listados com um ícone que indica o status:

• novo
• modificado
• excluído
• conflito

Confirmar

• Quando houver mais de um item a ser confirmado, você poderá selecionar quais itens confirmar no branch do Git.
• Se houver atualizações feitas no branch do Git, as confirmações serão desabilitadas até que você atualize o workspace.

Atualizar

• Ao contrário de confirmação e desfazer, o comando Atualizar sempre atualiza todo o branch e sincroniza com a confirmação mais recente. Você não pode selecionar itens específicos para atualizar.
• Se forem feitas alterações no workspace e no branch do Git no mesmo item, as atualizações serão desabilitadas até que o conflito seja resolvido.

Leia mais sobre como confirmar e atualizar. Leia mais sobre o processo de atualização e como resolver conflitos.

Considerações e limitações

Limitações gerais

• A conta do Azure DevOps deve ser registrada para o mesmo usuário que está utilizando o workspace do Fabric.
• O método de autenticação no Power BI deve ser pelo menos tão forte quanto o método de autenticação do Azure DevOps. Por exemplo, se o Azure DevOps exigir autenticação multifator, o Power BI também precisará exigir autenticação multifator.
• A consulta direta e os modelos compostos em conjuntos de dados e serviços de análise do Power BI não estão sendo suportados no momento.
• Não há suporte para modelos semânticos DirectLake no momento.
• Atualizar um modelo semântico usando a API de atualização aprimorada resulta em uma comparação do Git após cada atualização.

Limitações do workspace

Somente o administrador do workspace pode gerenciar as conexões com o Azure Repos, como conectar, desconectar ou adicionar um branch. Uma vez conectado, qualquer pessoa com permissão pode trabalhar no workspace.

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.

• Se o nome de exibição do item:

  • Tiver mais de 256 caracteres
  • Termina com .' ou um espaço
  • Contém qualquer um dos seguintes caracteres: ", /, :, <, >, \\, *, ?, |

  A ID lógica (Guid) é adicionada como um prefixo antes do tipo, ao nomear a pasta no Git.

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

• O limite de tamanho de uma confirmação é de 125 MB.
• 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. Se itens sem suporte estiverem na pasta, eles serão ignorados.
• Nomes duplicados não são permitidos – mesmo se o Power BI permitir, a ação atualizar, confirmar ou desfazer falhará.
• Não há suporte para B2B.
• A resolução de conflitos é realizada parcialmente no Git.

Conteúdo relacionado

• Gerenciar branches
• Resolução de erros e conflitos