Environnement Databricks Apps

Votre application Databricks s’exécute dans un environnement managé avec les fichiers binaires et les ressources suivants :

• Système d’exploitation: Ubuntu 22.04 LTS
• Environnement Python : Python 3.11, en cours d’exécution 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 autre version de Python. Consultez Gérer les dépendances pour une application Databricks.
• version uv : 0.10.2
• environnementNode.js : Node.js version 22.16. Gérer les dépendances à l’aide npm et package.json.
• Ressources système : Par défaut, chaque application peut utiliser jusqu’à 2 processeurs virtuels (processeurs virtuels) et 6 Go de mémoire. Configurez la taille de calcul pour ajuster l’allocation de processeur et de mémoire en fonction des besoins de votre charge de travail. Consultez Configurer la taille de calcul d’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 Environnement de la page détails de l’application. Consultez Afficher les détails d’une application Databricks.

Variables d’environnement par défaut

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

Variable	Descriptif
DATABRICKS_APP_NAME	Nom de l’application en cours d’exécution.
DATABRICKS_WORKSPACE_ID	ID unique de l’espace de travail Databricks auquel appartient l’application.
DATABRICKS_HOST	URL de l’espace de travail Databricks auquel appartient l’application.
DATABRICKS_APP_PORT	Le port réseau sur lequel l’application doit écouter.
DATABRICKS_CLIENT_ID	ID client du principal de service Databricks affecté à l’application.
DATABRICKS_CLIENT_SECRET	Le secret OAuth pour le principal de service Databricks affecté à l’application.

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

Lorsque vous activez la télémétrie pour votre application, Azure Databricks configure automatiquement les variables d’environnement suivantes dans le runtime de l’application :

Variable	Valeur	Descriptif
OTEL_EXPORTER_OTLP_ENDPOINT	http://localhost:4314	Point de terminaison du collecteur OTLP
OTEL_EXPORTER_OTLP_PROTOCOL	grpc	Protocole d’exportation
OTEL_RESOURCE_ATTRIBUTES	workspace.id=<id>,app.name=<name>	Attributs de ressource pour le contexte de trace
OTEL_SERVICE_NAME	<your_app_name>	Nom du service pour les données de télémétrie
OTEL_BSP_MAX_QUEUE_SIZE	10000	Taille maximale de la file d’attente d’étendue
OTEL_BLRP_MAX_QUEUE_SIZE	10000	Taille maximale de la file d’attente du journal
OTEL_BSP_MAX_EXPORT_BATCH_SIZE	512	Taille du lot pour les exportations d’étendues
OTEL_BLRP_MAX_EXPORT_BATCH_SIZE	512	Taille du lot pour les exportations de journaux
OTEL_BSP_SCHEDULE_DELAY	1000	Intervalle d’exportation d’étendue (ms)
OTEL_BLRP_SCHEDULE_DELAY	1000	Intervalle d’exportation du journal (ms)

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

Variables d’environnement de 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 sur la valeur de DATABRICKS_APP_PORT.

Cadre	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
Fiole	FLASK_RUN_PORT, FLASK_RUN_HOST=0.0.0.0
Tiret	PORT
Express	PORT

Variables d’environnement Streamlit supplémentaires

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

Variable	Descriptif
STREAMLIT_SERVER_ENABLE_XSRF_PROTECTION	Réglez sur false. Le proxy inverse Databricks Apps gère la protection XSRF.
STREAMLIT_SERVER_ENABLE_CORS	Réglez sur false. Le proxy inverse Databricks Apps gère CORS.
STREAMLIT_SERVER_HEADLESS	Définissez cette option true pour que Streamlit s’exécute sans ouvrir une fenêtre de navigateur.
STREAMLIT_BROWSER_GATHER_USAGE_STATS	Définissez cette option pour false empêcher l’envoi de statistiques d’utilisation à Streamlit.

Aucune bibliothèque Node.js n’est préinstallée dans l’environnement Databricks Apps. Pour Node.js applications, vous devez répertorier explicitement toutes les dépendances de votre package.json fichier pour vous assurer qu’elles sont installées au moment de l’exécution.