¿Qué es la extensión de Visual Studio Code de Synapse?

La extensión de Visual Studio Code de Synapse admite una experiencia profesional para desarrolladores para explorar almacenes de lago de Microsoft Fabric y crear cuadernos de Fabric y definiciones de trabajos de Spark. Obtenga más información sobre la extensión, incluyendo cómo empezar a trabajar con los requisitos previos necesarios.

Visual Studio (VS) Code es uno de los editores de código fuente ligeros más populares, el cual se ejecuta en el escritorio y está disponible para Windows, macOS y Linux. Al instalar la extensión de VS Code de Synapse, podrá crear, ejecutar y depurar el cuaderno y la definición de trabajo de Spark localmente en VS Code. También puede publicar el código en el proceso remoto de Spark en el área de trabajo de Fabric para ejecutar o depurar. La extensión también le permitirá examinar los datos del almacén de lago en VS Code, incluyendo tablas y archivos sin procesar.

Requisitos previos

Requisitos previos para la extensión de VS Code de Synapse:

Después de instalar el software necesario, deberá actualizar las propiedades del sistema operativo.

Windows

  1. Agregue JAVA_HOME a las variables de entorno y apunte al directorio donde esté instalado Java 1.8.

  2. Agregue %JAVA_HOME%/bin y la subcarpeta condabin de la instalación de Conda al directorio de la ruta de acceso del sistema.

macOS

Ejecute el archivo conda.sh en el terminal:

  1. Abra la ventana del terminal, cambie el directorio a la carpeta donde esté instalado Conda y, a continuación, cambie al subdirectorio etc/profile.d. El subdirectorio debería contener un archivo denominado conda.sh.

  2. Ejecute source conda.sh.

  3. En la misma ventana de terminal, ejecute sudo conda init.

  4. Tipo en Java --version. La versión debería ser Java 1.8.

Instalación de la extensión y preparación del entorno

  1. Busque Synapse VS Code en el marketplace de extensiones de VS Code e instale la extensión.

  2. Una vez completada la instalación de la extensión, reinicie VS Code. El icono de la extensión aparecerá en la barra de actividades de VS Code.

Directorio de trabajo local

Para editar un cuaderno, es necesario tener una copia local del contenido del cuaderno. El directorio de trabajo local de la extensión actúa como carpeta raíz local para todos los cuadernos descargados, incluso aquellos cuadernos de áreas de trabajo diferentes. Al invocar el comando Synapse:Set Local Work Folder, es posible especificar una carpeta como directorio de trabajo local para la extensión.

Para validar la configuración, abra la configuración de la extensión y compruebe los detalles allí:

Screenshot of the Settings screen, showing the selected local working directory.

Inicie y cierre sesión en la cuenta

  1. En la paleta de comandos de VS Code, escriba el comando Synapse:Sign in para iniciar sesión en la extensión. Aparece una página de inicio de sesión en el explorador independiente.

  2. Compruebe el nombre de usuario y la contraseña.

  3. Después de iniciar sesión correctamente, el nombre de usuario se mostrará en la barra de estado de VS Code para indicar que ha iniciado sesión.

    Screenshot of the VS Code status bar, showing where to find your sign-in status.

  4. Para cerrar sesión en la extensión, ingrese el comando Synapse: Sign off.

Elección de un área de trabajo con la que trabajar

Para seleccionar un área de trabajo de Fabric, es necesario tener un área de trabajo creada. Si no tuviera ninguna, puede crear una mediante el portal de Fabric. Para obtener más información, consulte Create a workspace (Crear un área de trabajo).

Una vez que tenga un área de trabajo, selecciónela seleccionando la opción Seleccionar área de trabajo . Aparecerá una lista de todas las áreas de trabajo a las que tenga acceso. Seleccione la que desee de la lista.

Screenshot of VS Code Explorer, showing where to find the Select Workspace option.

Limitaciones actuales

En esta introducción, obtendrá información básica sobre cómo instalar y configurar la extensión de VS Code de Synapse. En los artículos siguientes, se explica cómo desarrollar los cuadernos y las definiciones de trabajos de Spark localmente en VS Code.