Comando sqlite3: O Caminho Mais Curto para Testar SQL no Terminal

2026-10-24 Tempo de leitura: Cerca de 10 min Dificuldade: Iniciante

O Que Você Vai Aprender

• Como criar um banco de dados em um único arquivo com sqlite3
• O SQL mínimo para criar uma tabela, inserir dados e buscá-los com SELECT
• Por que os números diferem entre COUNT(*) e wc -l
• Como ligar o resultado do SQL a sort / uniq por pipe e como transformar o banco em texto com .dump

1. Por Que o sqlite3?

Conclusão: O SQLite não precisa de servidor. O banco de dados inteiro vira um único arquivo, que você trata como qualquer arquivo visto com ls.

$ ls -l gym.db

-rw-r--r-- 1 user user 8192 Oct 24 02:18 gym.db

O gym.db ainda não existe, então você pode testar este ls -l depois da seção 4. O nome do dono e a data mudam conforme o ambiente.

2. Como Instalo o sqlite3?

Conclusão: No Ubuntu e no WSL, instale com apt. O Mac já vem com ele. Nos dois casos, confira com sqlite3 --version.

No Ubuntu / sistemas baseados em Debian

$ sudo apt update
$ sudo apt install sqlite3
$ sqlite3 --version

3.45.1 2024-01-30 16:01:20 e876e51a0ed5c5b3126f52e532044363a014bc594cfefa87ffb5b82257ccalt1 (64-bit)

O sudo executa um comando com permissãoAs regras de acesso de leitura / escrita / execução definidas em um arquivo ou diretório. de administrador. Se ele pedir uma senha, digite a sua senha de login. A tela não mostra nada enquanto você digita, nem *. Digite até o fim e aperte Enter. O primeiro número que o sqlite3 --version mostra é a versão. Neste exemplo, é 3.45.1.

No Windows: abra o Ubuntu no WSL (um jeito de rodar Linux dentro do Windows). Depois, siga os mesmos passos do apt. Se você ainda não tem o WSL, comece pela Introdução ao WSL2.

No Mac: o macOS já vem com o sqlite3. Confira com sqlite3 --version. Dá para testar tudo neste artigo com o sqlite3 que vem com o macOS.

$ mkdir ~/sqlite-practice
$ cd ~/sqlite-practice

3. O Que Muda Quando Inicio o sqlite3?

Conclusão: Ao iniciar sqlite3 gym.db, o prompt vira sqlite>. Comandos que começam com ponto são ordens para o próprio sqlite3.

$ sqlite3 gym.db

SQLite version 3.45.1 2024-01-30 16:01:20
Enter ".help" for usage hints.
sqlite>

Estes são os cinco que você usa primeiro.

A versão 3.54.0 e as posteriores mostram outro prompt (veja o item 3.54.0 do histórico de versões). O exemplo da documentação oficial é SQLite-3.54 ex1.db->. O que você digita é o mesmo.

Nos exemplos de código, não digite o $ ou o sqlite> do início. Digite só o que vem depois. Se usar o botão de copiar, apague o sqlite> (ou o $ ) do início depois de colar e só então aperte Enter.

As seções 4 e 5 continuam no prompt sqlite>. Se parar no meio, saia com .quit e volte com sqlite3 gym.db. A tabela e os dados continuam no arquivo. Não digite de novo o CREATE TABLE e os INSERT da seção 4 (isso adiciona as mesmas linhas outra vez). O .headers on e o .mode column são apagados, então digite os dois de novo ao voltar pela seção 5.

4. Como Crio uma Tabela e Insiro Dados?

Conclusão: CREATE TABLE define o formato da tabela, e INSERT adiciona os dados uma linha por vez. Sempre termine o SQL com ;.

sqlite> CREATE TABLE members (id INTEGER PRIMARY KEY, name TEXT, city TEXT, age INTEGER);
sqlite> INSERT INTO members (name, city, age) VALUES ('Pip', 'Tokyo', 24);
sqlite> INSERT INTO members (name, city, age) VALUES ('Momo', 'Osaka', 31);
sqlite> INSERT INTO members (name, city, age) VALUES ('Kai', 'Tokyo', 19);

Se der certo, nada aparece e o próximo sqlite> surge.

