Partilhar via

Integração de controle de origem do banco de dados SQL no Microsoft Fabric

  • Artigo

Aplica-se a:✅Banco de dados SQL no Microsoft Fabric

Neste tutorial, você aprenderá a trabalhar com seu banco de dados SQL no controle de origem de integração git do Fabric with Fabric.

Um banco de dados SQL no Microsoft Fabric tem integração de controle de origem, ou "integração git", permitindo que os usuários SQL acompanhem as definições de seus objetos de banco de dados ao longo do tempo. Essa integração permite que uma equipe:

  • Confirme o banco de dados no controle do código-fonte, que converte automaticamente o banco de dados ativo em código no repositório de controle do código-fonte configurado (como o Azure DevOps).
  • Atualize objetos de banco de dados a partir do conteúdo do controle do código-fonte, que valida o código no repositório de controle do código-fonte antes de aplicar uma alteração diferencial ao banco de dados.

Diagrama do ciclo simples de confirmação e atualização entre o banco de dados ativo e o controle do código-fonte.

Se você não está familiarizado com o git, aqui estão alguns recursos recomendados:

Este artigo apresenta uma série de cenários úteis que podem ser usados individualmente ou em combinação para gerenciar seu processo de desenvolvimento com o banco de dados SQL na malha:

Pré-requisitos

Configurar

Essa conexão de repositório se aplica no nível do espaço de trabalho, de modo que uma única ramificação no repositório seja associada a esse espaço de trabalho. O repositório pode ter várias ramificações, mas apenas o código na ramificação selecionada nas configurações do espaço de trabalho afetará diretamente o espaço de trabalho.

Para conhecer as etapas para conectar seu espaço de trabalho a um repositório de controle do código-fonte, consulte Introdução à integração do Git. Seu espaço de trabalho pode ser conectado a um repositório remoto do Azure DevOps ou GitHub.

Adicionar o banco de dados SQL do Fabric ao controle do código-fonte

Nesse cenário, você confirmará objetos de banco de dados no controle do código-fonte. Você pode estar desenvolvendo um aplicativo onde está criando objetos diretamente em um banco de dados de teste e rastreie esse banco de dados no controle do código-fonte, assim como o código do seu aplicativo. Como resultado, você tem acesso ao histórico das definições de seus objetos de banco de dados e pode usar conceitos do Git como ramificação e mesclagem para personalizar ainda mais seu processo de desenvolvimento.

  1. Conecte-se ao seu banco de dados SQL no editor Fabric SQL, no SQL Server Management Studio, na extensão mssql com o Visual Studio Code ou em outras ferramentas externas.
  2. Crie uma nova tabela, procedimento armazenado ou outro objeto no banco de dados.
  3. Selecione o menu do banco de dados, selecione Atualizar status de ... sincronização do Git.
  4. Selecione o botão Controle do código-fonte para abrir o painel de controle do código-fonte.
  5. Marque a caixa de seleção ao lado do banco de dados desejado. Selecione Confirmar. O serviço Fabric lê definições de objeto do banco de dados e as grava no repositório remoto.
  6. Agora você pode visualizar o histórico de objetos de banco de dados na visualização do código-fonte do repositório de código.

À medida que você continua a editar o banco de dados, incluindo a edição de objetos existentes, você pode confirmar essas alterações no controle do código-fonte seguindo as etapas anteriores.

Atualizar o banco de dados SQL do Fabric a partir do controle do código-fonte

Nesse cenário, você criará objetos de banco de dados como código na extensão de projetos SQL no VS Code e, em seguida, confirmará os arquivos no controle do código-fonte antes de atualizar o banco de dados SQL do Fabric a partir da integração do controle do código-fonte. Esse cenário é direcionado para desenvolvedores que preferem trabalhar no VS Code, têm aplicativos existentes usando projetos SQL ou têm requisitos de pipeline de CI/CD mais avançados.

  1. Certifique-se de ter instalado a versão mais recente do VS Code e as extensões de projetos mssql e SQL para o VS Code.
  2. Crie um novo banco de dados SQL em seu espaço de trabalho e confirme-o no controle do código-fonte sem adicionar nenhum objeto. Esta etapa adiciona o projeto SQL vazio e os metadados do item do banco de dados SQL ao repositório.
  3. Clone o repositório de controle do código-fonte em sua máquina local.
    • Se você estiver usando o Azure DevOps, selecione o menu de ... contexto para o projeto de controle do código-fonte. Selecione Clonar para copiar seu repositório do Azure DevOps para sua máquina local. Se você é novo no Azure DevOps, consulte o guia Código com git para Azure DevOps.
    • Se você estiver usando o GitHub, selecione o botão Código no repositório e copie a URL para clonar o repositório para sua máquina local. Se você é novo no GitHub, consulte o guia de clonagem de um repositório .
  4. Abra a pasta clonada no Visual Studio Code. A ramificação associada ao seu espaço de trabalho pode não ser o padrão. Você deve ver uma pasta nomeada <yourdatabase>.SQLDatabase no VS Code depois de alternar a ramificação.
  5. Crie um .sql arquivo para pelo menos uma tabela que você gostaria de criar no banco de dados dentro da estrutura de pastas do seu banco de dados. O arquivo deve conter a CREATE TABLE instrução para a tabela. Por exemplo, crie um arquivo nomeado MyTable.sql na pasta dbo/Tables com o seguinte conteúdo: 
    CREATE TABLE dbo.MyTable
