Conceitos básicos em integração Git

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

Importante

Este recurso está em pré-visualização.

Permissões

• Para usar a integração do Git, o administrador da sua organização deve habilitá-la pelo administrador da sua organização.
• Se o espaço de trabalho e o repositório estiverem em duas regiões diferentes, o administrador do locatário deverá habilitar a exportação geográfica cruzada.
• 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 Azure DevOps.

Permissões do Azure DevOps

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

• Admin: pode executar qualquer operação no espaço de trabalho, limitado apenas pela função DevOps do Azure.
• Membro/Colaborador: Depois de se conectar a um espaço de trabalho, um membro/colaborador pode confirmar e atualizar alterações, dependendo de sua função de DevOps do Azure. Para ações relacionadas à conexão do espaço de trabalho (por exemplo, conectar, desconectar ou alternar ramificações), 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 espaço de trabalho.

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 de espaço de trabalho	Permissões do Git
Conectar o espaço de trabalho ao repositório Git	Admin	Ler=Permitir
Espaço de trabalho de sincronização com repositório Git	Admin	Ler=Permitir
Desconectar o espaço de trabalho do repositório Git	Admin	Não são necessárias permissões
Alternar ramificação no espaço de trabalho (ou qualquer alteração na configuração de conexão)	Admin	Read=Allow (no destino repo/directory/branch)
Ver detalhes da conexão Git	Administrador, Membro, Colaborador	Ler ou Nenhum
Ver espaço de trabalho 'Estado do Git'	Administrador, Membro, Colaborador	Ler=Permitir
Atualização do Git	Todos os seguintes: Colaborador no espaço de trabalho (permissão WRITE em todos os itens) Proprietário do item (se a opção de locatário bloquear atualizações para não proprietários) CONSTRUIR sobre dependências externas (quando aplicável)	Ler=Permitir
Confirmar alterações do espaço de trabalho no Git	Todos os seguintes: Colaborador no espaço de trabalho (permissão WRITE em todos os itens) Proprietário do item (se a opção de locatário bloquear atualizações para não proprietários) CONSTRUIR sobre dependências externas (quando aplicável)	Ler=Permitir Contribute=Permitir A política de ramificação deve permitir a confirmação direta
Crie uma nova ramificação do Git a partir do Fabric	Admin	Função=Escrever Criar ramificação=Permitir

Ligar e sincronizar

Somente um administrador de espaço de trabalho pode conectar um espaço de trabalho aos repositórios do Azure, mas, uma vez conectado, qualquer pessoa com permissões pode trabalhar no espaço de trabalho. Se você não for um administrador, peça ajuda ao administrador para se conectar.

Quando você conecta um espaço de trabalho ao Git, o Fabric sincroniza entre os dois locais para que eles tenham o mesmo conteúdo. Durante essa sincronização inicial, se o espaço de trabalho ou a ramificação do Git estiver vazio enquanto o outro tiver conteúdo, 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ê terá que decidir em qual direção a sincronização deve seguir.

• Se você confirmar seu espaço de trabalho na ramificação do Git, todo o conteúdo do espaço de trabalho suportado será exportado para o Git e substituirá o conteúdo atual do Git.
• Se você atualizar o espaço de trabalho com o conteúdo do Git, o conteúdo do espaço de trabalho será substituído e você perderá o conteúdo do espaço de trabalho. 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 essa opção, será solicitado que você confirme.

Se não selecionar o conteúdo a sincronizar, não pode continuar a trabalhar até o fazer:

Status do Git

Depois de se conectar, o espaço de trabalho exibe uma coluna de status do Git que indica o estado de sincronização de cada item no espaço de trabalho em relação aos itens na ramificação remota.

Cada item tem um dos seguintes status:

• Sincronizado (o item é o mesmo no espaço de trabalho e na ramificação do Git)
• Conflito (o item foi alterado no espaço de trabalho e na ramificação do Git)
• Item não suportado
• Alterações não confirmadas no espaço de trabalho
• Atualização necessária do Git
• O item é idêntico em ambos os lugares, mas precisa ser atualizado até a última confirmação

Sincronizar informações

Enquanto estiver ligado, as seguintes informações aparecem na parte inferior do ecrã:

• Ramificação conectada
• Hora da última sincronização
• Link para a última confirmação com a qual o espaço de trabalho está sincronizado

Confirmações e atualizações

Painel de controle do código-fonte

Na parte superior da tela está o ícone de controle do código-fonte. Ele mostra o número de itens que são diferentes no espaço de trabalho e na ramificação do Git. Quando o espaço de trabalho é sincronizado com a ramificação do Git, o ícone de controle do código-fonte exibe um 0.

Quando são feitas alterações no espaço de trabalho ou na ramificação 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 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 espaço de trabalho e precisam ser confirmados no Git, e a guia Atualizações mostra o número de itens que foram modificados na ramificação do Git e precisam ser atualizados para o espaço de trabalho.

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

• Novo
• modificado
• Suprimido
• conflito

Consolidação

• Quando houver mais de um item para confirmar, você poderá selecionar quais itens confirmar na ramificação do Git.
• Se houver atualizações feitas na ramificação do Git, as confirmações serão desabilitadas até que você atualize seu espaço de trabalho.

Atualizar

• Ao contrário de confirmar e desfazer, o comando Atualizar sempre atualiza toda a ramificação e sincroniza com a confirmação mais recente. Não é possível selecionar itens específicos para atualizar.
• Se forem feitas alterações no espaço de trabalho e na ramificação do Git no mesmo item, as atualizações serão desativadas 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á usando o espaço de trabalho Fabric.
• O método de autenticação no Power BI deve ser pelo menos tão forte quanto o método de autenticação para o Azure DevOps. Por exemplo, se o Azure DevOps exigir autenticação multifator, o Power BI também precisará exigir autenticação multifator.
• Consulta direta e modelos compostos em conjuntos de dados do Power BI e Analysis Services não são suportados no momento.
• No momento, não há suporte para modelos semânticos do DirectLake.
• A atualização de um modelo semântico usando a API de atualização aprimorada causa uma comparação do Git após cada atualização.
• A estrutura de pastas do espaço de trabalho não é refletida no repositório Git. Os itens do espaço de trabalho nas pastas são exportados para o diretório raiz.

Limitações do espaço de trabalho

• Somente o administrador do espaço de trabalho pode gerenciar as conexões com o Azure Repo , 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 mais longos falham.

• O tamanho máximo do ficheiro é de 25 MB.

• 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:

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

  O ID lógico (Guid) é adicionado como um prefixo antes do tipo, ao nomear a pasta no Git.

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

• O limite de tamanho para uma confirmação é de 125 MB.
• 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 confirmar itens com rótulos de sensibilidade sem o rótulo de sensibilidade, peça ajuda ao administrador .
• Funciona com itens limitados. Se houver itens sem suporte na pasta, eles serão ignorados.
• A duplicação de nomes não é permitida – mesmo que o Power BI permita, a ação de atualização, confirmação ou desfazer falha.
• B2B não é suportado.
• A resolução de conflitos é parcialmente feita no Git.

Conteúdos relacionados

• Gerir ramos
• Resolver erros e conflitos