SQL Referência de PRAGMAs

Um PRAGMA é um comando do SQLite para consultar ou mudar um ajuste do próprio banco: ver as colunas de uma tabela, ligar as chaves estrangeiras, conferir se o arquivo está íntegro, saber o tamanho da página. Ao contrário dos comandos de ponto, ele é SQL (termina com ; e roda no editor, no PHP, no Python), mas é SQL só do SQLite: os outros bancos têm ajustes parecidos com outros nomes. Esta página lista os PRAGMAs mais úteis do SQLite 3.50.4, com a saída real em dois lugares: o editor do guia, que usa um banco em memória, e o terminal da Ana, com o arquivo loja.db. A aula que ensina os principais com calma é PRAGMAs Úteis.

Editor (memória) × terminal (arquivo)

No editor do guia, cada Rodar cria um banco novo, em memória, e carrega a Loja Aurora com PRAGMA foreign_keys = ON; no começo. No terminal, a Ana abre o arquivo loja.db com sqlite3 loja.db (aula O Terminal do SQLite). Por isso alguns PRAGMAs dão respostas diferentes nos dois lugares:

Os PRAGMAs marcados "só com arquivo" nas tabelas abaixo rodam no editor, mas só fazem sentido no terminal (ou num programa) com um arquivo de verdade, porque o banco do editor some a cada Rodar.

Ver a estrutura das tabelas

Todos funcionam igual no editor e no terminal. Aqui, o table_info rodando de verdade no banco da loja:

PRAGMA table_info(produtos);

Repare na coluna dflt_value: estoque e descontinuado têm o valor padrão 0 (aula DEFAULT); nas outras, NULL quer dizer "sem padrão". No terminal, com .headers on (aula Comandos de Ponto), a saída é a mesma, só que o NULL aparece vazio:

sqlite> .headers on
sqlite> PRAGMA table_info(categorias);
cid|name|type|notnull|dflt_value|pk
0|id|INTEGER|0||1
1|nome|TEXT|1||0
2|descricao|TEXT|0||0
sqlite> .mode box
sqlite> PRAGMA foreign_key_list(produtos);
┌────┬─────┬──────────────┬───────────────┬────┬───────────┬───────────┬───────┐
│ id │ seq │    table     │     from      │ to │ on_update │ on_delete │ match │
├────┼─────┼──────────────┼───────────────┼────┼───────────┼───────────┼───────┤
│ 0  │ 0   │ fornecedores │ fornecedor_id │ id │ NO ACTION │ NO ACTION │ NONE  │
│ 1  │ 0   │ categorias   │ categoria_id  │ id │ NO ACTION │ NO ACTION │ NONE  │
└────┴─────┴──────────────┴───────────────┴────┴───────────┴───────────┴───────┘

Como tabela: pragma_table_info

Na forma de tabela, dá para filtrar e contar. Quantas colunas tem cada tabela da loja?

SELECT m.name AS tabela, COUNT(*) AS colunas
FROM sqlite_schema AS m, pragma_table_info(m.name)
WHERE m.type = 'table'
GROUP BY m.name;

A sqlite_schema é a tabela interna onde o SQLite guarda a lista das tabelas; para cada uma, o pragma_table_info(m.name) devolve as colunas, e o GROUP BY conta.

PRAGMA table_info(pedidos);

Chaves estrangeiras e verificação

No editor, as chaves estão ligadas: apagar a Papelaria, que tem produtos, dá erro.

DELETE FROM categorias WHERE id = 1;

Desligando as chaves antes, o DELETE passa, e o foreign_key_check mostra o estrago: seis produtos apontando para uma categoria que não existe mais.

PRAGMA foreign_keys = OFF;
DELETE FROM categorias WHERE id = 1;
PRAGMA foreign_key_check;

No terminal é o contrário: cada vez que a Ana abre o loja.db, as chaves começam desligadas, e ela precisa ligar de novo em toda sessão.

$ sqlite3 loja.db
SQLite version 3.50.4 2025-07-30 19:33:53
Enter ".help" for usage hints.
sqlite> PRAGMA foreign_keys;
0
sqlite> PRAGMA foreign_keys = ON;
sqlite> PRAGMA foreign_keys;
1
sqlite> .quit
$ sqlite3 loja.db "PRAGMA foreign_keys;"
0                                  « nova conexão: desligada de novo

O arquivo do banco (só com arquivo)

