Comandos SQL: lista dos comandos mais usados com exemplos

Os comandos SQL em resumo

Os comandos SQL se dividem em alguns grupos, de acordo com o que fazem. A tabela lista os que você mais vai usar, e cada seção abaixo executa um deles.

DDL é a linguagem de definição de dados, DML é a linguagem de manipulação de dados, DQL é a linguagem de consulta de dados e TCL é a linguagem de controle de transações. Os nomes importam menos que a divisão: DDL muda a forma do banco de dados, DML muda o que está dentro dele.

CREATE TABLE: definir uma tabela

CREATE TABLE dá nome à tabela e lista as suas colunas com os tipos e as regras de cada uma. Todos os outros comandos desta página precisam de uma tabela para trabalhar.

CREATE TABLE students (
    id INTEGER PRIMARY KEY,
    name TEXT NOT NULL,
    grade INTEGER
);

SELECT name, sql FROM sqlite_master WHERE type = 'table';

A página sobre CREATE TABLE cobre regras como NOT NULL, UNIQUE e DEFAULT.

INSERT: adicionar linhas

INSERT INTO adiciona uma linha ou várias. Liste as colunas e depois os valores na mesma ordem.

CREATE TABLE students (id INTEGER PRIMARY KEY, name TEXT NOT NULL, grade INTEGER);

INSERT INTO students (name, grade) VALUES ('Ada', 91);
INSERT INTO students (name, grade) VALUES
    ('Boris', 78),
    ('Rosa', 85);

SELECT * FROM students;

A coluna id se preencheu sozinha: uma INTEGER PRIMARY KEY recebe o próximo número quando você não informa o valor. Veja mais em INSERT.

SELECT: ler linhas

SELECT é o comando que você mais vai escrever. Escolha as colunas, filtre as linhas com WHERE e ordene com ORDER BY.

CREATE TABLE students (id INTEGER PRIMARY KEY, name TEXT NOT NULL, grade INTEGER);
INSERT INTO students (name, grade) VALUES ('Ada', 91), ('Boris', 78), ('Rosa', 85), ('Chen', 62);

SELECT name, grade
FROM students
WHERE grade >= 80
ORDER BY grade DESC;

Só voltam as linhas que passam no teste do WHERE, com a nota mais alta primeiro. Veja o básico do SELECT e WHERE para os detalhes.

UPDATE: alterar linhas

UPDATE define valores novos em linhas que já existem. A cláusula WHERE decide quais linhas; sem ela, todas as linhas mudam.

CREATE TABLE students (id INTEGER PRIMARY KEY, name TEXT NOT NULL, grade INTEGER);
INSERT INTO students (name, grade) VALUES ('Ada', 91), ('Boris', 78), ('Rosa', 85);

UPDATE students
SET grade = 82
WHERE name = 'Boris';

SELECT * FROM students;

Quando você não tiver certeza de quais linhas um WHERE pega, rode a mesma condição em um SELECT antes. A página de UPDATE mostra mais padrões.

DELETE: remover linhas

DELETE FROM remove as linhas que atendem à cláusula WHERE. Assim como o UPDATE, ele afeta todas as linhas se a cláusula estiver faltando.

CREATE TABLE students (id INTEGER PRIMARY KEY, name TEXT NOT NULL, grade INTEGER);
INSERT INTO students (name, grade) VALUES ('Ada', 91), ('Boris', 78), ('Rosa', 85), ('Chen', 62);

DELETE FROM students
WHERE grade < 70;

SELECT * FROM students;

A linha de Chen sumiu e as outras ficaram intactas. Veja DELETE.

ALTER TABLE e DROP TABLE: alterar ou remover uma tabela

ALTER TABLE altera uma tabela existente sem perder as suas linhas. DROP TABLE remove a tabela por completo.

CREATE TABLE students (id INTEGER PRIMARY KEY, name TEXT NOT NULL);
INSERT INTO students (name) VALUES ('Ada'), ('Boris');

