SQL Comandos de Ponto do sqlite3

Os comandos de ponto são os comandos que começam com . no programa sqlite3, o terminal do SQLite: .tables, .schema, .mode… Eles não são SQL: são ordens para o próprio programa, para mostrar o banco, mudar o jeito de exibir os resultados, ler e gravar arquivos. Esta página lista todos os do sqlite3 3.50.4, com a descrição original do .help traduzida e as saídas reais do terminal da Ana. A aula que ensina os principais é Comandos de Ponto.

Ver o banco

$ sqlite3 loja.db
SQLite version 3.50.4 2025-07-30 19:33:53
Enter ".help" for usage hints.
sqlite> .tables
categorias    fornecedores  itens_pedido  produtos
clientes      funcionarios  pedidos
sqlite> .tables c%
categorias  clientes
sqlite> .schema categorias
CREATE TABLE categorias (
    id        INTEGER PRIMARY KEY,
    nome      TEXT NOT NULL,
    descricao TEXT
);
sqlite> .indexes
sqlite_autoindex_itens_pedido_1
sqlite> .databases
main: /home/ana/loja.db r/w

O único índice do banco, sqlite_autoindex_itens_pedido_1, foi criado sozinho pelo SQLite para a chave primária composta de itens_pedido. O r/w do .databases quer dizer read/write, "leitura e escrita".

sqlite> .show
        echo: off
         eqp: off
     explain: auto
     headers: off
        mode: list
   nullvalue: ""
      output: stdout
colseparator: "|"
rowseparator: "\n"
       stats: off
       width:
    filename: loja.db

Mudar a exibição

sqlite> SELECT id, nome FROM categorias LIMIT 3;
1|Papelaria
2|Eletrônicos
3|Casa e Cozinha
sqlite> .headers on
sqlite> SELECT id, nome FROM categorias LIMIT 3;
id|nome
1|Papelaria
2|Eletrônicos
3|Casa e Cozinha
sqlite> .mode box
sqlite> .nullvalue (vazio)
sqlite> SELECT id, nome, email FROM clientes WHERE id IN (6, 7);
┌────┬───────────────────┬────────────────────────────────┐
│ id │       nome        │             email              │
├────┼───────────────────┼────────────────────────────────┤
│ 6  │ Rafael Monteiro   │ rafael.monteiro@exemplo.com.br │
│ 7  │ Luís Otávio Brito │ (vazio)                        │
└────┴───────────────────┴────────────────────────────────┘
sqlite> .print Olá, Ana!
Olá, Ana!
sqlite> .timer on
sqlite> SELECT count(*) FROM itens_pedido;
┌──────────┐
│ count(*) │
├──────────┤
│ 220      │
└──────────┘
Run Time: real 0.000 user 0.000031 sys 0.000000
sqlite> .timer off
sqlite> .changes on
sqlite> UPDATE produtos SET estoque = estoque WHERE categoria_id = 1;
changes: 6   total_changes: 6

Mais dois, num modo em colunas: o .width alarga as colunas, e o .eqp on mostra, antes do resultado, como o SQLite vai buscar os dados (aqui, direto pela chave primária; mais em EXPLAIN QUERY PLAN):

