Perguntas frequentes
Perguntas frequentes
Integrações
Quais serviços do Databricks estão disponíveis por meio do AppKit?
O AppKit oferece integrações nativas com os seguintes serviços do Databricks por meio de seu sistema de plugins:
| Plugin | Serviço do Databricks | O que faz |
|---|---|---|
| Analytics | SQL Warehouses | Executa queries SQL parametrizadas com cache, retentativas e suporte a Arrow integrados |
| Lakebase | Lakebase Autoscaling (PostgreSQL) | Acesso a banco de dados relacional via pg.Pool padrão com refresh automático do OAuth token |
| Genie | AI/BI Genie Spaces | Queries de dados em linguagem natural com gerenciamento de conversas e streaming |
| Files | Volumes do Unity Catalog | Operações de arquivos em múltiplos volumes (listar, ler, enviar, baixar, excluir e pré-visualizar) |
| Model Serving | Model Serving | Proxy autenticado para Model Serving endpoints com suporte a invocação e streaming |
| Server | N/A | Servidor HTTP Express com entrega de arquivos estáticos, modo de desenvolvimento Vite e injeção de rotas de plugins |
Fique de olho nos novos plugins, pois estamos sempre ampliando as integrações!
Posso adicionar integrações personalizadas?
Sim. A arquitetura de plugins do AppKit é extensível — você pode criar plugins personalizados pela CLI (npx appkit plugin create) ou manualmente. Consulte o guia de criação de plugins personalizados.
Autenticação
Como funciona a autenticação em apps AppKit?
Os apps AppKit são projetados para executar no Databricks Apps, que cuida da autenticação e da autorização dos usuários. O Databricks Apps encaminha a identidade do usuário ao app por meio de cabeçalhos de requisição, e o AppKit se integra a esse mecanismo pelo padrão .asUser(req) para execução em nome do usuário (on-behalf-of, OBO) — permitindo que os plugins atuem em nome do usuário autenticado.
Para detalhes sobre o funcionamento da autenticação e da autorização no Databricks Apps, consulte a documentação oficial de autenticação.
Bancos de dados
Veja também: Lakebase, PostgreSQL, OLTP
Como o AppKit lida com bancos de dados?
O AppKit é um SDK TypeScript (Express + React) e não gerencia bancos de dados diretamente.
Para adicionar suporte a banco de dados, use o plugin do Lakebase, que se integra ao Lakebase Autoscaling.
O AppKit também usa o Lakebase para cache quando ele está disponível (consulte a seção cache abaixo).
Você pode gerenciar projetos e branches do Lakebase Autoscaling com a agent skill dedicada das Databricks Agent Skills, instalada por meio da Databricks CLI.
Como funcionam a configuração do banco de dados e o gerenciamento de permissões no AppKit?
Os apps AppKit podem ter uma instância do Lakebase Autoscaling anexada. Nenhum banco de dados vem incluído por padrão — você adiciona um configurando o plugin do Lakebase. Ao executar databricks apps init e selecionar o plugin do Lakebase, o banco de dados escolhido é anexado automaticamente como recurso do app após o deployment.
Com o desenvolvimento assistido por IA, você também pode pedir ao Agent que crie um projeto e uma branch do Lakebase para você.
Depois do deploy, o app do Databricks usa seu Service Principal para criar schemas e tabelas. Se você configurar o projeto do Lakebase Autoscaling como recurso do app, as permissões necessárias de conexão e criação são concedidas automaticamente ao Service Principal do app.
O AppKit oferece suporte ao Lakebase Provisioned?
Não. O AppKit oferece suporte apenas ao Lakebase Autoscaling. Bancos de dados Lakebase Provisioned não têm suporte no plugin do Lakebase nem na agent skill do Lakebase disponível em Databricks Agent Skills.
Cache
O AppKit oferece suporte a cache?
Sim. O Analytics plugin — usado para executar queries SQL em SQL Warehouses do Databricks — oferece suporte a uma camada opcional de cache.
O cache é configurado por plugin e pode usar o Lakebase Autoscaling ou um armazenamento em memória, dependendo da configuração.
Se a conexão com o Lakebase Autoscaling estiver configurada, o app baseado em AppKit cria um schema appkit no banco de dados configurado, com as tabelas internas necessárias para o cache.