Arquitetura

O AppKit segue uma arquitetura baseada em plugins, projetada para criar aplicações Databricks prontas para produção. Este documento apresenta uma visão geral dos componentes do sistema e de suas interações.

Arquitetura de alto nível

Componentes principais

O AppKit está organizado em dois pacotes principais:

@databricks/appkit

O SDK de backend que fornece a arquitetura de plugins e as funcionalidades principais. Ele inclui:

Sistema de plugins com gerenciamento de ciclo de vida
Plugins integrados de servidor e de analytics
Recursos de telemetria e observabilidade
Gerenciamento de cache e recursos de streaming
Geração de tipos para queries SQL

Consulte a documentação de Plugins e a referência da API para mais detalhes.

@databricks/appkit-ui

Uma biblioteca de UI em React com componentes prontos, otimizados para aplicações de dados:

Hooks do React para execução de queries e streaming
Componentes de UI baseados em Radix UI e Tailwind
Componentes de visualização de dados
Integração type-safe com queries do backend

Consulte a referência da API para ver a documentação dos componentes.

Camadas da aplicação

Camada de cliente

A camada de frontend em React que, opcionalmente, utiliza os componentes do @databricks/appkit-ui:

Renderiza componentes de UI e visualizações
Gerencia o estado do cliente e as interações do usuário
Consome APIs do backend via HTTP e SSE
Fornece hooks de execução de query com tipagem segura

Camada de servidor

A camada de backend em Node.js criada com @databricks/appkit:

Serve a aplicação React (modos de desenvolvimento e produção)
Executa queries SQL em SQL Warehouses do Databricks
Cuida da autenticação e da autorização
Fornece cache, lógica de retentativa e tratamento de erros
Expõe APIs REST e endpoints SSE

Camada de dados

Integração com os serviços do Databricks:

SQL Warehouses: executam queries analíticas no formato Arrow ou JSON
Lakebase Autoscaling: acesso a banco de dados OLTP com refresh automático do OAuth token

Veja também

Plugins: Aprofunde-se no sistema de plugins
Referência da API: Documentação completa da API
Desenvolvimento: Explore os workflows de desenvolvimento
Princípios fundamentais: Conheça a filosofia de design do AppKit