Adicionar um recurso do Lakebase a um aplicativo Databricks

Adicione instâncias do banco de dados do Lakebase como recurso do Databricks Apps para manter os dados entre as implantações. Esses recursos com suporte do PostgreSQL permitem que seu aplicativo crie e gerencie esquemas e tabelas que retêm o estado.

info

Visualização

As instâncias do banco de dados Lakebase estão em versão prévia pública. O administrador do workspace deve habilitá-los antes que o senhor possa adicioná-los como um recurso de aplicativo.

Adicionar um recurso de banco de dados

Antes de adicionar uma instância do banco de dados do Lakebase como um recurso de aplicativo, verifique se o senhor atende aos pré-requisitos.

Siga os passos em Adicionar recurso a um aplicativo Databricks para adicionar um recurso de banco de dados.

1. Na seção Recurso do aplicativo , ao criar ou editar um aplicativo, clique em + Adicionar recurso .
2. Selecione Database (Banco de dados ) como o tipo de recurso.
3. Escolha uma instância de banco de dados.
4. Escolha um banco de dados dentro dessa instância.
5. Selecione o nível de permissão apropriado para seu aplicativo. Atualmente, a única permissão disponível é Pode se conectar e criar .
6. (Opcional) Especifique um recurso personalizado key, que é como o senhor faz referência ao banco de dados na configuração do aplicativo. O default key é database.

Quando o senhor adiciona um recurso de banco de dados:

• A Databricks cria uma função do PostgreSQL na instância do banco de dados selecionada. O nome da função corresponde ao ID do cliente da entidade de serviço. Se a função já existir, o Databricks a reutilizará.
• Databricks concede à 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ável de ambiente

Quando o senhor implanta um aplicativo com um recurso de banco de dados, o site Databricks define a seguinte variável 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 o recurso key para recuperar o nome do host do banco de dados. Consulte Usar variável de ambiente para acessar o recurso.

Variável	Descrição
PGAPPNAME	Nome do aplicativo
PGDATABASE	Nome do banco 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 da entidade de serviço

Remover um recurso de banco de dados

Se o senhor remover o recurso de banco de dados de um aplicativo, o aplicativo tentará reatribuir todos os objetos pertencentes à entidade de serviço ao usuário que estiver removendo o recurso.

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

Suas permissões	Função na instância do banco de dados?	Resultado
CAN MANAGE	Sim	A Databricks reatribui ao senhor todos os objetos pertencentes à entidade de serviço e exclui a função da entidade de serviço.
CAN MANAGE	Não	A Databricks cria uma função para o usuário, reatribui todos os objetos pertencentes à função da entidade de serviço para o usuário e exclui a função da entidade de serviço.
Não CAN MANAGE	N/A	O 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 pertencentes posteriormente.

Notas

Considere o seguinte ao adicionar bancos de dados como recurso de aplicativo:

• Se o senhor revogar CONNECT e CREATE de um banco de dados e concedê-los em outro na mesma atualização, o Databricks atualizará os privilégios, mas não recriará a função da entidade de serviço.
• O estado dos bancos de dados persiste. Todos os esquemas ou tabelas criados por um aplicativo permanecem mesmo depois que o senhor reimplantou ou interrompeu o aplicativo.