Visão geral
O que é o Databricks Apps?
O Databricks Apps hospeda seu aplicativo web dentro do seu workspace. Ele ganha uma URL fixa, OAuth integrado e acesso direto aos dados e serviços do seu workspace. Sem serviço de hospedagem à parte, sem camada de autenticação para desenvolver, sem rotação de credenciais para gerenciar.
O AppKit é o SDK TypeScript para criar esses aplicativos. Ele oferece componentes de interface React prontos, acesso a dados com tipagem segura e um sistema de plugins para conexão com os serviços do Databricks.
Como funciona
O AppKit usa uma arquitetura de três camadas com plugins que registram funcionalidades em cada camada:
- Client: frontend React servido pelo Vite. O pacote
@databricks/appkit-uifornece tabelas de dados, gráficos, diálogos e componentes de layout. - Server: servidor HTTP Express com OAuth do Databricks integrado. Os plugins registram rotas e middlewares nesta camada.
- Data: acesso baseado em plugins aos recursos do Databricks. Cada plugin encapsula um tipo de recurso e expõe uma API tipada no objeto
AppKit.
| Plugin | O que adiciona |
|---|---|
| server | Servidor HTTP Express, entrega de arquivos estáticos, modo de desenvolvimento do Vite (sempre incluído) |
| lakebase | Pool de conexões Postgres para o Lakebase Postgres com renovação automática de token OAuth |
| analytics | Execução de consultas SQL em SQL warehouses do Databricks. Consulte Leituras analíticas. |
| genie | Integração com o Genie Agent para consultas de dados em linguagem natural |
| serving | Proxy autenticado para endpoints do Model Serving com suporte a streaming |
| files | Operações com arquivos em Volumes do Unity Catalog |
| agents | Agentes de IA definidos em markdown ou código, com descoberta automática de ferramentas |
| ai-search | Busca semântica e vetorial nos seus índices do AI Search |
| jobs | Acione e monitore Databricks Lakeflow Jobs |
| caching | Cache de respostas global e por plugin, com suporte do Lakebase Postgres quando disponível |
Para ver o conjunto completo e atualizado de plugins, consulte a referência de plugins.
Como funciona a autenticação
Todo app recebe um service principal dedicado. O Databricks injeta as credenciais dele em tempo de execução, para que seu app possa chamar as APIs do workspace sem precisar gerenciar tokens.
Por padrão, todas as requisições são executadas como esse service principal, e todos os usuários compartilham as permissões dele. Quando você precisar de acesso a dados por usuário, o Databricks pode encaminhar o token do usuário autenticado por meio do cabeçalho x-forwarded-access-token. Os plugins integrados do AppKit para Genie e Model Serving cuidam disso automaticamente.
Quando usar
Apps são sobre interatividade, não apenas análise de dados. Um dashboard é ótimo para visualizações somente leitura com filtros predefinidos. Um app faz isso e mais: aceita entradas, executa lógica e persiste resultados. Crie um app quando seu fluxo de trabalho exigir alguma dessas capacidades — por exemplo, um construtor de cenários que salva casos criados pelo usuário ou uma ferramenta interna que substitui um processo manual em planilha.
Quando não usar
- Sites estáticos sem acesso a dados do Databricks. Hospede-os em qualquer lugar.
- Aplicativos públicos ou voltados ao cliente. Por padrão, os usuários precisam ser identidades autenticadas na sua conta Databricks (não precisam pertencer ao workspace do aplicativo). Para acesso externo ou voltado ao cliente, consulte App Users.
- Dashboards apenas de leitura que os Dashboards de AI/BI já cobrem. Use um dashboard até precisar persistir entradas do usuário ou executar lógica personalizada sobre elas.
Próximos passos
Os Templates são prompts prontos para agentes, organizados por caso de uso. Encontre o que melhor se encaixa no seu cenário ou consulte o Guia rápido de Apps para ver um passo a passo detalhado.