Introducción a Las aplicaciones de Databricks

Este artículo le ayuda a empezar a trabajar con Databricks Apps mediante un ejemplo paso a paso para crear una aplicación sencilla en el área de trabajo de Azure Databricks mediante una plantilla que siga los procedimientos recomendados de Azure Databricks.

En este ejemplo se explica lo siguiente:

• Creación de una aplicación a partir de una plantilla
• Visualización de la aplicación después de implementarla
• Copia de la plantilla de aplicación en el equipo para un desarrollo posterior
• Ejecución local de la aplicación
• Volver a implementar la aplicación en el área de trabajo

Al final de este artículo, podrá hacer iteraciones en su aplicación de manera local y desplegar actualizaciones en Databricks.

Prerrequisitos

Antes de completar este tutorial, asegúrese de que el área de trabajo de Azure Databricks y el entorno de desarrollo local están configurados correctamente. Consulte Configuración del área de trabajo y el entorno de desarrollo de Databricks Apps.

Paso 1: Instalación de dependencias

Abra un terminal y ejecute los siguientes comandos para:

• Instale las bibliotecas de Python necesarias para la aplicación de ejemplo.
• Cree un directorio local para los archivos de origen y configuración de la aplicación.

pip install gradio
pip install pandas
mkdir gradio-hello-world
cd gradio-hello-world

gradio-hello-world es el directorio local de los archivos de la aplicación.

Paso 2: Creación de la aplicación

1. En el área de trabajo de Databricks, haga clic en + Nueva>aplicación en la barra lateral izquierda.

2. Elija la plantilla Hola mundo de Gradio .

   

3. Asigne un nombre a la aplicación gradio-hello-world y haga clic en Instalar.

Esto crea una nueva aplicación basada en la plantilla seleccionada e la implementa en el área de trabajo.

Paso 3: Ver la aplicación

Después de crear una aplicación, se inicia automáticamente y muestra una dirección URL que puede usar para obtener una vista previa. Vea la dirección URL de la aplicación y el estado de implementación en la página Información general :

Haga clic en la dirección URL para ver la aplicación:

Azure Databricks genera automáticamente la dirección URL de la aplicación en función del nombre de la aplicación y el identificador del área de trabajo. No se puede cambiar la dirección URL después de crear la aplicación. Si necesita una dirección URL diferente, cree una aplicación con un nombre diferente. Para obtener más información, consulte Dirección URL de la aplicación.

Paso 4: Copiar la aplicación en el equipo

Después de crear la aplicación, puede descargar el código fuente en el equipo local para personalizarla.

1. Copie los comandos en Sincronizar los archivos:

   

2. En un terminal, vaya al gradio-hello-world directorio local que creó y, a continuación, ejecute los comandos copiados:

   databricks workspace export-dir /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app .
   
   ...
   Export complete
   
   gradio-hello-world % databricks sync --watch . /Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app
   
   ...
   Initial Sync Complete
   

   El primer comando exporta tres archivos del área de trabajo al directorio local: app.py, app.yamly requirements.txt. El segundo comando inicia un proceso de sincronización que busca cambios en los archivos locales y los carga automáticamente en el área de trabajo.

   • app.py contiene el código que implementa la funcionalidad y la interfaz de usuario de la aplicación.
   • app.yaml define la configuración de la aplicación, incluido su punto de entrada y permisos.
   • requirements.txt enumera los paquetes de Python necesarios para la aplicación.

Paso 5: Modificar y probar la aplicación localmente

1. Opcionalmente, personalice y desarrolle la aplicación localmente. Por ejemplo, puede modificar app.py para que los datos sean interactivos, agregar un tema o opciones de estilo, o permitir cargas de datos.

2. Para probar la aplicación, ejecute python app.py:

   python app.py
   
   Running on local URL:  http://127.0.0.1:7860
   ...
   

3. Para ver la aplicación, vaya a http://127.0.0.1:7860 en una ventana del explorador.

4. Opcionalmente, use el comando databricks apps run-local para ejecutar y depurar la app:

   databricks apps run-local --prepare-environment --debug
   

   Este comando instala todas las dependencias y prepara el entorno virtual y, a continuación, inicia la aplicación y el depurador en el puerto 5678. Vaya a http://localhost:8001 para ver la aplicación.

   Para establecer puntos de interrupción en Visual Studio Code, instale la extensión del depurador de Python y luego vaya a Ejecutar>Iniciar depuración>Conexión remota.

Paso 6: Volver a implementar la aplicación en el área de trabajo

Para volver a implementar la aplicación, copie el comando en Implementar en aplicaciones de Databricks en la página de información general de la aplicación.

Ejecute el comando desde el gradio-hello-world directorio local.

El comando se ejecuta exitosamente con:

{
  "create_time": "2026-02-03T23:25:38Z",
  "creator": "my-email@org.com",
  "deployment_artifacts": {
    "source_code_path": "/Workspace/Users/4cfd4a36-2cef-4155-88c4-d258ed6d0d91/src/01f10157a60a113e980014bebd5f4a03"
  },
  "deployment_id": "01f10157a60a113e980014bebd5f4a03",
  "mode": "SNAPSHOT",
  "source_code_path": "/Workspace/Users/my-email@org.com/databricks_apps/gradio-hello-world_2026_02_03-22_34/gradio-hello-world-app",
  "status": {
    "message": "App started successfully",
    "state": "SUCCEEDED"
  },
  "update_time": "2026-02-03T23:25:41Z"
}

Para ver el estado de implementación, vaya a la página Información general de la aplicación.

Pasos siguientes

Ahora que ha implementado y personalizado la primera aplicación, puede hacer lo siguiente:

• Configure la autorización para administrar quién puede acceder a la aplicación y editarla.
• Integre la aplicación con características de la plataforma de Azure Databricks, como secretos de Azure Databricks o Databricks SQL.
• Comparta la aplicación con otros usuarios del área de trabajo o en toda la organización.
• Explore más plantillas de aplicación para experimentar con diferentes marcos y funcionalidades.