Entorno de Aplicaciones de Databricks

La aplicación databricks se ejecuta en un entorno administrado con los siguientes archivos binarios y recursos:

• Sistema operativo: Ubuntu 22.04 LTS
• Entorno de Python: Python 3.11, que se ejecuta en un entorno virtual dedicado. Todas las dependencias están aisladas dentro de este entorno. Las aplicaciones que usan uv pueden especificar otra versión de Python. Consulte Administración de dependencias para una aplicación de Databricks.
• versión uv: 0.10.2
• Node.js entorno: Node.js versión 22.16. Administre las dependencias mediante npm y package.json.
• Recursos del sistema: De forma predeterminada, cada aplicación puede usar hasta 2 CPU virtuales (vCPU) y 6 GB de memoria. Configure el tamaño de proceso para ajustar la asignación de CPU y memoria en función de los requisitos de la carga de trabajo. Consulte Configuración de recursos de proceso para una aplicación de Databricks.

Visualización de los detalles del entorno

Para ver el entorno de una aplicación específica, incluidas las variables del entorno y los paquetes instalados, vaya a la pestaña Entorno en la página de detalles de la aplicación. Consulte Ver los detalles de una aplicación de Databricks.

Variables de entorno predeterminadas

Las siguientes variables de entorno están disponibles en cada aplicación:

Variable	Descripción
DATABRICKS_APP_NAME	El nombre de la aplicación que se ejecuta.
DATABRICKS_WORKSPACE_ID	El ID único del área de trabajo de Databricks a la que pertenece la aplicación.
DATABRICKS_HOST	La dirección URL del área de trabajo de Databricks a la que pertenece la aplicación.
DATABRICKS_APP_PORT	Puerto de red en el que la aplicación debe escuchar.
DATABRICKS_CLIENT_ID	Identificador de cliente de la entidad de servicio de Databricks asignada a la aplicación.
DATABRICKS_CLIENT_SECRET	Secreto de OAuth para la entidad de servicio de Databricks asignada a la aplicación.

Variables de entorno de telemetría de aplicaciones

Al habilitar la telemetría para la aplicación, Azure Databricks configura automáticamente las siguientes variables de entorno en el entorno de ejecución de la aplicación:

Variable	Importancia	Descripción
OTEL_EXPORTER_OTLP_ENDPOINT	http://localhost:4314	El punto de conexión del recopilador de OTLP
OTEL_EXPORTER_OTLP_PROTOCOL	grpc	Protocolo de exportación
OTEL_RESOURCE_ATTRIBUTES	workspace.id=<id>,app.name=<name>	Atributos de recursos para el contexto de seguimiento
OTEL_SERVICE_NAME	<your_app_name>	El nombre del servicio para los datos de telemetría
OTEL_BSP_MAX_QUEUE_SIZE	10000	Tamaño máximo de la cola de intervalos
OTEL_BLRP_MAX_QUEUE_SIZE	10000	Tamaño máximo de cola de registro
OTEL_BSP_MAX_EXPORT_BATCH_SIZE	512	Tamaño de lote para exportaciones de intervalos
OTEL_BLRP_MAX_EXPORT_BATCH_SIZE	512	Tamaño del lote para las exportaciones de registros
OTEL_BSP_SCHEDULE_DELAY	1000	Intervalo de exportación de intervalos (ms)
OTEL_BLRP_SCHEDULE_DELAY	1000	Intervalo de exportación de registros (ms)

Para más información sobre cómo configurar la telemetría de aplicaciones, consulte Configuración de telemetría para aplicaciones de Databricks.

Variables de entorno de marco

El entorno de ejecución de Databricks Apps establece automáticamente las variables de puerto y host para marcos de Python compatibles. No es necesario configurarlos manualmente. Todas las variables de puerto se establecen en el valor de DATABRICKS_APP_PORT.

Marco de referencia	Variables
Gradio	GRADIO_SERVER_PORT, GRADIO_SERVER_NAME=0.0.0.0
Streamlit	STREAMLIT_SERVER_PORT, STREAMLIT_SERVER_ADDRESS=0.0.0.0
FastAPI	UVICORN_PORT, UVICORN_HOST=0.0.0.0
Uvicorn	UVICORN_PORT, UVICORN_HOST=0.0.0.0
Flask	FLASK_RUN_PORT, FLASK_RUN_HOST=0.0.0.0
Dash	PORT
Express	PORT

Variables de entorno adicionales de Streamlit

El entorno de ejecución también establece las siguientes variables específicas de Streamlit:

Variable	Descripción
STREAMLIT_SERVER_HEADLESS	Establézcalo en true para que Streamlit se ejecute sin abrir una ventana del explorador.
STREAMLIT_BROWSER_GATHER_USAGE_STATS	Establézcalo en false para evitar el envío de estadísticas de uso a Streamlit.

No hay bibliotecas de Node.js preinstaladas en el entorno de Databricks Apps. Para aplicaciones Node.js, debe enumerar explícitamente todas las dependencias en el archivo package.json para asegurarse de que están instaladas al momento de ejecución.