Usando o Lakebase com aplicativos do Databricks

Os Aplicativos do Databricks permitem que você crie e execute aplicativos interativos diretamente em seu workspace. Quando você adiciona Lakebase como um recurso, o Databricks manipula toda a cadeia de autenticação: um principal de serviço é criado para seu aplicativo, ele recebe uma função Postgres correspondente, e os detalhes da conexão são configurados como variáveis de ambiente. Seu aplicativo se conecta a um banco de dados Postgres totalmente gerenciado sem gerenciar credenciais ou cadeias de conexão.

Este guia orienta você pela implantação de um aplicativo de modelo conectado a um banco de dados do Lakebase. No final, você terá um aplicativo em execução com dados que poderá inspecionar e consultar diretamente do Lakebase e, opcionalmente, registrar-se no Catálogo do Unity junto com seus dados do lakehouse.

Etapa 1: Provisionar uma instância do Lakebase

Um projeto do Lakebase é uma instância gerenciada do Postgres à qual seu aplicativo se conecta como um recurso. Os projetos são organizados em branches, cada um representando um ambiente de banco de dados isolado.

Antes de criar seu projeto, verifique se o workspace tem a computação sem servidor habilitada. Se você não conseguir fazer essa alteração por conta própria, entre em contato com seu administrador.

Para criar um projeto: O comutador de aplicativo → Lakebase → Autoscaling → Criar projeto → aceitar padrões

Seu projeto é criado com um production branch e um banco de databricks_postgres dados.

Etapa 2: Criar um aplicativo do Databricks com base no modelo

Os modelos lidam com a complexidade da infraestrutura para você: o pool de conexões, a atualização do token OAuth e o tratamento de erros já estão integrados. Se você precisar de um aplicativo totalmente personalizado, consulte Escrever o seu próprio.

Três modelos de aplicativo de dimensionamento automático todo para Lakebase estão disponíveis: Dash, Flask e Streamlit. Navegue até Novo > Aplicativo para abrir a interface de criação do aplicativo e selecione seu modelo preferencial na guia Banco de Dados .

Etapa 3: Configurar o recurso de banco de dados

Adicionar o Lakebase como um recurso faz duas coisas: cria uma entidade de serviço com as permissões de banco de dados corretas e injeta os detalhes da sua conexão como variáveis de ambiente no aplicativo. Isso é o que permite que o modelo se conecte ao banco de dados automaticamente, sem nenhuma cadeia de conexão em seu código.

Na etapa Configurar, selecione o banco de dados e o tamanho da computação para seu aplicativo. Para obter informações detalhadas sobre como adicionar recursos de banco de dados, consulte Adicionar um recurso do Lakebase a um aplicativo do Databricks.

Em recursos de aplicativo, selecione seu projeto, branch e banco de dados do Lakebase. Os nomes de ramificação são exibidos como IDs: se você aceitou as padronizações na Etapa 1, terá apenas uma ramificação (produção) para escolher. Para outros projetos ou para corresponder IDs a nomes, consulte a página de ramificações do projeto.

Em tamanho de computação, para este guia, estamos selecionando Média. Observe que essa é a computação do servidor de aplicativos, separada da computação do banco de dados lakebase , que é dimensionada de forma independente.

Etapa 4: Examinar autorizações

Cada aplicativo do Databricks é executado como seu próprio principal de serviço, uma identidade dedicada separada de qualquer usuário individual. Quando você conecta o Lakebase como um recurso, o Databricks cria automaticamente uma função de Postgres correspondente para essa entidade de serviço e concede à entidade de serviço do aplicativo o acesso de banco de dados necessário para se conectar, criar seu próprio esquema e ler e gravar dados, sem a necessidade de instalação de função manual.

