Como usar a integração do Git para desenvolvimento e implementação de armazém

Aplica-se a: ✅ Armazém no Microsoft Fabric

Este artigo descreve como trabalhar com integração Fabric Git e Fabric Data Warehouse.

Importante

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

Cobre fluxos de trabalho comuns de desenvolvimento, incluindo criação de branches, atualização de repositórios Git, sincronização de alterações de volta ao espaço de trabalho do Fabric e commiting de alterações do warehouse no Git. Estes fluxos de trabalho ajudam a permitir controlo de versões, colaboração e implementação controlada das alterações de esquemas do armazém.

Fluxo de trabalho Git para Fabric Data Warehouse

Na página de definições do Workspace , pode facilmente configurar uma ligação ao seu fornecedor git. Para configurar a conexão, consulte Introdução à integração com o Git. Siga as instruções para Ligar a um repositório Git para Azure DevOps ou GitHub como fornecedor Git.

Criar ou fazer checkout/trocar de sucursal

Podes gerir branches Git para o teu espaço de trabalho Fabric Data Warehouse. Podes criar um novo ramo, alternar entre ramos ou expandir para um espaço de trabalho separado.

Captura de ecrã do portal Fabric da janela Current Branch e da lista suspensa.

  • Verifique a nova agência: Crie um novo ramo para este trabalho. Trabalha sempre numa nova secção em funcionamento, não main. Para ligar o espaço de trabalho atual a uma nova ramificação, mantendo o estado do espaço de trabalho existente, selecione Mudar para nova ramificação.

  • Expanda-te para outro espaço de trabalho: Para mais informações sobre como criar ou anexar espaços de trabalho a ramos, consulte Desenvolver usando outro espaço de trabalho.

  • Alternar entre ramos existentes: Quando mudas de ramo, o espaço de trabalho sincroniza-se com o novo ramo e todos os itens no espaço de trabalho são sobrepostos. Para mais informações, consulte Switch Branches.

Quando ramifica fluxos de trabalho, cada armazém analisa as suas dependências com outros armazéns para determinar a sequência da sincronização dos itens e garantir que os fluxos de trabalho ramificados funcionam como esperado.

Saiba mais sobre como fazer check-out de uma nova ramificação em Resolver conflitos no Git.

Desenvolva localmente utilizando um projeto de base de dados

Pode realizar desenvolvimento local trabalhando com o projeto de base de dados do armazém a partir do seu repositório Git. Pode até desenvolver contra o projeto de base de dados do armazém offline.

  1. Clone o repositório Git que contém o projeto de base de dados do armazém.
  2. Abra o projeto de base de dados localmente, por exemplo, no Visual Studio Code com a extensão do projeto de base de dados SQL.
  3. Faça atualizações de esquema ou alterações de scripts diretamente no projeto da base de dados.
  4. Valide as alterações localmente construindo o projeto da base de dados para eventuais erros.
  5. Quando o desenvolvimento estiver concluído, faça commit e envie as suas alterações para o branch Git remoto. Uma vez implementadas, as definições atualizadas do projeto podem ser sincronizadas de volta ao espaço de trabalho do Fabric através dos fluxos de trabalho de integração do Git.

Sincronizar alterações do Git de volta para o espaço de trabalho

Após concluir o desenvolvimento numa funcionalidade ou ramo de trabalho (não em main), pode sincronizar as definições atualizadas dos projetos de base de dados do Git para o espaço de trabalho do Fabric, de modo a que o armazém reflita as alterações aprovadas mais recentes.

  1. Se criou um branch de feature anteriormente (por exemplo, durante a criação ou checkout do branch), crie primeiro um pull request para rever e fundir as suas alterações no branch de destino. Um pull request é simplesmente um pedido para fundir alterações de um ramo para outro.

  2. Depois de o pull request ser fundido no Git, vá ao Controlo de Fonte no espaço de trabalho do Fabric.

  3. Atualize ou sincronize o espaço de trabalho a partir do repositório Git para aplicar as alterações mais recentes ao armazém.

    Captura de ecrã do portal Fabric a mostrar o botão Atualizar tudo na janela de controlo de versões e uma alteração pendente à espera de ser aplicada ao armazém.

  4. Se ocorrerem conflitos durante a sincronização das alterações entre o Git e o espaço de trabalho do Fabric, siga as orientações de resolução de conflitos e resolva conflitos.

Faça alterações e faça commit das atualizações do warehouse para o Git

Se precisares de fazer alterações diretamente ao armazém ao vivo, ainda podes atualizar o controlo de versão a partir da definição do armazém ativo.

Tip

Para gerir alterações de esquema num formato estruturado e controlado por versões, trabalhe com ficheiros de esquema de armazém em projetos de bases de dados. Pode planear alterações de esquema no armazém, conforme descrito em Develop localmente, usando um projeto de base de dados, em vez de fazer alterações incrementais diretamente para o estado do armazém ativo, como descrito nesta secção.

Para rever e confirmar as suas alterações num repositório Git:

  1. Para criar ou modificar objetos de armazém, execute instruções T-SQL no editor de consultas SQL do portal Fabric, SQL Server Management Studio (SSMS),extensão MSSQL para Visual Studio Code ou outras ferramentas de consulta. Estas alterações atualizam o esquema do armazém ativo.

  2. Vai ao Controlo de Versão no espaço de trabalho do Fabric.

  3. O armazém modificado aparece como um item de alteração pendente na lista de alterações.

  4. Durante fluxos de trabalho de ramificação ou sincronização workspace-para-Git, o sistema realiza extração de esquemas utilizando extração incremental baseada em DacFx. A extração de esquemas capta apenas alterações relevantes do esquema. Analise as alterações detetadas:

    • Compare a definição do artigo do armazém com a versão atual da agência.
    • Valide diferenças de esquema para itens individuais ou múltiplos itens.
  5. Seleciona os itens do armazém que queres comprometer.

  6. Adicione uma mensagem de commit e faça commit das alterações no repositório Git.

    Captura de ecrã do menu de controlo de versões no portal Fabric, mostrando o diálogo de commit e a mensagem opcional de commit.

  7. Após o compromisso:

    • Vai ao repositório Git.
    • Verifique as alterações através do histórico de commits e do item atualizado do projeto da base de dados.

    Por exemplo, um commit que removeu a Address coluna de dbo.Customers:

    Captura de ecrã do portal Fabric a mostrar a diferença entre os dois commits.