Estes PRAGMAs falam do arquivo .db: como ele grava, de que tamanho são as páginas, quanto espaço sobra. No editor eles respondem (com os valores de um banco em memória), mas só fazem sentido no terminal ou num programa que abre um arquivo.

Página × tamanho do arquivo

O arquivo é feito de páginas do mesmo tamanho. Multiplicando um pelo outro, sai o tamanho do arquivo: 4096 × 11 = 45056 bytes, o mesmo que o ls -l mostra.

$ sqlite3 loja.db
SQLite version 3.50.4 2025-07-30 19:33:53
Enter ".help" for usage hints.
sqlite> PRAGMA database_list;
0|main|/home/ana/loja.db
sqlite> PRAGMA page_size;
4096
sqlite> PRAGMA page_count;
11
sqlite> PRAGMA freelist_count;
0
sqlite> PRAGMA integrity_check;
ok
sqlite> .quit
$ ls -l loja.db
-rw-r--r-- 1 ana ana 45056 out 18 11:14 loja.db

O que fica gravado no arquivo

O user_version e o journal_mode = WAL continuam valendo depois de fechar e abrir o banco:

$ sqlite3 loja.db
SQLite version 3.50.4 2025-07-30 19:33:53
Enter ".help" for usage hints.
sqlite> PRAGMA user_version;
0
sqlite> PRAGMA user_version = 3;
sqlite> .quit
$ sqlite3 loja.db "PRAGMA user_version;"
3                                  « continuou 3: está no arquivo
$ sqlite3 loja.db "PRAGMA user_version = 0;"
$ sqlite3 loja.db
SQLite version 3.50.4 2025-07-30 19:33:53
Enter ".help" for usage hints.
sqlite> PRAGMA journal_mode;
delete
sqlite> PRAGMA journal_mode = WAL;
wal
sqlite> .quit
$ sqlite3 loja.db "PRAGMA journal_mode;"
wal                                « o modo WAL também ficou no arquivo
$ sqlite3 loja.db "PRAGMA journal_mode = DELETE;"
delete

Repare: PRAGMA journal_mode = WAL; responde com o modo que ficou valendo (wal), enquanto PRAGMA user_version = 3; não responde nada. No editor, o mesmo journal_mode = WAL responde memory: um banco em memória não tem para onde mudar.

A conexão: ajustes que valem até fechar

Um exemplo no editor: com case_sensitive_like ligado, 'ana%' com a minúsculo não acha mais "Ana Beatriz" nem "Ana Carvalho".

PRAGMA case_sensitive_like = ON;
SELECT COUNT(*) AS anas FROM clientes WHERE nome LIKE 'ana%';

Informações sobre o próprio SQLite

Estes não mexem em nada; respondem "o que este SQLite sabe fazer". Os números mudam entre o editor e o terminal, porque os dois foram compilados com opções diferentes, e o programa sqlite3 traz extensões a mais (como generate_series, que não existe no editor).

Para contar você mesmo, use a forma de tabela: SELECT COUNT(*) FROM pragma_function_list;. Rode no editor e compare com a tabela acima.

Quando dá errado

sqlite> PRAGMA foreing_keys;
sqlite> PRAGMA table_info(produto);
sqlite>

BEGIN;
PRAGMA foreign_keys = OFF;
PRAGMA foreign_keys;
COMMIT;

sqlite> PRAGMA encoding;
UTF-8
sqlite> SELECT * FROM pragma_encoding;
UTF-8

Missão: as colunas que aceitam NULL

SELECT name
FROM pragma_table_info('clientes');

SELECT name
FROM pragma_table_info('clientes')
WHERE "notnull" = 0;

Resumo

• PRAGMA nome; lê um ajuste; PRAGMA nome = valor; muda. A forma SELECT … FROM pragma_nome(…) deixa filtrar o resultado.
• Estrutura: table_info, table_list, index_list, index_info, foreign_key_list. Funcionam igual no editor e no terminal.
• foreign_keys vale por conexão: ligado no editor, desligado em cada sqlite3 loja.db. foreign_key_check e integrity_check conferem o banco.
• journal_mode, page_size, page_count, auto_vacuum, user_version: só fazem sentido com arquivo. user_version e o modo WAL ficam gravados nele.
• Nome errado não dá erro: o PRAGMA é ignorado. Mudar foreign_keys dentro de uma transação também.
• PRAGMA é só do SQLite; nos outros bancos, procure o INFORMATION_SCHEMA.