• INTEGER quer dizer número inteiro, e TEXT quer dizer texto (string)
• Por causa de id INTEGER PRIMARY KEY, o id recebe os números 1, 2 e 3 automaticamente
• Coloque o texto entre aspasEnvolver um texto entre aspas (' ou ") para que seja tratado como um único valor, por exemplo um que tenha espaços. simples ('), como em 'Tokyo'

Confira o resultado com os comandos de ponto.

sqlite> .tables

members

sqlite> .schema members

CREATE TABLE members (id INTEGER PRIMARY KEY, name TEXT, city TEXT, age INTEGER);

Se você esquecer o ; e apertar Enter, o prompt vira ...>. Isso quer dizer "esperando o resto". Digite só ; e aperte Enter para executar.

5. Como Pego Só as Linhas Que Preciso?

Conclusão: Filtre com WHERE, ordene com ORDER BY e corte com LIMIT. Eles fazem o mesmo papel de grep, sort e head.

Primeiro, mostre tudo o que está na tabela. O * quer dizer "todas as colunas".

sqlite> SELECT * FROM members;

1|Pip|Tokyo|24
2|Momo|Osaka|31
3|Kai|Tokyo|19

sqlite> .headers on
sqlite> .mode column
sqlite> SELECT * FROM members;

id  name  city   age
--  ----  -----  ---
1   Pip   Tokyo  24
2   Momo  Osaka  31
3   Kai   Tokyo  19

