Adicionar um recurso Lakebase a uma aplicação Databricks

Adicione bases de dados Lakebase como recursos Databricks Apps para persistir dados entre implementações. Esses recursos apoiados pelo PostgreSQL permitem que seu aplicativo crie e gerencie esquemas e tabelas que retenham o estado.

Estão disponíveis os seguintes tipos de recursos de base de dados Lakebase:

Ambos os tipos usam o mesmo modelo de ligação PostgreSQL e fornecem as mesmas variáveis de ambiente à sua aplicação.

Adicionar um recurso de banco de dados

Antes de adicionar uma base de dados Lakebase como recurso, revê os pré-requisitos de recursos da aplicação.

Observação

Não pode criar novas bases de dados provisionadas após 12 de março de 2026, mas pode adicionar as existentes como recursos da aplicação. Veja Autoscaling por padrão.

  1. Na secção de recursos da Aplicação, ao criar ou editar uma aplicação, clique em + Adicionar Base de Dados de Recursos>.
  2. Escolha uma base de dados. Para o Autoscaling do Lakebase, selecione um projeto, ramo e base de dados. Para o Lakebase Provisioned, selecione uma instância de base de dados e uma base 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 chave de recurso personalizada, que é como você referencia o banco de dados na configuração do seu aplicativo. A chave padrão é postgres para o Autoscaling do Lakebase e database para o Lakebase Provisioned.

Tens de ter CAN MANAGE permissão no projeto Lakebase para o adicionares como recurso de aplicação.

Quando você adiciona um recurso de banco de dados:

  • O Azure Databricks cria um papel PostgreSQL na base 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 reutiliza-a.
  • Azure Databricks concede privilégios ao principal de serviço CONNECT e CREATE na base de dados selecionada. Esses privilégios permitem que o aplicativo crie esquemas e tabelas no banco de dados.
  • Para o Autoscaling do Lakebase, o utilizador que adiciona o recurso deve ter CAN MANAGE permissão para o projeto.

Variáveis de ambiente

Quando implementa uma aplicação com um recurso de base de dados, o Azure Databricks define as seguintes variáveis de ambiente para o primeiro recurso de base de dados.

Se a tua aplicação usar várias bases de dados PostgreSQL, essas variáveis refletem apenas a primeira. Use valueFrom com a chave de recurso para obter os detalhes de ligação da base 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 a aplicação utiliza depende principalmente de ter ou não um papel na base de dados:

As suas permissões Papel na base de dados? Resultado
CAN MANAGE Sim O Azure Databricks reatribui-lhe todos os objetos pertencentes ao principal do serviço e elimina o papel do principal do serviço.
CAN MANAGE Não O Azure Databricks cria uma função para si, reatribui-lhe todos os objetos pertencentes à função do principal do serviço e elimina a função do principal do serviço.
Não CAN MANAGE N/A O Azure Databricks remove o recurso, mas não elimina o papel 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 revogares CONNECT e CREATE de uma base de dados e os concederes noutra na mesma atualização, Azure Databricks atualiza os privilégios mas não recria o papel do principal 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