Adicionar recurso a um aplicativo Databricks

Seus aplicativos Databricks podem se integrar a vários recursos da plataforma Databricks, como Databricks SQL para consulta de dados, LakeFlow Jobs para ingestão de dados e processamento, Mosaic AI Model Serving para acessar modelos generativos AI e Databricks secrets para gerenciar informações confidenciais. No contexto dos aplicativos, esses recursos de plataforma são chamados de recursos .

Para manter os aplicativos portáteis e seguros, evite a codificação de IDs de recurso. Por exemplo, em vez de incorporar um ID SQL warehouse fixo em seu arquivo app.yaml, configure o SQL warehouse como um recurso por meio da UI do Databricks Apps ou em databricks.yaml.

Os aplicativos são executados com o mínimo de privilégio e dependem de recursos existentes na plataforma Databricks. Quando implantado, a entidade de serviço do aplicativo acessa esses recursos e deve ter as permissões necessárias, como acesso em nível de tabela para consultas SQL ou acesso de leitura ao segredo. Consulte Configurar autorização em um aplicativo Databricks.

Configurar o recurso para seu aplicativo

permitem que seu aplicativo se conecte com segurança ao serviço do qual depende, sem codificar valores confidenciais ou específicos do ambiente.

Databricks UI

Adicione a maioria dos recursos diretamente na interface do usuário de aplicativos ao criar ou editar o aplicativo.

Na seção App recurso , clique em + Add recurso e selecione o tipo de recurso que deseja usar. O senhor atribui um key a cada recurso, ao qual faz referência no seu arquivo app.yaml.

Databricks.yml

Adicione manualmente o recurso na seção resources do seu arquivo de configuração databricks.yml. Esse método oferece mais flexibilidade para configurações avançadas.

YAML

resources:
  sql_warehouses:
    sql_warehouse: # resource key
      name: my-warehouse

  secrets:
    secret: # resource key
      scope: my-scope
      key: my-key

O senhor pode então fazer referência a esses recursos na configuração do aplicativo usando o campo valueFrom.

Use variável de ambiente para acessar o recurso

Depois de definir o recurso do aplicativo, faça referência a esse recurso na seção env do 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

import os

warehouse_id = os.getenv["WAREHOUSE_ID"]
secret_value = os.getenv["SECRET_KEY"]

Para saber mais sobre como gerenciar os segredos do Databricks, consulte Gerenciar segredos.