Compartilhar via

Controle do código-fonte com Warehouse (preview)

  • Artigo

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:

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. Captura de tela do portal do Fabric do warehouse nas configurações 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:

Captura de tela do portal do Fabric de um esquema de warehouse de amostra.

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.

Baixar o projeto de banco de dados SQL de um warehouse no Fabric

Com a extensão projetos do Banco de Dados SQL disponíveis dentro do Azure Data Studio e do Visual Studio Code, você poderá gerenciar um esquema de warehouse e lidar com alterações de objeto do Warehouse como outros projetos de banco de dados SQL.

Para baixar uma cópia local do esquema do warehouse, selecione Baixar o projeto do banco de dados SQL na faixa de opções.

Captura de tela do portal do Fabric da faixa de opções de consulta. A caixa de projeto Baixar banco de dados SQL está realçada.

A cópia local de um projeto de banco de dados que contém a definição do esquema de warehouse. O projeto de banco de dados pode ser usado para:

  • Recriar o esquema do warehouse em outro warehouse.
  • Desenvolver ainda mais o esquema de warehouse em ferramentas de cliente, como o Azure Data Studio ou o Visual Studio Code.

Publicar projeto de banco de dados SQL em um novo warehouse

Para publicar o esquema de warehouse em um novo warehouse:

  1. Crie um novo warehouse no seu espaço de trabalho do Fabric.
  2. Na nova página de inicialização do warehouse, em Criar um de warehouse, selecione projeto do banco de dados SQL. Captura de tela do portal do Fabric do botão do projeto de banco de dados SQL.
  3. Selecione o arquivo .zip que foi baixado do warehouse existente.
  4. O esquema do warehouse é publicado no novo warehouse.

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. Captura de tela do portal do Fabric das fases de Desenvolvimento, Teste e Produção.
  4. Selecione Implantar para implantar seus warehouses nas fases de Desenvolvimento, Teste e Produção.

Para obter mais informações sobre o processo de pipelines de implantação do Fabric, consulte Visão geral dos pipelines de implantação do Fabric.

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

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.
  • Não há suporte para o ponto de extremidade de análise do SQL com a integração do Git.

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.
  • Não há suporte para o ponto de extremidade de análise do SQL em pipelines de implantação.

Conteúdo relacionado