Na versão 3.53.0 e posteriores, uma sessão no terminal já mostra uma tabela com bordas desde o início (segundo https://sqlite.org/climode.html e o item 3.53.0 do histórico de versões). Mesmo numa versão mais nova, digite .headers on e .mode column neste artigo.

5-1. Filtrar linhas com WHERE (como o grep)

sqlite> SELECT name, age FROM members WHERE city = 'Tokyo';

name  age
----  ---
Pip   24
Kai   19

Como no grep Tokyo, só aparecem as linhas que atendem à condição.

5-2. Ordenar linhas com ORDER BY (como o sort)

sqlite> SELECT name, age FROM members ORDER BY age DESC;

name  age
----  ---
Momo  31
Pip   24
Kai   19

DESC quer dizer do maior para o menor. É o mesmo sentido do sort -rn. Sem o DESC, a ordem é do menor para o maior.

5-3. Cortar a quantidade com LIMIT (como o head)

sqlite> SELECT name, age FROM members ORDER BY age DESC LIMIT 2;

name  age
----  ---
Momo  31
Pip   24

Como no head -n 2, só aparecem as duas primeiras linhas.

6. O Que Acontece Quando Conto?

Conclusão: COUNT(*) conta as linhas da tabela. Grave em CSV e conte com wc -l, e a linha com os nomes das colunas soma uma a mais.

sqlite> SELECT COUNT(*) FROM members;

COUNT(*)
--------
3

sqlite> .mode csv
sqlite> .once members.csv
sqlite> SELECT * FROM members;
sqlite> .quit
$ wc -l members.csv

4 members.csv

O .quit trouxe o prompt de volta ao $, então o último wc -l roda como um comando normal do Linux.

$ cat members.csv

id,name,city,age
1,Pip,Tokyo,24
2,Momo,Osaka,31
3,Kai,Tokyo,19

Para contar sem a linha dos nomes das colunas, use tail -n +2 (mostra da linha 2 até o fim).

$ tail -n +2 members.csv | wc -l

3

Agora bate com o 3 do COUNT(*). Configurações como .headers on voltam ao padrão quando você sai do sqlite3.

7. Como Ligo o Resultado do SQL a um Pipe?

Conclusão: Escrever sqlite3 ARQUIVO "SQL" executa uma vez e sai. O resultado é texto simples, então vai direto para sort ou uniq por pipe.

$ sqlite3 gym.db "SELECT city FROM members" | sort | uniq -c

      1 Osaka
      2 Tokyo

• sqlite3 gym.db "SELECT city FROM members" mostra o nome das cidades, uma por linha
• sort junta as cidades iguais lado a lado
• uniq -c conta as linhas iguais

Esta forma não usa o .headers on, então nenhuma linha com nomes de colunas aparece. Segundo a documentação oficial, o resultado sai no "modo list" (separado por |).

7-1. Experimente o modo interativo no terminal virtual

O estado em que o prompt sqlite> da seção 3 está na tela se chama "modo interativo". Você digita uma linha por vez e vê o resultado na hora.

Você também pode experimentar o modo interativo no terminal virtual deste site. Abra o desafio "Contar os membros" e digite as linhas abaixo, nesta ordem. Não digite o $ ou o sqlite> do início.

$ sqlite3 gym.db

sqlite> SELECT COUNT(*) FROM members;

(uma linha com o número de membros do gym.db do desafio)

sqlite> .quit

O gym.db do terminal virtual foi preparado para o desafio, então o número é diferente dos 3 membros deste artigo. Quando a contagem estiver certa, o desafio aparece como concluído. A forma de execução única da seção 7 (sqlite3 gym.db "SELECT COUNT(*) FROM members;") também conclui o desafio. No terminal virtual, o prompt é sqlite> em qualquer versão.

8. Como Transformo o Banco de Dados em Texto?

Conclusão: .dump transforma o banco inteiro em texto SQL. Passe esse texto ao sqlite3 e você reconstrói o mesmo banco de dados.

$ sqlite3 gym.db .dump > backup.sql
$ cat backup.sql

PRAGMA foreign_keys=OFF;
BEGIN TRANSACTION;
CREATE TABLE members (id INTEGER PRIMARY KEY, name TEXT, city TEXT, age INTEGER);
INSERT INTO members VALUES(1,'Pip','Tokyo',24);
INSERT INTO members VALUES(2,'Momo','Osaka',31);
INSERT INTO members VALUES(3,'Kai','Tokyo',19);
COMMIT;

BEGIN TRANSACTION e COMMIT executam o SQL entre eles como um bloco só. A linha PRAGMA é uma configuração que o sqlite3 adicionou sozinho. Por enquanto, pode pular essas linhas.

$ sqlite3 new.db < backup.sql
$ sqlite3 new.db "SELECT * FROM members"

1|Pip|Tokyo|24
2|Momo|Osaka|31
3|Kai|Tokyo|19

O < passa o conteúdo de um arquivo para um comando. O SQL do backup.sql rodou de cima para baixo, e o new.db agora tem a mesma tabela.

9. Erros Comuns e Como Resolver

Conclusão: A maioria dos erros vem de quatro coisas: ponto e vírgula, aspas, maiúsculas e minúsculas, e nome de arquivo. Se aparecer um erro, leia a mensagem. Se não houver erro mas o resultado parecer errado, veja o conteúdo direto com SELECT * ou ls -l.

O caso do 'tokyo' devolve zero linhas sem erro. Quando o resultado vier vazio, rode primeiro SELECT * FROM members; para ver como os valores estão gravados.

10. Mini Exercícios: Tente Você Mesmo

Conclusão: Teste ordenar, contar e usar pipe com as próprias mãos. As respostas estão nas seções recolhidas.

Exercício 1: Ordene do mais novo para o mais velho

Tarefa: Entre com sqlite3 gym.db e digite .headers on e .mode column. Depois, mostre o nome e a idade de todos os membros, do mais novo para o mais velho.

sqlite> SELECT name, age FROM members ORDER BY age;

name  age
----  ---
Kai   19
Pip   24
Momo  31

Exercício 2: Conte os membros de Osaka

Tarefa: Conte quantos membros têm city igual a Osaka, usando só SQL.

sqlite> SELECT COUNT(*) FROM members WHERE city = 'Osaka';

COUNT(*)
--------
1

Exercício 3: Conte os membros de Tokyo com um pipe

Tarefa: Primeiro, volte ao $ com .quit. Depois, sem entrar no sqlite3, mostre os nomes dos membros de Tokyo e conte essas linhas com um comando do Linux.

$ sqlite3 gym.db "SELECT name FROM members WHERE city = 'Tokyo'" | wc -l

2

11. Revisão

Resumo de Hoje em 3 Linhas

1. O SQLite não precisa de servidor, e o banco de dados é um único arquivo que você vê com ls
2. SELECT / WHERE / ORDER BY / LIMIT correspondem a grep / sort / head
3. COUNT(*) e wc -l contam coisas diferentes. Atenção à primeira linha de um CSV (os nomes das colunas)