Environnement Databricks Apps

Votre application Databricks s'exécute dans un environnement géré avec les binaires et les ressources suivantes :

• Système d'exploitation : Ubuntu 22.04 LTS
• Environnement Python : Python 3.11, exécuté dans un environnement virtuel dédié. Toutes les dépendances sont isolées dans cet environnement. Les applications qui utilisent uv peuvent spécifier une version de Python différente. Consultez Gérer les dépendances d'une application Databricks.
• Version uv : 0.10.2
• Environnement Node.js : version 22.16. Gérez les dépendances avec npm ou pnpm en utilisant un fichier package.json. Voir Définir les dépendances Node.js.
• Ressources système : By default, chaque application peut utiliser jusqu'à 2 processeurs virtuels (vCPU) et 6 Go de mémoire. Configurez la taille du compute pour ajuster l'allocation de CPU et de mémoire en fonction de vos exigences de charge de travail. Consultez Configurer les ressources de compute pour une application Databricks.

Afficher les détails de l'environnement

Pour afficher l'environnement d'une application spécifique, y compris les variables d'environnement et les packages installés, accédez à l'onglet tab sur la page de détails de l'application. Voir Afficher les détails d'une application Databricks.

Variables d'environnement default

Les variables d'environnement suivantes sont disponibles dans chaque application :

Variable	Description
DATABRICKS_APP_NAME	Le nom de l'application en cours d'exécution.
DATABRICKS_WORKSPACE_ID	L'identifiant unique du Workspace Databricks auquel l'application appartient.
DATABRICKS_HOST	L'URL du workspace Databricks auquel l'application appartient.
DATABRICKS_APP_PORT	Le port réseau sur lequel l'application doit écouter.
DATABRICKS_CLIENT_ID	L'ID client pour le Databricks Service Principal attribué à l'application.
DATABRICKS_CLIENT_SECRET	Le secret OAuth du Service Principal Databricks attribué à l'application.

Variable	Description
DATABRICKS_APP_NAME	Le nom de l'application en cours d'exécution.
DATABRICKS_WORKSPACE_ID	L'identifiant unique du Workspace Databricks auquel l'application appartient.
DATABRICKS_HOST	L'URL du workspace Databricks auquel l'application appartient.
DATABRICKS_APP_PORT	Le port réseau sur lequel l'application doit écouter.
DATABRICKS_CLIENT_ID	L'ID client pour le Databricks Service Principal attribué à l'application.
DATABRICKS_CLIENT_SECRET	Le secret OAuth du Service Principal Databricks attribué à l'application.

Variables d'environnement de télémétrie de l’application

Lorsque vous activez la télémétrie pour votre application, Databricks configure automatiquement les variables d'environnement suivantes dans l'environnement d'exécution de l'application :

Variable	Valeur	Description
OTEL_EXPORTER_OTLP_ENDPOINT	http://localhost:4314	L'Endpoint du collecteur OTLP
OTEL_EXPORTER_OTLP_PROTOCOL	grpc	Le protocole d'exportation
OTEL_RESOURCE_ATTRIBUTES	workspace.id=<id>,app.name=<name>	Attributs de Ressources pour le contexte de trace
OTEL_SERVICE_NAME	<your_app_name>	Le nom du service pour les données de télémétrie
OTEL_BSP_MAX_QUEUE_SIZE	10000	Taille maximale de l'étendue de la file d'attente
OTEL_BLRP_MAX_QUEUE_SIZE	10000	Taille maximale de la file d'attente de logs
OTEL_BSP_MAX_EXPORT_BATCH_SIZE	512	Taille du batch pour les exportations de spans
OTEL_BLRP_MAX_EXPORT_BATCH_SIZE	512	Taille du batch pour les exportations de logs
OTEL_BSP_SCHEDULE_DELAY	1000	Intervalle d'exportation de span (ms)
OTEL_BLRP_SCHEDULE_DELAY	1000	Intervalle d'exportation des Logs (ms)

Variable	Valeur	Description
OTEL_EXPORTER_OTLP_ENDPOINT	http://localhost:4314	L'Endpoint du collecteur OTLP
OTEL_EXPORTER_OTLP_PROTOCOL	grpc	Le protocole d'exportation
OTEL_RESOURCE_ATTRIBUTES	workspace.id=<id>,app.name=<name>	Attributs de Ressources pour le contexte de trace
OTEL_SERVICE_NAME	<your_app_name>	Le nom du service pour les données de télémétrie
OTEL_BSP_MAX_QUEUE_SIZE	10000	Taille maximale de l'étendue de la file d'attente
OTEL_BLRP_MAX_QUEUE_SIZE	10000	Taille maximale de la file d'attente de logs
OTEL_BSP_MAX_EXPORT_BATCH_SIZE	512	Taille du batch pour les exportations de spans
OTEL_BLRP_MAX_EXPORT_BATCH_SIZE	512	Taille du batch pour les exportations de logs
OTEL_BSP_SCHEDULE_DELAY	1000	Intervalle d'exportation de span (ms)
OTEL_BLRP_SCHEDULE_DELAY	1000	Intervalle d'exportation des Logs (ms)

Pour en savoir plus sur la configuration de la télémétrie des applications, consultez Configurer la télémétrie pour les Databricks Apps.

Variables d'environnement du framework

Le runtime Databricks Apps définit automatiquement les variables de port et d'hôte pour les frameworks Python pris en charge. Vous n'avez pas besoin de les configurer manuellement. Toutes les variables de port sont définies à la valeur de DATABRICKS_APP_PORT.

Framework	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
Exprimer	PORT

Framework	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
Exprimer	PORT

Variables d'environnement Streamlit supplémentaires

Le runtime définit également les variables spécifiques à Streamlit suivantes :

Variable	Description
STREAMLIT_SERVER_HEADLESS	Définir sur true afin que Streamlit s'exécute sans ouvrir de fenêtre de navigateur.
STREAMLIT_BROWSER_GATHER_USAGE_STATS	Définissez sur false pour empêcher l'envoi de statistiques d'utilisation à Streamlit.

Variable	Description
STREAMLIT_SERVER_HEADLESS	Définir sur true afin que Streamlit s'exécute sans ouvrir de fenêtre de navigateur.
STREAMLIT_BROWSER_GATHER_USAGE_STATS	Définissez sur false pour empêcher l'envoi de statistiques d'utilisation à Streamlit.

Aucune bibliothèque Node.js n'est préinstallée dans l'environnement Databricks Apps. Répertoriez toutes les dépendances Node.js dans votre fichier package.json. Voir Définir les dépendances Node.js.