Criar e gerenciar blocos de anotações do Microsoft Fabric no Visual Studio Code

A extensão do Visual Studio Code (VS Code) do Fabric Data Engineering suporta totalmente as operações de caderno de criação, leitura, atualização e exclusão (CRUD) no Fabric. A extensão também suporta sincronização entre espaços de trabalho locais e remotos; Ao sincronizar alterações, você pode resolver quaisquer conflitos ou diferenças entre seu espaço de trabalho local e remoto.

Com esta extensão, pode também executar notebooks no ambiente de computação remoto Apache Spark do Fabric.

Abra um bloco de anotações com a extensão Data Engineering

Ao clicar no botão Abrir no VS Code na página de criação do bloco de anotações no portal do Fabric, você pode abrir diretamente o mesmo bloco de anotações com a extensão Data Engineering VS Code for Fabric. Depois de ativar a extensão no VS Code e abrir o bloco de anotações uma vez, seu espaço de trabalho deve se conectar automaticamente ao bloco de anotações.

Veja a lista de blocos de notas

O nó da árvore do bloco de anotações lista todos os itens do bloco de anotações no espaço de trabalho atual. Com base nas alterações no VS Code, a lista exibe cores e caracteres diferentes para indicar o estado mais recente, conforme mostrado na imagem a seguir.

• Padrão: texto branco e nenhum caractere à direita do nome do bloco de anotações indica o estado padrão ou inicializado. O bloco de notas existe na área de trabalho remota e não é transferido para o VS Code local.
• Modificado: O caractere M à direita do nome e do texto amarelo indica que você baixou e editou o bloco de anotações localmente no VS Code e ainda não publicou as alterações pendentes de volta ao espaço de trabalho remoto.
• Local: O caractere L e o texto verde indicam que o notebook foi baixado e o conteúdo é o mesmo do espaço de trabalho remoto.
• Conflito: O caractere C e o texto vermelho indicam que existem conflitos entre a versão local e a versão do espaço de trabalho remoto.

Criar um bloco de notas

1. No VS Code Explorer, passe o mouse sobre a barra de ferramentas do bloco de anotações. A opção Criar bloco de anotações é exibida.

   

2. Selecione Criar Bloco de Anotações e insira um nome e uma descrição. Um novo bloco de anotações é criado no espaço de trabalho remoto e aparece na lista de blocos de anotações no estado padrão.

Transferir um caderno de notas

Antes de poder editar o conteúdo de um bloco de notas, tem de transferir o bloco de notas para o VS Code.

1. Na lista de blocos de notas no VS Code, passe o rato sobre o nome do bloco de notas. A opção Download aparece ao lado do nome do bloco de anotações.

   

2. Selecione Baixar e salve o bloco de anotações no diretório de trabalho local.

Abrir um bloco de notas

1. No VS Code Explorer, passe o mouse sobre o nome de um bloco de anotações baixado. Várias opções aparecem ao lado do bloco de anotações, incluindo a opção Abrir pasta do Bloco de Anotações.

   

2. Selecione Abrir pasta do bloco de notas e o bloco de notas abre na tela do Editor do VS Code.

Eliminar um bloco de notas

Para eliminar um caderno:

1. No VS Code Explorer, passe o mouse sobre o nome do bloco de anotações que você deseja excluir; opções aparecem à direita do nome, incluindo a opção Excluir Bloco de Anotações .

   

2. Selecione a opção Excluir bloco de anotações . Quando solicitado, opte por excluir apenas a cópia local ou ambas as cópias do espaço de trabalho local e remoto.

Publicar alterações locais no espaço de trabalho remoto

Para enviar as alterações locais para o espaço de trabalho remoto:

1. No VS Code Explorer, passe o mouse sobre o nome do bloco de anotações que você deseja publicar no espaço de trabalho remoto; opções aparecem à direita do nome, incluindo a opção Publicar .

   

2. Selecione Publicar. A versão do espaço de trabalho remoto é atualizada com as mudanças feitas no seu VS Code local.

   • Se a atualização local criar conflitos de mesclagem, você será solicitado a resolvê-los antes que a mesclagem seja concluída.

3. Se outra pessoa tiver o mesmo bloco de anotações aberto no portal do Fabric, ela será notificada para aceitar ou rejeitar suas alterações locais do VS Code, conforme mostrado na imagem a seguir.

   

   • Aceitar: a sua alteração no VS Code foi guardada com sucesso na área de trabalho.
   • Rejeitar: sua alteração do VS Code é ignorada.

Puxar alterações do espaço de trabalho remoto

Para atualizar sua versão local com a versão mais recente do espaço de trabalho, puxe a versão remota:

1. No VS Code Explorer, passe o mouse sobre o nome do bloco de anotações que você deseja atualizar; opções aparecem à direita do nome, incluindo a opção Atualizar Bloco de Anotações .

   

2. Selecione a opção Atualizar bloco de anotações . O VS Code extrai a versão mais recente do espaço de trabalho remoto e abre o editor de diferenças do VS Code para que possa comparar os dois ficheiros do bloco de notas. A tela do lado esquerdo é do espaço de trabalho e a tela do lado direito é da versão local:

   

3. Atualize a célula de código/marcação no lado esquerdo para resolver o problema.

4. Depois de resolver todos os conflitos, selecione a opção Mesclar no canto superior direito do editor de comparação para confirmar que a mesclagem foi concluída. (Até selecionar Mesclar, o bloco de anotações permanece em modo de conflito.)

   

Executar ou depurar um notebook num sistema remoto do Spark

Ao selecionar o kernel synapse-spark-kernel fornecido com esta extensão, você pode executar a célula de código sobre a computação remota do Spark. Depois de selecionar esse kernel, a extensão interceta todas as chamadas de API do PySpark durante o tempo de execução e as traduz para a chamada http correspondente para a computação remota do Spark. O código Python ainda é executado no ambiente local.

Conteúdos relacionados

• Criar e gerenciar definições de trabalho do Apache Spark no Visual Studio Code
• Explore os lakehouses do Microsoft Fabric no Visual Studio Code