ALTER TABLE students ADD COLUMN email TEXT;
UPDATE students SET email = lower(name) || '@school.test';
SELECT * FROM students;

CREATE TABLE old_notes (id INTEGER PRIMARY KEY, body TEXT);
DROP TABLE old_notes;
SELECT name FROM sqlite_master WHERE type = 'table';

Uma coluna nova começa como NULL nas linhas existentes até você preenchê-la. ALTER e DROP TABLE lista o que o SQLite permite.

JOIN: combinar tabelas

Um JOIN lê linhas de duas tabelas ao mesmo tempo, casadas por uma coluna que elas têm em comum.

CREATE TABLE students (id INTEGER PRIMARY KEY, name TEXT NOT NULL);
CREATE TABLE enrollments (student_id INTEGER, course TEXT);

INSERT INTO students (name) VALUES ('Ada'), ('Boris'), ('Rosa');
INSERT INTO enrollments VALUES (1, 'Math'), (1, 'Physics'), (3, 'Art');

SELECT students.name, enrollments.course
FROM students
INNER JOIN enrollments ON enrollments.student_id = students.id
ORDER BY students.name;

Boris não tem matrículas, então um INNER JOIN o deixa de fora. Um LEFT JOIN manteria Boris, com o curso vazio.

GROUP BY: resumir linhas

GROUP BY junta em uma só linha as linhas que têm o mesmo valor, e uma função de agregação como COUNT ou AVG resume cada grupo.

CREATE TABLE enrollments (student TEXT, course TEXT, score INTEGER);
INSERT INTO enrollments VALUES
    ('Ada', 'Math', 91), ('Boris', 'Math', 78),
    ('Ada', 'Art', 88), ('Rosa', 'Art', 95), ('Chen', 'Art', 70);

SELECT course, COUNT(*) AS students, AVG(score) AS average
FROM enrollments
GROUP BY course
ORDER BY course;

Funções de agregação e GROUP BY e HAVING vão mais longe.

BEGIN, COMMIT e ROLLBACK: agrupar alterações

Uma transação faz várias alterações contarem como uma só. COMMIT mantém todas; ROLLBACK desfaz todas.

CREATE TABLE accounts (name TEXT, balance INTEGER);
INSERT INTO accounts VALUES ('Ada', 100), ('Boris', 50);

BEGIN;
UPDATE accounts SET balance = balance - 30 WHERE name = 'Ada';
UPDATE accounts SET balance = balance + 30 WHERE name = 'Boris';
COMMIT;

BEGIN;
UPDATE accounts SET balance = 0;
ROLLBACK;

SELECT * FROM accounts;

A transferência foi confirmada e a segunda alteração foi desfeita, então Ada termina com 70 e Boris com 80. Transações explica quando usá-las.

Onde o SQLite é diferente

Os comandos desta página são SQL padrão, e o que você aprende aqui vale para o MySQL e o PostgreSQL. Os exemplos executáveis foram escritos para o SQLite, porém, e três detalhes mudam nos bancos de dados maiores:

• Listar tabelas. Os exemplos leem sqlite_master, a tabela de esquema do próprio SQLite. O MySQL usa SHOW TABLES, e o PostgreSQL usa a view information_schema.tables (ou \dt no psql).
• Ids automáticos. No SQLite, uma coluna declarada INTEGER PRIMARY KEY numera as linhas novas sozinha; é por isso que os exemplos de INSERT deixam id de fora. O MySQL precisa de AUTO_INCREMENT na coluna, e o PostgreSQL de uma coluna de identidade (GENERATED BY DEFAULT AS IDENTITY) ou SERIAL.
• Permissões e mudanças de esquema. O SQLite não tem GRANT nem REVOKE, porque um banco SQLite é um único arquivo sem contas de usuário, e o ALTER TABLE dele não consegue mudar o tipo de uma coluna.