Recursos Modernos do SQLite Que Você Pode Estar Ignorando

Se você ainda pensa no SQLite como um banco de dados leve adequado apenas para aplicações móveis ou protótipos rápidos, você perdeu alguns anos de desenvolvimento significativo. O SQLite é mantido ativamente, oferece recursos que rivalizam com bancos de dados mais robustos para diversas cargas de trabalho e agora roda diretamente no navegador. Aqui está o que vale a pena saber.

Suporte a JSON e JSONB: Mais do Que Apenas Armazenamento de Texto

O SQLite possui funções JSON há anos, mas uma adição mais recente é o suporte a JSONB, um formato binário que armazena documentos de forma mais compacta e os processa mais rapidamente que JSON em texto puro.

Quando você usa jsonb() para armazenar dados, o SQLite evita reanalisar o texto a cada leitura. Para cargas de trabalho com leitura intensiva e payloads JSON grandes, isso faz diferença.

CREATE TABLE events (
  id      INTEGER PRIMARY KEY,
  payload BLOB NOT NULL  -- store as JSONB
);

-- Insert using jsonb()
INSERT INTO events (payload)
VALUES (jsonb('{"user": {"id": 42}, "action": "login"}'));

-- Query with standard json_extract — works on JSONB columns too
SELECT json_extract(payload, '$.user.id') AS user_id
FROM events
WHERE json_extract(payload, '$.action') = 'login';

As funções JSON do SQLite aceitam tanto valores em texto JSON quanto JSONB de forma transparente, então você pode continuar usando funções como json_extract() independentemente do formato de armazenamento.

Você também pode indexar expressões JSON diretamente, o que torna a filtragem em campos aninhados rápida sem precisar desnormalizar seu schema:

CREATE INDEX idx_action ON events (json_extract(payload, '$.action'));

Quando usar JSONB vs TEXT: Use BLOB + jsonb() quando o SQLite precisar processar ou consultar o valor JSON com frequência. Use TEXT quando precisar preservar a string bruta exatamente como inserida.

⚠️ Nota sobre versão: O suporte a JSONB foi introduzido no SQLite 3.45 (janeiro de 2024). Confirme a versão do seu runtime antes de utilizá-lo.

Tabelas STRICT do SQLite: Aplicação Real de Tipos

A tipagem flexível do SQLite é útil, mas pode introduzir bugs sutis quando uma coluna aceita silenciosamente o tipo errado. Tabelas STRICT corrigem isso ao impor tipos de coluna no momento da inserção, de forma similar ao comportamento do PostgreSQL.

CREATE TABLE users (
  id        INTEGER PRIMARY KEY,
  email     TEXT    NOT NULL,
  age       INTEGER NOT NULL
) STRICT;

Tente inserir 'twenty-five' em age e o SQLite irá rejeitar. Tabelas STRICT suportam cinco tipos de coluna permitidos: INT, INTEGER, REAL, TEXT, BLOB, além do tipo especial ANY. O tipo ANY faz com que aquela coluna retorne ao comportamento flexível normal do SQLite, permitindo que você misture colunas estritas e flexíveis na mesma tabela.

⚠️ Verifique sua versão primeiro: Tabelas STRICT exigem SQLite 3.37 ou superior. Execute SELECT sqlite_version(); para confirmar.

A Cláusula RETURNING: Consultas de Mutação Mais Limpas

Se você já inseriu uma linha e imediatamente fez uma consulta para obter o ID gerado, o RETURNING elimina essa ida e volta:

INSERT INTO orders (user_id, total)
VALUES (42, 99.99)
RETURNING id, created_at;

Funciona em INSERT, UPDATE e DELETE, e é especialmente útil em JavaScript no servidor com bibliotecas como better-sqlite3 ou o SQLite integrado do Bun. O RETURNING foi adicionado no SQLite 3.35.

SQLite WASM: Executando o SQLite Diretamente no Navegador

O projeto SQLite disponibiliza um build oficial em WebAssembly que executa o motor SQLite completo em uma aba do navegador. Diferentemente do sql.js, que o antecede, o build oficial do SQLite WASM oferece suporte à API Origin Private File System (OPFS) para armazenamento persistente baseado em arquivos, o que significa que seu banco de dados sobrevive a recargas de página sem a necessidade de um servidor.

Isso abre uma arquitetura real para desenvolvimento frontend com SQLite:

• Aplicações offline-first que consultam localmente e sincronizam depois
• Ferramentas de análise ou relatórios no lado do cliente
• Aplicações Electron e Tauri que desejam uma única abstração de banco de dados entre ambientes
• Ferramentas de desenvolvimento baseadas em navegador com capacidade real de consultas

A OPFS é documentada pelo MDN como parte da File System API, e o guia do web.dev do Google afirma que ela é suportada em todos os principais navegadores. Algumas configurações de SQLite WASM com OPFS também exigem um contexto seguro (HTTPS), suporte a SharedArrayBuffer e cabeçalhos COOP/COEP apropriados, dependendo da implementação de VFS escolhida.

Modo WAL: Melhor Concorrência Sem Sobrecarga de Configuração

O write-ahead logging permite que leitores e escritores trabalhem simultaneamente sem se bloquear mutuamente. Para aplicações com leituras e escritas concorrentes, ou onde a latência percebida é importante, o modo WAL geralmente vale a pena ser ativado:

PRAGMA journal_mode = WAL;

Esse único pragma pode melhorar significativamente o desempenho para aplicações local-first, aplicações Electron e serviços de backend leves onde o SQLite lida com tráfego real. Observe que o modo WAL exige que o arquivo do banco de dados resida em disco local, pois não funciona de forma confiável em sistemas de arquivos em rede.

Conclusão

Recursos modernos do SQLite como JSONB, tabelas STRICT, RETURNING, WASM com OPFS e modo WAL, em conjunto, tornam o SQLite uma escolha credível para uma variedade muito mais ampla de aplicações do que sua reputação sugere. O projeto está em desenvolvimento ativo, e a diferença entre o SQLite e bancos de dados mais robustos diminuiu consideravelmente para cargas de trabalho que não exigem concorrência de múltiplos escritores em larga escala. Se você não revisitou recentemente o que o SQLite é capaz de fazer, agora é uma boa hora.

Perguntas Frequentes

Complete picture for complete understanding

Capture every clue your frontend is leaving so you can instantly get to the root cause of any issue with OpenReplay — the open-source session replay tool for developers. Self-host it in minutes, and have complete control over your customer data.

Check our GitHub repo and join the thousands of developers in our community.