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

A extensão de código do Visual Studio (VS) para Synapse suporta totalmente as operações de bloco de anotações CRUD (criar, ler, atualizar e excluir) na malha. 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 essa extensão, você também pode executar notebooks no Apache Spark remoto compute for Fabric.

Abra um bloco de notas com a extensão Synapse

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 Synapse VS Code para 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.

Ver 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 anotações existe no espaço de trabalho remoto e você não o baixou localmente.
• 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 bloco de anotações 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.

Descarregar um bloco 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 anotações e o bloco de anotações será aberto na tela do VS Code Editor.

Eliminar um bloco de notas

Para excluir um bloco de anotações:

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 alterações do 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: sua alteração do VS Code é salva com êxito no espaço de trabalho.
   • Rejeitar: sua alteração do VS Code é ignorada.

Extrair 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 comparação do VS Code para que você possa comparar os dois arquivos do bloco de anotações. 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. Quando tiver resolvido 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 no modo de conflito .)

   

Executar ou depurar um bloco de anotações na computação remota 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, durante o tempo de execução, a extensão interceta todas as chamadas de API do PySpark e as traduz para a chamada http correspondente para a computação remota do Spark. Para código Python puro, ele ainda é executado no ambiente local.

Conteúdos relacionados

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