Controle do código-fonte (versão prévia)

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

Este artigo explica como os pipelines de integração e implantação do Git funcionam para warehouses no Microsoft Fabric. Saiba como configurar uma conexão com seu repositório, gerenciar seus warehouses e implantá-los em diferentes ambientes. Atualmente, o controle do código-fonte do Warehouse do Fabric é uma versão prévia do recurso.

É possível usar ambosPipelines de implantação e integração do Git para diferentes cenários:

• Use projetos de banco de dados do Git e SQL para gerenciar alterações incrementais, colaboração em equipe, histórico de confirmação em objetos de banco de dados individuais.
• Use pipelines de implantação para promover alterações de código em diferentes ambientes de pré-produção e produção.

Integração do Git

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

• Façam cópia de backup e controle de versão de seu trabalho
• Revertam para estágios anteriores, conforme necessário
• Colaborem com outras pessoas ou trabalhem sozinhos usando branches do Git
• Aplique os recursos de ferramentas familiares de controle do código-fonte para gerenciar itens do Fabric

Para obter mais informações sobre o processo de integração do Git, consulte:

• O que é a integração do Git do Microsoft Fabric?
• Conceitos básicos na integração do Git
• Introdução à integração do Git

Configurar uma conexão com o controle do código-fonte

Nas página Configurações do espaço de trabalho, você poderá configurar facilmente uma conexão com seu repositório a fim de confirmar e sincronizar alterações.

1. Para configurar a conexão, consulte Introdução à integração do Git. Siga as instruções para Conectar-se a um repositório do Git ao Azure DevOps ou ao GitHub como um provedor do Git.
2. Uma vez conectados, seus itens, incluindo warehouses, aparecem no painel de Controle do código-fonte.
3. Depois de conectar com êxito as instâncias do warehouse ao repositório do Git, você visualizará a estrutura de pastas do warehouse no repositório. Agora você poderá executar operações futuras, como criar uma solicitação de pull.

Projetos de banco de dados para um warehouse no Git

A imagem a seguir é um exemplo da estrutura de arquivos de cada item de warehouse no repositório:

Ao confirmar o item de warehouse para o repositório do Git, o warehouse é convertido em um formato de código-fonte, como um projeto de banco de dados SQL. Um projeto SQL é uma representação local de objetos SQL que compõem o esquema de um banco de dados individual, como tabelas, procedimentos armazenados ou funções. A estrutura de pastas dos objetos de banco de dados é organizada por Tipo de esquema/objeto. Cada objeto no warehouse é representado com um arquivo .sql que contém sua definição de DDL (linguagem de definição de dados). Os dados da tabela do warehouse e recursos de segurança do SQL não estão incluídos no projeto do banco de dados SQL.

As consultas compartilhadas também são confirmadas no repositório e herdam o nome em que são salvas.

Pipelines de implantação

Também é possível usar o pipeline de implantação para implantar o código do warehouse em diferentes ambientes, como desenvolvimento, teste e produção. Os pipelines de implantação não expõem um projeto de banco de dados.

Use as etapas a seguir para concluir a implantação do warehouse usando o pipeline de implantação.

1. Crie um pipeline de implantação ou abra um pipeline de implantação existente. Para obter mais informações, consulte Introdução aos pipelines de implantação.
2. Atribua workspaces a diferentes fases de acordo com suas metas de implantação.
3. Selecione, exiba e compare itens, incluindo warehouses entre diferentes fase, conforme mostrado no exemplo a seguir.
4. Selecione Implantar para implantar seus warehouses nas fases de Desenvolvimento, Teste e Produção.

Para mais informações sobre o processo dos pipelines de implantação do Fabric, consulte Introdução aos pipelines de implantação.

Limitações no controle do código-fonte

• Os recursos de segurança do SQL devem ser exportados/migrados usando uma abordagem baseada em script. Considere usar um script pós-implantação em um projeto de banco de dados SQL, que você pode configurar abrindo o projeto com a extensão projetos do Banco de Dados SQL disponível no Visual Studio Code.

Limitações na integração do Git

• Atualmente, caso use ALTER TABLE para adicionar uma restrição ou coluna no projeto de banco de dados, a tabela será descartada e criada novamente ao implantar, resultando em perda de dados. Considere a seguinte solução alternativa para preservar a definição e os dados da tabela:
  • Crie uma nova cópia da tabela no warehouse, usando CREATE TABLE e INSERT, CREATE TABLE AS SELECT ou Tabela de clones.
  • Modifique a nova definição de tabela com novas restrições ou colunas, conforme desejado, usando ALTER TABLE.
  • Exclua a tabela antiga.
  • Renomeie a nova tabela para o nome da tabela antiga usando sp_rename.
  • Modifique a definição da tabela antiga no projeto do banco de dados SQL exatamente da mesma maneira. O projeto do banco de dados SQL do warehouse no controle do código-fonte e do warehouse ao vivo agora deve corresponder.
• Atualmente, não crie um Fluxo de Dados Gen2 com um destino de saída para o warehouse. A confirmação e a atualização do Git seriam bloqueadas por um novo item chamado DataflowsStagingWarehouse que aparece no repositório.
• A integração Git do Fabric não oferece suporte ao ponto de extremidade de análise SQL.
• Dependências entre itens, sequenciamento de itens e lacunas de sincronização entre o ponto de extremidade de análise SQL e o armazém de dados afetam os fluxos de trabalho de "ramificação para um novo/existente workspace" e "trocando para uma ramificação diferente" durante o desenvolvimento e a integração contínua.

Limitações para pipelines de implantação

• Atualmente, caso use ALTER TABLE para adicionar uma restrição ou coluna no projeto de banco de dados, a tabela será descartada e criada novamente ao implantar, resultando em perda de dados.
• Atualmente, não crie um Fluxo de Dados Gen2 com um destino de saída para o warehouse. A implantação seria bloqueada por um novo item chamado DataflowsStagingWarehouse que aparece no pipeline de implantação.
• Os fluxos de implantação do Fabric não dão suporte ao elemento de ponto de extremidade de análise do SQL.
• Dependências cruzadas entre itens, sequenciamento de itens e lacunas de sincronização entre o ponto de extremidade de análises SQL e o armazém impactam os fluxos de trabalho do Fabric Deployment Pipelines.

Conteúdo relacionado

• Desenvolvimento e implantação
• Introdução à integração do Git