Controle do código-fonte e implantação do notebook

Este artigo explica como os pipelines de integração e implantação do Git funcionam para notebooks no Microsoft Fabric. Saiba como configurar uma conexão com seu repositório, gerenciar seus notebooks e implantá-los em diferentes ambientes.

Integração do Git do notebook

Os notebooks do Fabric oferecem integração do Git para controle do código-fonte com o Azure DevOps. Com a integração do Git, você pode fazer backup e versão do seu notebook, reverter para fases anteriores conforme necessário, colaborar ou trabalhar sozinho usando Git branches e gerenciar totalmente o ciclo de vida de conteúdo do notebook no Fabric.

Importante

Esse recurso está em versão prévia.

Configurar uma conexão

Nas configurações do workspace, você pode configurar facilmente uma conexão com seu repositório a fim de confirmar e sincronizar alterações. Para configurar a conexão, consulte Introdução à integração do Git. Uma vez conectados, seus itens, incluindo blocos de notebooks, aparecem no painel de Controle do código-fonte.

Depois de confirmar com êxito as instâncias do notebook no repositório Git, você verá a estrutura de pastas do notebook no repositório.

Agora você pode executar operações futuras, como Criar solicitação de pull.

Representação do notebook no Git

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

Quando você confirma o item do notebook no repositório Git, o código do notebook é convertido em um formato de código-fonte, em vez de um arquivo .ipynb padrão. Por exemplo, um notebook PySpark é convertido em um arquivo notebook-content.py. Essa abordagem permite revisões de código mais fáceis usando recursos de diferenciação internos.

No arquivo de origem do conteúdo do item, os metadados (incluindo o Lakehouse padrão e o ambiente anexado), as células markdown e as células de código são preservados e diferenciados. Essa abordagem dá suporte a uma recuperação precisa quando você sincroniza novamente com um workspace do Fabric.

A saída da célula do notebook não está incluída ao sincronizar com o Git.

Observação

• Atualmente, os arquivos nos Recursos do notebook não são confirmados no repositório. Há suporte para a confirmação desses arquivos em uma versão futura.
• O ambiente anexado persiste em um notebook quando você sincroniza do repositório com um workspace do Fabric. Atualmente, não há suporte para ambientes de referência entre workspaces. Você deve anexar manualmente a um novo ambiente ou configurações padrão de workspace para executar o notebook.
• A ID padrão do Lakehouse persiste no notebook quando você sincroniza do repositório com um workspace do Fabric. Se confirmar um notebook com o Lakehouse padrão, você deverá consultar manualmente um item do Lakehouse recém-criado. Para obter mais informações, consulte a integração do Git do Lakehouse.

Notebook em pipelines de implantação

Você também pode usar o pipeline de implantação para implantar o código do notebook em diferentes ambientes, como desenvolvimento, teste e produção. Esse recurso pode permitir que você simplifique seu processo de desenvolvimento, garanta a qualidade e a consistência e reduza erros manuais com operações leves de baixo código. Você também pode usar regras de implantação para personalizar o comportamento dos notebooks quando eles são implantados, como alterar o Lakehouse padrão de um notebook.

Importante

Esse recurso está em versão prévia.

Use as etapas a seguir para concluir a implantação do notebook 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 notebooks entre diferentes fase, conforme mostrado no exemplo a seguir.

   

4. Selecione Implantar para implantar seus notebooks nas fases de Desenvolvimento, Teste e Produção.

5. (Opcional). Você pode selecionar Regras de implantação para criar regras de implantação para um processo de implantação. A entrada de regras de implantação está na fase de destino para um processo de implantação.

   

   O Fabric dá suporte à parametrização do Lakehouse padrão para cada instância de notebook ao implantar com regras de implantação. Três opções estão disponíveis para especificar o Lakehouse padrão de destino: o mesmo com Lakehouse de origem, N/Ae outro Lakehouse.

   

   Você pode obter o isolamento de dados protegido configurando essa regra. O Lakehouse padrão do notebook é substituído pelo que você especificou como destino durante a implantação.

   Observação

   Quando você opta por adotar outros Lakehouses no ambiente de destino, a ID do Lakehouse indispensável. Você pode encontrar a ID de um Lakehouse no link da URL do Lakehouse.

6. Monitore o status da implantação do Histórico de implantação.

Conteúdo relacionado

• Gerenciar e executar notebooks do Fabric com APIs públicas
• Introdução à integração do Git
• Introdução aos pipelines de implantação