Adicionar um recurso de aplicativo do Databricks a um aplicativo do Databricks

Adicione outro aplicativo databricks como um recurso para seu aplicativo para que ele possa se comunicar com outros aplicativos implantados. Isso permite interações entre aplicativos, como chamar a API de outro aplicativo ou orquestrar fluxos de trabalho em vários aplicativos.

Adicionar um recurso de aplicativo do Databricks

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

1. Ao criar ou editar um aplicativo, navegue até a etapa Configurar.
2. Na seção Recursos do aplicativo, clique em + Adicionar recurso.
3. Selecione o aplicativo Databricks como o tipo de recurso.
4. Escolha o aplicativo de destino nos aplicativos disponíveis em seu workspace.
5. Selecione o nível de permissão do aplicativo:
   • Pode usar: Concede ao aplicativo permissão para chamar e invocar o aplicativo de destino. Corresponde ao privilégio CAN USE.
6. (Opcional) Especifique uma chave de recurso personalizada, que é como você faz referência ao aplicativo de destino na configuração do aplicativo. A chave padrão é app.

Ao adicionar um recurso de aplicativo do Databricks:

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

Variáveis de ambiente

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

Configuração de exemplo:

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

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

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 obter mais informações, consulte Usar variáveis de ambiente para acessar recursos.

Remover um recurso de aplicativo do Databricks

Quando você remove um recurso de aplicativo, o Databricks remove a CAN USE permissão do conjunto de permissões do aplicativo de destino. Seu aplicativo não pode mais chamar ou invocar o aplicativo de destino. O aplicativo de destino em si permanece inalterado e continua disponível para outros usuários e aplicativos que têm permissões apropriadas.

Práticas recomendadas

Considere o seguinte quando você trabalha com recursos de aplicativo do Databricks:

• Use variáveis de ambiente e o SDK do Azure Databricks para resolver a URL do aplicativo de destino em tempo de execução, em vez de hardcoding URLs, garantindo que seu aplicativo permaneça portátil entre ambientes.
• Implemente o tratamento de erros para casos em que o aplicativo de destino não está disponível ou retorna erros.
• Monitore a integridade e a disponibilidade dos aplicativos de destino, especialmente se o aplicativo depender deles para funcionalidade crítica.