Extensión del IDE de Databricks

La extensión IDE de Databricks te permite conectarte a tus espacios de trabajo remotos de Azure Databricks desde Visual Studio Code o Cursor en tu máquina local de desarrollo. Luego, puede:

• Defina, implemente y ejecute agrupaciones de automatización declarativa para aplicar patrones de CI/CD y procedimientos recomendados a los trabajos de Lakeflow, las canalizaciones de Lakeflow y las pilas de MLOps mediante la interfaz de usuario de Visual Studio Code. Consulta qué son los paquetes de automatización declarativa y las funciones de paquetes y exploradores.
• Ejecuta archivos locales de código Python desde Visual Studio Code en clústeres de Azure Databricks en tus espacios de trabajo remotos. Consulte Ejecutar un archivo de Python en un clúster.
• Ejecute archivos de código Python locales (.py) y cuadernos de Python, R, Scala y SQL (.py, .ipynb, .r, .scala y .sql) desde Visual Studio Code como trabajos de Lakeflow en las áreas de trabajo remotas. Consulte Ejecutar un archivo Python como tarea.
• Configure el entorno de depuración y Databricks Connect mediante una lista de comprobación sencilla que desencadena diálogos de selección. Consulta Depurar código usando Databricks Connect para la extensión del IDE Databricks.
• Depura cuadernos celda por celda dentro de Visual Studio Code con Databricks Connect. Consulta Ejecutar y depurar celdas de cuaderno con Databricks Connect mediante la extensión para IDE de Databricks.
• Sincronice el código local que desarrolle en Visual Studio Code con código en las áreas de trabajo remotas. Consulte Sincronizar la carpeta del espacio de trabajo con Databricks

Nota:

La extensión del IDE Databricks soporta ejecutar cuadernos en R, Scala y SQL como trabajos automatizados, pero no ofrece un soporte más profundo para estos lenguajes dentro de Visual Studio Code.

Comenzar

Para empezar a usar la extensión del IDE Databricks:

• Instale la extensión.
• Create un nuevo proyecto de Databricks o convert un proyecto de Visual Studio Code existente.
• Configure tu proyecto fácilmente mediante la interfaz de usuario de la extensión Databricks.
• Ejecute algún código de Python como parte del tutorial extension.
• Depure el código mediante la integración de Databricks Connect.
• Pruebe el código mediante pytest. Consulta Ejecutar pruebas en Python usando la extensión del IDE Databricks.

Creación de un nuevo proyecto de Databricks

Una vez instalada la extensión, puedes crear un nuevo proyecto Databricks usando la extensión del IDE de Databricks:

1. Inicie Visual Studio Code.
2. Haga clic en el icono Databricks de la barra lateral Visual Studio Code para abrir la extensión.
3. Haga clic en Crear un nuevo proyecto.
4. En la Paleta de comandos, seleccione un host y un método de autenticación para el proyecto. Consulta Configurar autorización para la extensión del IDE Databricks.
5. En Proporcionar una ruta de acceso a una carpeta en la que quiere que esté el nuevo proyecto, escriba la ruta de acceso a una carpeta en el equipo de desarrollo local donde quiera crear el proyecto o haga clic en el cuadro de diálogo Abrir selección de carpetas y seleccione la ruta de acceso a la carpeta del proyecto.
6. En Plantilla que se va a usar en la vista de inicialización del proyecto de Databricks, use las flechas arriba y abajo para seleccionar una plantilla de proyecto y presione Entrar. Para obtener información sobre las plantillas de proyecto de agrupación, consulte Plantillas de proyecto de paquetes de Automatización declarativa.
7. Para el proyecto, escriba un Nombre único para este proyecto o deje el nombre de proyecto predeterminado de my_project y luego presione Entrar.
8. Elija si desea añadir al proyecto un cuaderno de notas de ejemplo, una canalización de Delta Live Tables de ejemplo o un paquete de Python de ejemplo, o cualquier combinación de estos ejemplos.
9. Presione cualquier tecla para cerrar la pestaña Databricks Project Init editor.
10. En Seleccionar el proyecto que quiere abrir, elija el proyecto que acaba de crear.

Abrir un proyecto de agrupaciones de automatización declarativa existente

Un proyecto de agrupaciones de automatización declarativa tiene un databricks.yml archivo en la carpeta raíz del proyecto. Consulte Configuración de agrupaciones de Automatización declarativa. Si desea usar la extensión con un proyecto de agrupaciones de Automatización declarativa existente:

1. Inicie Visual Studio Code. En el menú principal, haga clic en Archivo>Abrir carpeta y vaya al directorio que contiene el proyecto de agrupación.

2. Haga clic en el icono Databricks de la barra lateral Visual Studio Code para abrir y empezar a usar las características de la extensión.

   Si la extensión del IDE Databricks detecta más de un proyecto de Declarative Automation Bundles en la carpeta actual, te permite elegir abrir un proyecto o crear un archivo de configuración del proyecto en la carpeta raíz.

   

   • Si eligió un proyecto, en la Paleta de Comandos, seleccione su proyecto existente de Paquetes de Automatización Declarativa.
   • Si crea una configuración en la carpeta raíz, esa carpeta se convierte en un proyecto de agrupación.

3. Seleccione un host y un método de autenticación para el proyecto. Consulta Configurar la autorización para la extensión de IDE de Databricks.

Nota:

Si abres un proyecto creado usando la extensión IDE v1 de Databricks, la migración se intenta automáticamente usando la autenticación y la configuración de espacio de trabajo existentes del proyecto. El botón de migración solo está disponible si se produce un error en la migración automática.

Cambio entre proyectos de Databricks

La extensión IDE de Databricks te permite tener varios proyectos de Databricks dentro de tu espacio de trabajo de Visual Studio Code y cambiar fácilmente entre ellos. Con el proyecto de agrupación múltiple abierto en el área de trabajo de Visual Studio Code:

1. Haga clic en el icono Databricks de la barra lateral Visual Studio Code para abrir la extensión.

2. Haga clic en Carpeta local para seleccionar el proyecto que utilizará la extensión.

   selector de carpetas locales

Nota:

Las acciones de ejecución solo están disponibles para los archivos del lote activo.

Convertir un proyecto en un proyecto de Databricks

Si tiene un proyecto existente que desea convertir en un proyecto de Databricks:

1. Inicie Visual Studio Code. En el menú principal, haga clic en Archivo>Abrir carpeta y vaya al proyecto para abrirlo.
2. Haga clic en el icono Databricks de la barra lateral Visual Studio Code para abrir la extensión.
3. Haga clic en Crear configuración.
4. En la Paleta de comandos, seleccione un host y un método de autenticación para el proyecto. Consulta Configurar autorización para la extensión del IDE Databricks.