Pular para o conteúdo principal
Última atualização em

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:

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. Ao criar ou editar um aplicativo, acesse Configurar o passo.
  2. Na seção Recurso do aplicativo , clique em + Adicionar recurso .
  3. Para o tipo de recurso, selecione Banco de Dados .
  4. Escolha um projeto, uma ramificação e um banco de dados.
  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 é postgres.

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.