Compartilhar via

O que é a extensão de Visual Studio Code do Synapse?

  • Artigo

A extensão do Visual Studio Code do Synapse dá suporte a uma experiência pró-desenvolvedor para explorar o Microsoft Fabric Lakehouses e criar notebooks Fabric e definições de trabalho do Spark. Saiba mais sobre a extensão, incluindo como começar a usar os pré-requisitos necessários.

O VS (Visual Studio) Code é um dos editores de código-fonte leve mais populares; ele é executado na área de trabalho e está disponível para Windows, macOS e Linux. Ao instalar a extensão do VS Code do Synapse, você pode criar, executar e depurar o notebook e a definição de trabalho do Spark localmente no VS Code. Você também pode postar o código na computação remota do Spark no workspace do Fabric para executar ou depurar. A extensão também permite que você navegue pelos dados do Lakehouse, incluindo tabelas e arquivos brutos, no VS Code.

Pré-requisitos

Pré-requisitos para a extensão do VS Code do Synapse:

Depois de instalar o software necessário, você deve atualizar as propriedades do sistema operacional.

Windows

  1. Adicione JAVA_HOME às variáveis de ambiente e aponte-a para o diretório em que o java 1.8 está instalado. Por exemplo, se você instalar o JDK no caminho C:\Program Files\Java\jdk-1.8, defina o valor da variável JAVA_HOME para esse caminho.

  2. Adicione %JAVA_HOME%/bin e a subpasta condabin da instalação do Conda ao diretório caminho do sistema. A pasta condabin pode estar na pasta onde você instalou e neste formato \miniconda3\condsbin. Abra as variáveis de ambiente e adicione %JAVA_HOME%/bin e caminhos condabin à variável Caminho.

macOS

Execute o conda.sh no terminal:

  1. Abra a janela do terminal, altere o diretório para a pasta em que o Conda está instalado e altere para o subdiretório etc/profile.d. O subdiretório deve conter um arquivo chamado conda.sh.

  2. Execute source conda.sh.

  3. Na mesma janela do terminal, execute sudo conda init.

  4. Digite Java --version. A versão deve ser Java 1.8.

Instalar a extensão e preparar seu ambiente

  1. Pesquise o VS Code do Synapse no marketplace de extensão do VS Code e instale a extensão.

  2. Depois que a instalação da extensão for concluída, reinicie o VS Code. O ícone da extensão está listado na barra de atividades do VS Code.

Diretório de trabalho local

Para editar um bloco de anotações, você deve ter uma cópia local do conteúdo do notebook. O diretório de trabalho local da extensão serve como a pasta raiz local para todos os notebooks baixados, até mesmo notebooks de diferentes workspaces. Ao invocar o comando Synapse:Set Local Work Folder, você pode especificar uma pasta como o diretório de trabalho local para a extensão.

Para validar a configuração, abra as configurações de extensão e marcar os detalhes:

Captura de tela da tela de configurações, mostrando o diretório de trabalho do local selecionado.

Entrar e sair da sua conta

  1. Na paleta de comandos do VS Code, insira o Synapse:Sign in comando para entrar na extensão. Uma página de entrada separada do navegador é exibida.

  2. Digite o nome de usuário e a senha.

  3. Depois que você entrar com êxito, seu nome de usuário será exibido na barra de status do VS Code para indicar que você está conectado.

    Captura de tela da barra de status do VS Code, mostrando onde encontrar seu status de entrada.

  4. Para sair da extensão, insira o comando Synapse: Sign off.

Escolher um workspace com o qual trabalhar

Para selecionar um workspace do Fabric, você deve ter um workspace criado. Caso não tenha um, pode criá-lo no portal do Fabric. Para obter mais informações, consulte Criar um workspace.

Depois de ter um workspace, escolha-o selecionando a opção Selecionar Workspace. Uma lista é exibida de todos os workspaces aos quais você tem acesso; selecione o que você deseja na lista.

Captura de tela do Explorer do VS Code, mostrando onde encontrar a opção Selecionar Workspace.

Limitações atuais

  • A extensão no modo de área de trabalho ainda não dá suporte ao Utilitários do Microsoft Spark
  • Não há suporte para o comando Shell iniciar com “!”.

Conteúdo relacionado

Nesta visão geral, você obtém uma compreensão básica de como instalar e configurar a extensão do VS Code do Synapse. Os próximos artigos explicam como desenvolver seus notebooks e definições de trabalho do Spark localmente no VS Code.