Defina a variável de ambiente em um aplicativo Databricks

Databricks define automaticamente determinadas variáveis de ambiente no ambiente de execução do aplicativo. Essas variáveis fornecem informações essenciais sobre o aplicativo e workspace e são acessíveis a todos os aplicativos Databricks por default. Para obter uma lista das variáveis default , consulte o ambienteDatabricks Apps.

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

Por exemplo:

YAML
env:
  - name: LOG_LEVEL
    value: 'debug'

Utilize valores fixos apenas quando forem estáticos, não sensíveis e consistentes em diferentes ambientes. Exemplos incluem value: "true" para alternar recursos, value: "us-west" para regiões fixas ou value: "UTC" para fusos horários default .

importante

Para manter seu aplicativo seguro e portátil, nunca faça referência à chave secreta ou outros valores confidenciais diretamente na configuração do seu aplicativo. Por exemplo, evite incorporar valores secretos no campo value de uma variável de ambiente ou diretamente no seu código-fonte. Em vez disso, use o campo valueFrom para referenciar com segurança segredos e outros recursos gerenciados definidos em seu bloco de recursos. Isso garante que os segredos sejam recuperados do Databricks em tempo de execução e nunca sejam expostos em texto simples nos seus arquivos de configuração.

Use variável de ambiente para acessar o recurso

Se o senhor definir um recurso de aplicativo, como SQL warehouse ou secrets, faça referência a esses recursos na seção env do seu arquivo app.yaml usando o campo valueFrom. Isso conecta a variável de ambiente em seu aplicativo à chave de recurso definida em resources.

Exemplo de trecho app.yaml:

YAML
env:
  - name: WAREHOUSE_ID
    valueFrom: sql_warehouse

  - name: SECRET_KEY
    valueFrom: secret

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

Python
JavaScript

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;

`valueFrom` referência

A tabela a seguir mostra o valor que valueFrom representa para cada tipo de recurso:

Tipo de recurso	Valor resolvido	Exemplo
Aplicativo Databricks	Nome do aplicativo	`my-app`
Espaço Genie	ID do espaço	`01ef1fa2b3c45678`
Banco de dados de autoescalonamento Lakebase	caminho do ponto final	`projects/my-project/branches/main/endpoints/ep123`
Banco de dados de provisionamento Lakebase	Host	`postgres-host.example.com`
LakeFlow Job	ID do Job	`123456789`
Experimento MLflow	ID da experiência	`456789012`
Modelo de ponto de extremidade de serviço	Nome do endpoint	`my-serving-endpoint`
Segredo	Valor secreto descriptografado	(o valor secreto)
Armazém SQL	ID do armazém	`a1b2c3d4e5f67890`
Conexão Unity Catalog	Nome da conexão	`my_connection`
Tabela Unity Catalog	Nome completo da tabela	`catalog.schema.table`
Volume Unity Catalog	Caminho do volume	`/Volumes/catalog/schema/volume`
Função definida pelo usuário	Nome completo da função	`catalog.schema.my_function`
Índice de pesquisa vetorial	Índice nome completo	`catalog.schema.my_index`

Use variável de ambiente para acessar o recurso​

valueFrom referência​

Próximos passos​

Use variável de ambiente para acessar o recurso

`valueFrom` referência

Próximos passos