(
    Id INT PRIMARY KEY,
    ExampleColumn NVARCHAR(50)
);
  6. Para garantir que a sintaxe seja válida, podemos validar o modelo de banco de dados com o projeto SQL. Depois de adicionar os arquivos, use a visualização Projetos de banco de dados no VS Code para criar o projeto.
  7. Após uma compilação bem-sucedida, confirme os arquivos no controle do código-fonte com a visualização do controle do código-fonte no VS Code ou na interface git local preferida.
  8. Envie/sincronize sua confirmação para o repositório remoto. Verifique se seus novos arquivos apareceram no Azure DevOps ou no GitHub.
  9. Retorne à interface da Web do Fabric e abra o painel de controle Código-fonte no espaço de trabalho. Talvez você já tenha um alerta de que "você tem alterações pendentes do git". Selecione o botão Atualizar (Atualizar tudo) para aplicar o código do seu projeto SQL ao banco de dados.
    • Você pode ver o banco de dados indicar imediatamente que está "Não confirmado" após a atualização. Isso ocorre porque o recurso de integração do Git faz uma comparação direta de todo o conteúdo do arquivo gerado para uma definição de item, e algumas diferenças não intencionais são possíveis. Um exemplo são os atributos embutidos em colunas. Nesses casos, você precisará confirmar novamente o controle do código-fonte na interface da Web do Fabric para sincronizar a definição com o que é gerado como parte de uma operação de confirmação.
  10. Quando a atualização estiver concluída, use uma ferramenta de sua escolha para se conectar ao banco de dados. Os objetos que você adicionou ao projeto SQL visíveis no banco de dados.

Nota

Ao fazer alterações no projeto SQL local, se houver um erro de sintaxe ou o uso de recursos sem suporte no Fabric, a atualização do banco de dados falhará. Você deve reverter manualmente a alteração no controle do código-fonte antes de poder continuar.

Criar um espaço de trabalho de filial

Nesse cenário, você configurará um novo ambiente de desenvolvimento no Fabric fazendo com que o Fabric crie um conjunto duplicado de recursos com base na definição de controle do código-fonte. O banco de dados duplicado incluirá os objetos de banco de dados que verificamos no controle do código-fonte. Esse cenário é direcionado para desenvolvedores que continuam seu ciclo de vida de desenvolvimento de aplicativos no Fabric e estão utilizando a integração de controle de origem do Fabric.

  1. Conclua o cenário : converta o banco de dados SQL de malha em código no controle do código-fonte.
    • Você deve ter uma ramificação em um repositório de controle do código-fonte com um projeto SQL e os metadados do objeto Fabric.
  2. No espaço de trabalho Malha, abra o painel de controle do código-fonte. Na guia Ramificações do menu Controle do código-fonte, selecione Ramificação para novo espaço de trabalho.
  3. Especifique os nomes da ramificação e do espaço de trabalho que serão criados. A ramificação será criada no repositório de controle do código-fonte e será preenchida com o conteúdo confirmado da ramificação associada ao espaço de trabalho do qual você está ramificando. O espaço de trabalho será criado no Fabric.
  4. Navegue até o espaço de trabalho recém-criado no Fabric. Quando a criação do banco de dados for concluída, o banco de dados recém-criado agora conterá os objetos especificados no repositório de código. Se você abrir o editor de consultas de malha e navegar no Pesquisador de objetos, seu banco de dados terá novas tabelas (vazias) e outros objetos.

Mesclar alterações de uma ramificação para outra

Nesse cenário, você usará o repositório de controle do código-fonte para revisar as alterações do banco de dados antes que elas estejam disponíveis para implantação. Esse cenário é direcionado para desenvolvedores que estão trabalhando em um ambiente de equipe e estão usando o controle do código-fonte para gerenciar suas alterações no banco de dados.

Crie dois espaços de trabalho com ramificações associadas no mesmo repositório, conforme descrito no cenário anterior.

  1. Com o banco de dados na ramificação secundária, faça alterações nos objetos do banco de dados.
    • Por exemplo, modifique um procedimento armazenado existente ou crie uma nova tabela.
  2. Verifique essas alterações no controle do código-fonte com o botão Confirmar no painel de controle do código-fonte no Fabric.
  3. No Azure DevOps ou GitHub, crie uma solicitação pull da ramificação secundária para a ramificação primária.
    • Na solicitação pull, você pode ver as alterações no código do banco de dados entre o espaço de trabalho primário e o espaço de trabalho secundário.
  4. Depois de concluir a solicitação pull, o controle do código-fonte é atualizado, mas o banco de dados no Fabric no espaço de trabalho primário não é alterado. Para alterar o banco de dados primário, atualize o espaço de trabalho primário a partir do controle do código-fonte usando o botão Atualizar no painel de controle do código-fonte no Fabric.

Conteúdos relacionados