Partilhar via

Adicionar um recurso do Lakebase a um aplicativo Databricks

Adicione instâncias de banco de dados Lakebase como recursos do Databricks Apps para persistir dados em implantações. Esses recursos apoiados pelo PostgreSQL permitem que seu aplicativo crie e gerencie esquemas e tabelas que retenham o estado.

Importante

As instâncias do banco de dados Lakebase estão em Visualização pública. O administrador do espaço de trabalho deve habilitá-los antes que você possa adicioná-los como um recurso do aplicativo.

Adicionar um recurso de banco de dados

Antes de adicionar uma instância de base de dados Lakebase como recurso, reveja os pré-requisitos de recursos da aplicação.

  1. Quando criar ou editar uma aplicação, navegue até ao passo Configurar .
  2. Na secção de recursos da App , clique em + Adicionar recurso.
  3. Selecione Banco de dados como o tipo de recurso.
  4. Escolha uma instância de banco de dados.
  5. Escolha um banco de dados dentro dessa instância.
  6. Selecione o nível de permissão apropriado para seu aplicativo. Atualmente, a única permissão disponível é Pode se conectar e criar.
  7. (Opcional) Especifique uma chave de recurso personalizada, que é como você referencia o banco de dados na configuração do seu aplicativo. A chave padrão é database.

Quando você adiciona um recurso de banco de dados:

  • O Azure Databricks cria uma função PostgreSQL na instância de banco de dados selecionada. O nome da função corresponde ao ID do cliente da principal do serviço. Se a função já existir, o Azure Databricks a reutiliza.
  • O Azure Databricks atribui à entidade de serviço CONNECT e CREATE privilégios no banco de dados selecionado. Esses privilégios permitem que o aplicativo crie esquemas e tabelas no banco de dados.

Variáveis de ambiente

Quando você implanta um aplicativo com um recurso de banco de dados, o Azure Databricks define as seguintes variáveis de ambiente para o primeiro recurso de banco de dados.

Se seu aplicativo usa vários bancos de dados, essas variáveis refletem apenas o primeiro. Use valueFrom com a chave de recurso para recuperar o nome do host do banco de dados. Consulte Usar variáveis de ambiente para acessar recursos.

Variável Descrição
PGAPPNAME Nome do aplicativo
PGDATABASE Nome da base de dados
PGHOST Nome do host do servidor PostgreSQL
PGPORT Porta para o servidor PostgreSQL
PGSSLMODE Modo SSL para a conexão
PGUSER ID do cliente e nome da função do principal de serviço

Remover um recurso de banco de dados

Se você remover recursos de banco de dados de um aplicativo, o aplicativo tentará reatribuir todos os objetos de propriedade da entidade de serviço ao usuário que remove o recurso.

A lógica que o aplicativo usa depende principalmente se você tem uma função na instância do banco de dados:

As suas permissões Função na instância do banco de dados? Resultado
CAN MANAGE Sim O Azure Databricks reatribui todos os objetos pertencentes à entidade de serviço a você e exclui a função da entidade de serviço.
CAN MANAGE Não O Azure Databricks cria uma função para você, reatribui todos os objetos pertencentes à função da entidade de serviço a você e exclui a função da entidade de serviço.
Não CAN MANAGE N/A O Azure Databricks remove o recurso, mas não exclui a função nem reatribui a propriedade. Um aviso aparece na interface do usuário e você deve limpar manualmente a função e os objetos de propriedade posteriormente.

Observações

Considere o seguinte ao adicionar bancos de dados como recursos do aplicativo:

  • Se você revogar CONNECT e CREATE de um banco de dados e concedê-los em outro na mesma atualização, o Azure Databricks atualizará os privilégios, mas não recriará a função da entidade de serviço.
  • Os bancos de dados persistem o estado. Todos os esquemas ou tabelas criados por um aplicativo permanecem mesmo depois que você reimplanta ou interrompe o aplicativo.
  • Last updated on