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

Artigo
11/04/2024

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 blocos de anotações e implantá-los em diferentes ambientes.

Integração com Notebook Git

Os blocos de anotações de malha 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 estágios anteriores conforme necessário, colaborar ou trabalhar sozinho usando ramificações do Git e gerenciar o ciclo de vida do conteúdo do seu notebook inteiramente no Fabric.

Nota

A partir de outubro de 2024, a integração do Notebook git suporta a persistência da relação de mapeamento do ambiente anexado ao sincronizar com o novo espaço de trabalho, o que significa que quando você confirma o bloco de anotações e o ambiente anexado juntos ao repositório git e o sincroniza com outro espaço de trabalho, o bloco de anotações e o ambiente recém-gerados serão vinculados. Esta atualização terá impacto nos Blocos de Anotações existentes e Ambientes dependentes que são versionados no git, a ID física do ambiente anexado no conteúdo de metadados do bloco de anotações será substituída por uma ID lógica, a alteração será refletida na visualização de comparação.

Configurar uma ligação

Nas configurações do espaço de trabalho, você pode facilmente configurar uma conexão com o repositório para confirmar e sincronizar alterações. Para configurar a conexão, consulte Introdução à integração com o Git. Uma vez conectados, seus itens, incluindo blocos de anotações, aparecem no painel de controle Origem.

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

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

Representação de notebook no Git

A imagem a seguir é um exemplo da estrutura de arquivos de cada item do bloco de anotações no repositório:

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

No arquivo de origem de conteúdo do item, os metadados (incluindo a casa do lago padrão e o ambiente anexado), as células de marcação e as células de código são preservados e distinguidos. Essa abordagem oferece suporte a uma recuperação precisa quando você sincroniza com um espaço de trabalho de malha.

A saída da célula do bloco de anotações não está incluída durante a sincronização com o Git.

Nota

Atualmente, os arquivos nos recursos do Bloco de Anotações não estão comprometidos com o repositório. A confirmação desses arquivos é suportada em uma versão futura.
Recomendamos que você gerencie os blocos de anotações e seu ambiente dependente no mesmo espaço de trabalho e use o git para controlar a versão dos itens do bloco de anotações e do ambiente , o sistema Fabric Git manipulará a relação de mapeamento ao sincronizar o bloco de anotações e o ambiente anexado a novos espaços de trabalho.
O ID padrão do lakehouse persiste no bloco de anotações quando você sincroniza do repositório para um espaço de trabalho do Fabric. Se você confirmar um bloco de anotações com o lakehouse padrão, deverá indicar um item lakehouse recém-criado manualmente. Para obter mais informações, consulte Lakehouse Git integration.

Bloco de anotações em pipelines de implantação

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

Nota

Você está usando o novo design do pipeline de implantação agora, a interface do usuário antiga pode ser acessada desativando 'Novo pipeline de implantação'.
A partir de outubro, o bloco de anotações de malha oferece suporte ao recurso de vinculação automática que vinculará o ambiente padrão e o ambiente anexado no mesmo espaço de trabalho ao implantar na próxima etapa. A mudança terá impactos nos notebooks existentes no pipeline de implantação.
- O lakehouse padrão e o ambiente anexado (quando todos os itens dependentes estiverem no mesmo espaço de trabalho) serão substituídos por itens recém-gerados no espaço de trabalho de destino, a alteração de metadados do bloco de anotações será destacada na visualização de comparação na próxima rodada de implantação.
- Você pode definir regras de implantação para o lakehouse padrão para substituir o lakehouse vinculado automaticamente.
Problema conhecido: o status da célula congelada no notebook será perdido durante a implantação. Estamos atualmente a trabalhar em tarefas relacionadas.

Use as etapas a seguir para concluir a implantação do bloco de anotações usando o pipeline de implantação.

Crie um novo 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.)
Atribua espaços de trabalho a diferentes estágios de acordo com suas metas de implantação.
Selecione, visualize e compare itens, incluindo blocos de anotações, entre diferentes estágios, conforme mostrado no exemplo a seguir. O selo realçado indica a contagem de itens alterada entre o estágio anterior e o estágio atual.
Selecione Implantar para implantar seus blocos de anotações nos estágios de desenvolvimento, teste e produção.
(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á no estágio de destino de um processo de implantação.

O Fabric oferece suporte à parametrização do lakehouse padrão para cada instância de bloco de anotações 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 lake house de origem, N/A (sem lakehouse padrão) e outro lakehouse.

Você pode obter isolamento de dados seguro configurando esta regra. O lakehouse padrão do seu bloco de anotações é substituído pelo que você especificou como destino durante a implantação.

Nota

Ao definir o lakehouse padrão nas regras de implantação, o Lakehouse ID deve ter. Você pode obter o id da lakehouse no link URL do item. As regras de implantação têm prioridade maior do que a vinculação automática, o lakehouse vinculado automaticamente será substituído quando houver regra de implantação configurada.
Monitore o status da implantação a partir do histórico de implantação.