Definición de variables de entorno en una aplicación de Databricks

Azure Databricks establece automáticamente determinadas variables de entorno en el entorno de tiempo de ejecución de la aplicación. Estas variables proporcionan información esencial sobre la aplicación y el área de trabajo, y son accesibles para todas las aplicaciones de Databricks de forma predeterminada. Para obtener una lista de variables predeterminadas, consulte Entorno del sistema de Databricks Apps.

Si la aplicación requiere variables de entorno adicionales, definalas en el archivo de configuración app.yaml de la env sección . Cada variable requiere un nombre y un valor. Las variables pueden usar un valor codificado de forma codificada o hacer referencia a un origen externo.

Por ejemplo:

env:
  - name: LOG_LEVEL
    value: 'debug'

Solo incorpore valores directamente en el código cuando sean estáticos, no confidenciales y coherentes entre entornos. Entre los ejemplos se incluyen value: "true" los botóns de alternancia de características, value: "us-west" las regiones fijas o value: "UTC" las zonas horarias predeterminadas.

Importante

Para mantener la aplicación segura y portátil, nunca haga referencia a claves secretas u otros valores confidenciales directamente en la configuración de la aplicación. Por ejemplo, evite insertar valores secretos en el campo de una variable de entorno o directamente en el value código fuente. En su lugar, use el valueFrom campo para hacer referencia de forma segura a secretos y otros recursos administrados definidos en el bloque de recursos. Esto garantiza que los secretos se recuperan de Azure Databricks en tiempo de ejecución y nunca se exponen en texto no cifrado en los archivos de configuración.

Uso de variables de entorno para acceder a los recursos

Si define recursos de aplicación, como almacenes de SQL o secretos, haga referencia a estos recursos en la sección env de su archivo app.yaml mediante el campo valueFrom. Esto conecta las variables de entorno de la aplicación a las claves de recursos definidas en resources.

Fragmento de código de ejemplo app.yaml :

env:
  - name: WAREHOUSE_ID
    valueFrom: sql_warehouse

  - name: SECRET_KEY
    valueFrom: secret

A continuación, en el código de la aplicación, acceda a ellos como variables de entorno:

Pitón

import os

warehouse_id = os.getenv("WAREHOUSE_ID")
secret_value = os.getenv("SECRET_KEY")

JavaScript

const warehouseId = process.env.WAREHOUSE_ID;
const secretValue = process.env.SECRET_KEY;

Para más información sobre la administración de secretos de Azure Databricks, consulte Administración de secretos.

Pasos siguientes

• Adición de recursos a una aplicación de Databricks
• Configuración de la ejecución de aplicaciones de Databricks con app.yaml
• Entorno del sistema de Databricks Apps