Os exemplos de SQL utilizam PostgreSQL, a menos que outro dialeto seja mencionado. Excertos curtos pressupõem que as suas tabelas referenciadas já existem. Valide o DDL na sua base de dados de destino antes de o aplicar.
O que é o SQL DDL?
Linguagem de Definição de Dados (DDL) é o subconjunto de SQL usado para definir e gerir estruturas de bases de dados. Ao contrário da DML (Data Manipulation Language), que lida com operações de dados (INSERT, SELECT, UPDATE, DELETE), a DDL foca-se no próprio esquema — criando, modificando e removendo objetos da base de dados, como tabelas, tipos e restrições.
Os três comandos DDL principais são CREATE, ALTER, e DROP. Dominar estes é essencial para qualquer programador que trabalhe com bases de dados relacionais.
CREATE TABLE
A instrução DDL mais fundamental. Define uma nova tabela com as suas colunas, tipos de dados e restrições.
Sintaxe Básica
CREATE TABLE table_name (
column_name data_type [constraints],
...
[table_constraints]
);Exemplo Completo
CREATE TABLE departments (
id SERIAL PRIMARY KEY,
name VARCHAR(100) NOT NULL
);
CREATE TABLE employees (
id SERIAL PRIMARY KEY,
first_name VARCHAR(50) NOT NULL,
last_name VARCHAR(50) NOT NULL,
email TEXT UNIQUE NOT NULL,
department_id INTEGER REFERENCES departments(id),
salary NUMERIC(10, 2) DEFAULT 0 CHECK (salary >= 0),
hire_date DATE DEFAULT CURRENT_DATE,
is_active BOOLEAN DEFAULT true
);Tipos de Dados Comuns por Base de Dados
| Categoria | PostgreSQL | MySQL | SQL Server |
|---|---|---|---|
| Incremento automático | SERIAL | INT AUTO_INCREMENT | INT IDENTITY(1,1) |
| Texto variável | VARCHAR(n), TEXT | VARCHAR(n), TEXT | NVARCHAR(n), NVARCHAR(MAX) (texto JSON); json no SQL Server 2025 |
| Booleano | BOOLEAN | TINYINT(1) | BIT |
| Timestamp | TIMESTAMP | DATETIME | DATETIME2 |
| UUID | UUID | CHAR(36) | UNIQUEIDENTIFIER |
| JSON | JSONB | JSON | NVARCHAR(MAX) (texto JSON); json no SQL Server 2025 |
Restrições de coluna
As restrições aplicam regras aos dados nas suas tabelas:
CREATE TABLE categories (
id SERIAL PRIMARY KEY,
name VARCHAR(100) NOT NULL
);
CREATE TABLE products (
-- PRIMARY KEY: uniquely identifies each row
id SERIAL PRIMARY KEY,
-- NOT NULL: column cannot contain NULL
name VARCHAR(200) NOT NULL,
-- UNIQUE: no duplicate values allowed
sku VARCHAR(50) UNIQUE,
-- DEFAULT: automatic value when not provided
status VARCHAR(20) DEFAULT 'draft',
-- CHECK: validates data with a condition
price NUMERIC(10, 2) CHECK (price >= 0),
-- REFERENCES: creates a foreign key relationship
category_id INTEGER REFERENCES categories(id)
);Restrições ao nível da tabela
Para chaves compostas e restrições de várias colunas, defina-as ao nível da tabela:
CREATE TABLE students (id INTEGER PRIMARY KEY);
CREATE TABLE courses (id INTEGER PRIMARY KEY);
CREATE TABLE enrollments (
student_id INTEGER,
course_id INTEGER,
enrolled_at TIMESTAMP DEFAULT now(),
grade CHAR(2),
PRIMARY KEY (student_id, course_id),
CONSTRAINT fk_student
FOREIGN KEY (student_id) REFERENCES students(id),
CONSTRAINT fk_course
FOREIGN KEY (course_id) REFERENCES courses(id),
CONSTRAINT chk_grade
CHECK (grade IN ('A', 'B', 'C', 'D', 'F'))
);ALTER TABLE
Modifique a estrutura de uma tabela existente adicionando ou alterando colunas e restrições. Os exemplos aqui utilizam PostgreSQL; o SQL Server omite COLUMN em ADD, e o SQLite requer a reconstrução da tabela para muitas alterações de restrições.
Adicionar uma Chave Estrangeira
ALTER TABLE orders
ADD CONSTRAINT fk_orders_customer
FOREIGN KEY (customer_id)
REFERENCES customers(id);Adicionar uma Coluna
ALTER TABLE users
ADD COLUMN phone VARCHAR(20);Adicionar uma Restrição de Unicidade
ALTER TABLE users
ADD CONSTRAINT uq_users_email
UNIQUE (email);Adicionar uma Restrição de Verificação
ALTER TABLE products
ADD CONSTRAINT chk_price_positive
CHECK (price > 0);CREATE TYPE
Defina tipos reutilizáveis personalizados (funcionalidade do PostgreSQL também suportada pelo Erd Go):
Tipo Enum
CREATE TYPE order_status AS ENUM (
'pending', 'processing', 'shipped',
'delivered', 'cancelled'
);
CREATE TABLE orders (
id SERIAL PRIMARY KEY,
status order_status DEFAULT 'pending'
);Tipo Composto
CREATE TYPE address AS (
street VARCHAR(200),
city VARCHAR(100),
state CHAR(2),
zip VARCHAR(10)
);
CREATE TABLE companies (
id SERIAL PRIMARY KEY,
name VARCHAR(200) NOT NULL,
headquarters address
);DROP TABLE
DROP TABLE remove a definição da tabela e os seus dados. Use DELETE para remover as linhas selecionadas mantendo a estrutura da tabela. Este exemplo do PostgreSQL cria uma tabela de staging e depois remove-a:
CREATE TABLE staging_orders (
id INTEGER PRIMARY KEY
);
DROP TABLE IF EXISTS staging_orders;IF EXISTS trata uma tabela em falta; não ignora as verificações de dependência. O PostgreSQL normalmente rejeita um drop quando outros objetos dependem da tabela. Reveja as dependências antes de escolher CASCADE, que também pode remover objetos dependentes. O comportamento das transações DDL varia consoante o motor da base de dados.
Referência Rápida
| Instrução | Objetivo | Exemplo |
|---|---|---|
DROP TABLE | Remover uma tabela e os seus dados | DROP TABLE IF EXISTS staging_orders; |
CREATE TABLE | Definir uma nova tabela | CREATE TABLE users (...); |
CREATE TYPE | Definir tipo personalizado | CREATE TYPE status AS ENUM (...); |
ALTER TABLE ADD | Adicionar coluna/restrição | ALTER TABLE t ADD COLUMN c INT; |
PRIMARY KEY | Identificador único de linha | id SERIAL PRIMARY KEY |
FOREIGN KEY | Referenciar outra tabela | REFERENCES users(id) |
UNIQUE | Sem valores duplicados | email TEXT UNIQUE |
NOT NULL | Valor obrigatório | name VARCHAR(100) NOT NULL |
DEFAULT | Valor predefinido | status TEXT DEFAULT 'active' |
CHECK | Validar dados | CHECK (price >= 0) |



