Partilhar via


Definir variáveis de ambiente em um aplicativo Databricks

O Azure Databricks define automaticamente determinadas variáveis de ambiente no ambiente de tempo de execução do aplicativo. Essas variáveis fornecem informações essenciais sobre o aplicativo e o espaço de trabalho e são acessíveis a todos os aplicativos Databricks por padrão. Para obter uma lista de variáveis padrão, consulte Ambiente do sistema Databricks Apps.

Se seu aplicativo exigir variáveis de ambiente adicionais, defina-as no arquivo de configuração app.yaml na env seção . Cada variável requer um nome e um valor. As variáveis podem usar um valor codificado ou fazer referência a uma fonte externa.

Por exemplo:

env:
  - name: LOG_LEVEL
    value: 'debug'

Apenas inclua valores codificados quando são estáticos, não sensíveis e consistentes em todos os ambientes. Exemplos incluem value: "true" alternâncias de funcionalidades, value: "us-west" regiões fixas ou value: "UTC" fusos horários padrão.

Importante

Para manter a sua aplicação segura e portátil, nunca faça referência a chaves secretas ou outros valores sensíveis diretamente na configuração da sua aplicação. Por exemplo, evite incorporar valores secretos value no campo de uma variável de ambiente ou diretamente no código-fonte. Em vez disso, use o valueFrom campo para fazer referência segura a segredos e outros recursos gerenciados definidos em seu bloco de recursos. Isso garante que os segredos sejam recuperados do Azure Databricks em tempo de execução e nunca sejam expostos em texto sem formatação em seus arquivos de configuração.

Usar variáveis de ambiente para acessar recursos

Se definir recursos da aplicação, como armazenamentos SQL ou segredos, referencie esses recursos na seção env do seu arquivo app.yaml usando o campo valueFrom. Isso conecta variáveis de ambiente em seu aplicativo às chaves de recurso definidas em resources.

Exemplo app.yaml de trecho:

env:
  - name: WAREHOUSE_ID
    valueFrom: sql_warehouse

  - name: SECRET_KEY
    valueFrom: secret

Em seguida, no código do aplicativo, acesse-os como variáveis de ambiente:

Python

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 saber mais sobre como gerenciar segredos do Azure Databricks, consulte Gerenciar segredos.

Próximos passos