sqlite> .width 5 12
sqlite> SELECT id, nome FROM categorias LIMIT 2;
┌───────┬──────────────┐
│  id   │     nome     │
├───────┼──────────────┤
│ 1     │ Papelaria    │
│ 2     │ Eletrônicos  │
└───────┴──────────────┘
sqlite> .width
sqlite> .eqp on
sqlite> SELECT nome FROM clientes WHERE id = 3;
QUERY PLAN
`--SEARCH clientes USING INTEGER PRIMARY KEY (rowid=?)
┌───────────────────┐
│       nome        │
├───────────────────┤
│ Ana Beatriz Sousa │
└───────────────────┘

Os modos do .mode

Todos com a mesma consulta, SELECT id, nome FROM categorias LIMIT 3; (ou LIMIT 2), e .headers on:

sqlite> .mode column
sqlite> SELECT id, nome FROM categorias LIMIT 3;
id  nome
--  --------------
1   Papelaria
2   Eletrônicos
3   Casa e Cozinha
sqlite> .mode box
sqlite> SELECT id, nome FROM categorias LIMIT 3;
┌────┬────────────────┐
│ id │      nome      │
├────┼────────────────┤
│ 1  │ Papelaria      │
│ 2  │ Eletrônicos    │
│ 3  │ Casa e Cozinha │
└────┴────────────────┘
sqlite> .mode table
sqlite> SELECT id, nome FROM categorias LIMIT 3;
+----+----------------+
| id |      nome      |
+----+----------------+
| 1  | Papelaria      |
| 2  | Eletrônicos    |
| 3  | Casa e Cozinha |
+----+----------------+
sqlite> .mode markdown
sqlite> SELECT id, nome FROM categorias LIMIT 3;
| id |      nome      |
|----|----------------|
| 1  | Papelaria      |
| 2  | Eletrônicos    |
| 3  | Casa e Cozinha |
sqlite> .mode csv
sqlite> SELECT id, nome FROM categorias LIMIT 3;
id,nome
1,Papelaria
2,"Eletrônicos"
3,"Casa e Cozinha"

Repare no csv: o sqlite3 pôs aspas em "Eletrônicos" e "Casa e Cozinha". Ele põe aspas nos textos com espaço, com acento ou com caracteres especiais, por segurança; qualquer planilha lê os dois jeitos. Os outros modos:

sqlite> .mode line
sqlite> SELECT id, nome FROM categorias LIMIT 2;
   id = 1
 nome = Papelaria

   id = 2
 nome = Eletrônicos
sqlite> .mode json
sqlite> SELECT id, nome FROM categorias LIMIT 2;
[{"id":1,"nome":"Papelaria"},
{"id":2,"nome":"Eletrônicos"}]
sqlite> .mode insert categorias
sqlite> SELECT id, nome FROM categorias LIMIT 2;
INSERT INTO categorias(id,nome) VALUES(1,'Papelaria');
INSERT INTO categorias(id,nome) VALUES(2,'Eletrônicos');
sqlite> .mode quote
sqlite> SELECT id, nome FROM categorias LIMIT 2;
'id','nome'
1,'Papelaria'
2,'Eletrônicos'
sqlite> .mode html
sqlite> SELECT id, nome FROM categorias LIMIT 1;
<TR><TH>id</TH>
<TH>nome</TH>
</TR>
<TR><TD>1</TD>
<TD>Papelaria</TD>
</TR>
sqlite> .mode list
sqlite> .separator " ; "
sqlite> SELECT id, nome FROM categorias LIMIT 2;
id ; nome
1 ; Papelaria
2 ; Eletrônicos
sqlite> .separator "|"
sqlite> .mode
current output mode: list --escape ascii

Arquivos: ler, gravar, copiar

A Ana exportou as categorias para CSV com .once e conferiu o arquivo com .shell (que roda um comando do sistema sem sair do sqlite3):

sqlite> .headers on
sqlite> .mode csv
sqlite> .once categorias.csv
sqlite> SELECT * FROM categorias;
sqlite> .shell cat categorias.csv
id,nome,descricao
1,Papelaria,"Material escolar e de escritório"
2,"Eletrônicos","Acessórios e dispositivos eletrônicos"
3,"Casa e Cozinha","Utensílios para o lar"
4,Livros,"Livros, dicionários e guias"
5,Brinquedos,"Brinquedos e jogos para todas as idades"
6,"Esporte e Lazer","Artigos esportivos e de lazer"
7,Alimentos,"Alimentos não perecíveis e regionais"
8,Jardim,"Ferramentas e artigos de jardinagem"
sqlite> .output fornecedores.txt
sqlite> SELECT nome FROM fornecedores;
sqlite> .output
sqlite> .shell head -3 fornecedores.txt
Distribuidora Piauí Center
Loja D'Água
Atlântico Importados

Repare que, depois do .once e do .output, o SELECT não mostrou nada na tela: a saída foi para o arquivo. Agora, o caminho de volta: importar o CSV numa tabela nova. O .import criou a tabela com as colunas do cabeçalho, todas do tipo TEXT:

sqlite> .import --csv categorias.csv categorias_copia
sqlite> .mode box
sqlite> SELECT * FROM categorias_copia LIMIT 2;
┌────┬─────────────┬───────────────────────────────────────┐
│ id │    nome     │               descricao               │
├────┼─────────────┼───────────────────────────────────────┤
│ 1  │ Papelaria   │ Material escolar e de escritório      │
│ 2  │ Eletrônicos │ Acessórios e dispositivos eletrônicos │
└────┴─────────────┴───────────────────────────────────────┘
sqlite> .schema categorias_copia
CREATE TABLE IF NOT EXISTS "categorias_copia"(
"id" TEXT, "nome" TEXT, "descricao" TEXT);

Importar para uma tabela que já existe acrescenta as linhas. Se as linhas repetem a chave primária, cada uma falha, e o .import avisa linha por linha (aqui, com --skip 1 para pular o cabeçalho):

sqlite> .import --csv --skip 1 categorias.csv categorias
categorias.csv:2: INSERT failed: UNIQUE constraint failed: categorias.id
categorias.csv:3: INSERT failed: UNIQUE constraint failed: categorias.id
categorias.csv:4: INSERT failed: UNIQUE constraint failed: categorias.id
categorias.csv:5: INSERT failed: UNIQUE constraint failed: categorias.id
categorias.csv:6: INSERT failed: UNIQUE constraint failed: categorias.id
categorias.csv:7: INSERT failed: UNIQUE constraint failed: categorias.id
categorias.csv:8: INSERT failed: UNIQUE constraint failed: categorias.id
categorias.csv:9: INSERT failed: UNIQUE constraint failed: categorias.id

O .dump de uma tabela, e o .backup seguido de .open na cópia:

sqlite> .dump categorias
PRAGMA foreign_keys=OFF;
BEGIN TRANSACTION;
CREATE TABLE categorias (
    id        INTEGER PRIMARY KEY,
    nome      TEXT NOT NULL,
    descricao TEXT
);
INSERT INTO categorias VALUES(1,'Papelaria','Material escolar e de escritório');
INSERT INTO categorias VALUES(2,'Eletrônicos','Acessórios e dispositivos eletrônicos');
INSERT INTO categorias VALUES(3,'Casa e Cozinha','Utensílios para o lar');
INSERT INTO categorias VALUES(4,'Livros','Livros, dicionários e guias');
INSERT INTO categorias VALUES(5,'Brinquedos','Brinquedos e jogos para todas as idades');
INSERT INTO categorias VALUES(6,'Esporte e Lazer','Artigos esportivos e de lazer');
INSERT INTO categorias VALUES(7,'Alimentos','Alimentos não perecíveis e regionais');
INSERT INTO categorias VALUES(8,'Jardim','Ferramentas e artigos de jardinagem');
COMMIT;
sqlite> .backup copia.db
sqlite> .open copia.db
sqlite> .databases
main: /home/ana/copia.db r/w
sqlite> .tables
categorias    fornecedores  itens_pedido  produtos
clientes      funcionarios  pedidos

E o .read, rodando o arquivo consulta.sql (que tem a linha SELECT count(*) AS produtos FROM produtos;):

sqlite> .open loja.db
sqlite> .read consulta.sql
┌──────────┐
│ produtos │
├──────────┤
│ 45       │
└──────────┘

A sessão

sqlite> .version
SQLite 3.50.4 2025-07-30 19:33:53 4d8adfb30e03f9cf27f800a2c1ba3c48fb4ca1b08b0f5ed59a4d5ecbf45e20a3
zlib version 1.3.1
gcc-14.2.0 (64-bit)
sqlite> .quit
$

Todos os comandos (o .help do 3.50.4)

A lista completa, na ordem do .help. A coluna do meio é o texto original, exatamente como o sqlite3 3.50.4 mostra; ?…? quer dizer "opcional" e a|b, "a ou b". Os comandos marcados com * são para usos avançados (testes, depuração, extensões).

E no editor do guia?

Nenhum comando de ponto funciona no editor, porque ele roda só SQL. Para quase todos os de "ver o banco", existe um jeito em SQL, que funciona em qualquer programa:

.tables

SELECT name FROM sqlite_schema WHERE type = 'table';

Resumo

• Comandos de ponto são do programa sqlite3, não do SQL: começam com ., um por linha, sem ;.
• Ver o banco: .tables, .schema, .indexes, .databases, .show.
• Exibição: .mode box (ou table, column, csv, json…), .headers on, .nullvalue, .width, .timer on.
• Arquivos: .once/.output para gravar, .import para ler CSV, .read para rodar um .sql, .dump e .backup para cópias.
• .help lista todos; .help mode detalha um; .quit sai.
• No editor do guia, use o SQL equivalente (sqlite_schema, pragma_table_info).