Pular para o conteúdo principal

Adicionar um recurso de aplicativo Databricks a um aplicativo Databricks

Adicione outro aplicativoDatabricks como recurso para o seu aplicativo, para que ele possa se comunicar com outros aplicativos implantados. Isso possibilita interações entre aplicativos, como chamar API de outro aplicativo ou orquestrar o fluxo de trabalho entre vários aplicativos.

Adicionar um recurso de aplicativo Databricks

Antes de adicionar um aplicativo como recurso, revise os pré-requisitos do recurso de aplicativo.

  1. Ao criar ou editar um aplicativo, navegue até Configurar o passo.

  2. Na seção Recurso do aplicativo , clique em + Adicionar recurso .

  3. Selecione o aplicativo Databricks como o tipo de recurso.

  4. Escolha o aplicativo desejado dentre os aplicativos disponíveis em seu workspace.

  5. Selecione o nível de permissão para seu aplicativo:

    • Pode ser usado: Concede permissão ao aplicativo para chamar e invocar o aplicativo de destino. Corresponde ao privilégio CAN USE .
  6. (Opcional) Especifique uma key de recurso personalizada, que é como você referencia o aplicativo de destino na configuração do seu aplicativo. A key default é app.

Ao adicionar um recurso de aplicativo Databricks:

  • O Databricks concede à entidade de serviço do seu aplicativo a permissão CAN USE no aplicativo de destino.
  • Seu aplicativo pode invocar ou chamar o endpoint do aplicativo de destino.

variável de ambiente

Quando você implanta um aplicativo com um recurso de aplicativo, Databricks expõe o nome do aplicativo de destino (não seu URL) por meio de uma variável de ambiente que você pode referenciar usando o campo valueFrom . Para obter a URL do aplicativo de destino, resolva o nome usando o SDK do Databricks.

Configuração de exemplo:

YAML
env:
- name: MY_OTHER_APP
valueFrom: app # Use your custom resource key if different

Para resolver o URL do aplicativo de destino em seu aplicativo:

Python
import os
from databricks.sdk import WorkspaceClient

# Access the target app name from the environment variable
w = WorkspaceClient()
other_app = w.apps.get(name=os.environ["MY_OTHER_APP"])

# Get the target app's URL
url = other_app.url # e.g. "https://my-other-app-12345.cloud.databricksapps.com"

Para mais informações, veja Usar variável de ambiente para acessar recurso.

Remover um recurso de aplicativo Databricks

Ao remover um recurso de aplicativo, o Databricks remove a permissão CAN USE do conjunto de permissões do aplicativo de destino. Seu aplicativo não pode mais chamar ou invocar o aplicativo de destino. O aplicativo em si permanece inalterado e continua disponível para outros usuários e aplicativos que possuam as permissões adequadas.

Melhores práticas

Considere o seguinte ao trabalhar com o recurso de aplicativo Databricks :

  • Utilize variáveis de ambiente e o SDK Databricks para resolver a URL do aplicativo de destino em tempo de execução, em vez de codificar URLs diretamente no código, o que mantém seu aplicativo portátil em diferentes ambientes.
  • Implemente o tratamento de erros para os casos em que o aplicativo de destino estiver indisponível ou retornar erros.
  • Monitore a integridade e a disponibilidade dos aplicativos de destino, especialmente se o seu aplicativo depender deles para funcionalidades críticas.