A autorização do usuário (versão prévia) permite que seu aplicativo aja em nome do usuário conectado em vez de sua própria entidade de serviço, o que é útil quando diferentes usuários devem ver dados diferentes com base em suas permissões individuais. Para este modelo, não são necessários escopos de usuário adicionais. Para habilitar o acesso em nome de um usuário posteriormente, consulte Autorização de Usuário.

Etapa 5: Nomear seu aplicativo e instalar

O nome do aplicativo escolhido aqui se torna parte do nome do esquema que o Lakebase cria automaticamente em seu banco de dados. A ID do cliente é a entidade de serviço atribuída ao seu aplicativo, com hifens removidos. Você pode renomear o esquema posteriormente no Lakebase, mas o nome do aplicativo em si não pode ser alterado após a criação. O modelo usa lakebase-autoscaling-appcomo padrão .

App name:           lakebase-autoscaling-app

Service principal:  aeb6ff91-98ff-4752-af7d-fc6d4cf570d0

                                    ↓
                          (same ID, hyphens removed)

Schema name:        lakebase-autoscaling-app_schema_aeb6ff9198ff4752af7dfc6d4cf570d

Confirme ou altere o nome do aplicativo, examine a descrição pré-preenchida e, opcionalmente, defina uma política de uso sem servidor. Clique em Instalar para criar a configuração do aplicativo.

Etapa 6: Implantar o aplicativo

Depois de clicar em Instalar, a computação será iniciada automaticamente e seu aplicativo será implantado sem nenhuma ação adicional. Isso leva de 2 a 3 minutos. Quando o status do aplicativo mostrar Em execução, clique na URL ao lado dele para abrir seu aplicativo. Para obter o fluxo de trabalho de desenvolvimento completo, incluindo desenvolvimento local e reimplantação, consulte Desenvolver aplicativos do Databricks.

Use o botão Implantar para reimplantar depois de fazer alterações de código. Se uma implantação falhar, verifique a guia Implantações . A etapa que falhou (por exemplo, "Pacotes instalados" ou "Aplicativo iniciado") informa onde procurar.

Etapa 7: Verificar a integração

Abra seu aplicativo no endereço fornecido e adicione algumas tarefas. Em seu projeto do Lakebase, abra Tabelas e selecione a tabela todos no esquema do aplicativo. Suas linhas estão lá, escritas pelo principal de serviço do aplicativo, usando os detalhes de conexão injetados da Etapa 3.

Para executar consultas personalizadas nos dados, use o Editor de SQL em seu projeto do Lakebase. Lakebase escala para zero após um período de inatividade; portanto, quando você acessar novamente, pode perceber que a primeira solicitação leva alguns segundos enquanto o banco de dados inicializa. Para outras opções de conexão, consulte Conectar-se ao seu projeto do Lakebase.

Etapa 8: Consultar por meio do Catálogo do Unity (opcional)

Por padrão, os dados do Lakebase do aplicativo são acessíveis diretamente por meio de conexões do Postgres. Registrar no Unity Catalog torna-o consultável junto com os seus dados de lakehouse usando o Databricks SQL padrão, permitindo a realização de junções entre as tabelas transacionais do aplicativo e tabelas Delta na mesma consulta.

Para se registrar, abra o Gerenciador de Catálogos e crie um novo catálogo. Selecione Lakebase Postgres como o tipo de catálogo, escolha Autoescalonamento e selecione o mesmo projeto e ramo que seu aplicativo. Consulte Registrar seu banco de dados no Catálogo do Unity para obter detalhes completos.

Uma vez registrado, observe que, no Catálogo do Unity, os nomes de esquema preservam os hífens do nome do aplicativo. Os nomes de catálogo e de esquema exigem aspas de crase (backtick).

SELECT * FROM `your-catalog-name`.`lakebase-autoscaling-app_schema_aeb6ff9198ff4752af7dfc6d4cf570d`.todos;

Saiba mais

• Introdução aos Aplicativos do Databricks
• Desenvolver aplicativos do Databricks
• Conectar-se ao banco de dados