Adicionar um recurso do Lakebase a um aplicativo Databricks

Adicione bancos de dados Lakebase como recursos Databricks Apps para persistir dados entre implantações. Esses recursos com suporte do PostgreSQL permitem que seu aplicativo crie e gerencie esquemas e tabelas que retêm o estado.

Os seguintes tipos de recursos de banco de dados Lakebase estão disponíveis:

• Lakebase autoscale : Organiza recursos como projetos contendo branches e bancos de dados.

Ambos os tipos utilizam o mesmo modelo de conexão PostgreSQL e fornecem a mesma variável de ambiente para sua aplicação.

Adicionar um recurso de banco de dados

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

1. Na seção Recursos do aplicativo, ao criar ou editar um aplicativo, clique em + Adicionar recurso > Banco de dados .
2. Escolha um banco de dados. Para o dimensionamento automático Lakebase , selecione um projeto, uma ramificação e um banco de dados. Para provisionamento Lakebase , selecione uma instância de banco de dados e um banco de dados dentro dessa instância.
3. Selecione o nível de permissão apropriado para seu aplicativo. Atualmente, a única permissão disponível é Pode se conectar e criar .
4. (Opcional) Especifique uma key de recurso personalizada, que é como você referencia o banco de dados na configuração do seu aplicativo. A key default é postgres para o dimensionamento automático Lakebase e database para o provisionamento Lakebase .

Você precisa ter permissão CAN MANAGE no projeto Lakebase para adicioná-lo como um recurso do aplicativo.

Quando o senhor adiciona um recurso de banco de dados:

• O Databricks cria uma função PostgreSQL no banco de dados selecionado. O nome da função corresponde ao ID do cliente da entidade de serviço . Se a função já existir, o Databricks a reutiliza.
• 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.
• Para o dimensionamento automático do Lakebase, o usuário que adiciona o recurso deve ter permissão CAN MANAGE no projeto.

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 PostgreSQL, essas variáveis refletem apenas o primeiro. Use valueFrom com a key de recurso para recuperar os detalhes de conexão do banco de dados. Consulte Usar variável de ambiente para acessar 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 utilizada pelo aplicativo depende principalmente de você ter ou não uma função no banco de dados:

Suas permissões	Qual é o seu papel no 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	O Databricks cria uma função para você, reatribui todos os objetos pertencentes à função da entidade de serviço para você 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.