Voltar a todos os guias
SQL··4 min de leitura

Referência rápida de SQL DDL: CREATE, ALTER e DROP explicados

Domine o DDL SQL com esta folha de consulta. Aprenda CREATE TABLE, ALTER TABLE, tipos de Dados e restrições para PostgreSQL, MySQL e SQL Server.

Exemplos de CREATE TABLE, ALTER TABLE e DROP TABLE para a mesma tabela de produtos
Neste guia
  1. O que é o SQL DDL?
  2. CREATE TABLE
  3. Restrições de coluna
  4. Restrições ao nível da tabela
  5. ALTER TABLE
  6. CREATE TYPE
  7. DROP TABLE
  8. Referência Rápida
  9. Referências e leitura adicional

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.

Diferentes dialetos SQL, tais como PostgreSQL, MySQL, SQL Server e SQLite, transformados num único ERD
A sintaxe DDL varia consoante a base de dados, mas uma boa ferramenta SQL para ERD transforma essas instruções no mesmo modelo útil: tabelas, chaves e relações.

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

CategoriaPostgreSQLMySQLSQL Server
Incremento automáticoSERIALINT AUTO_INCREMENTINT IDENTITY(1,1)
Texto variávelVARCHAR(n), TEXTVARCHAR(n), TEXTNVARCHAR(n), NVARCHAR(MAX) (texto JSON); json no SQL Server 2025
BooleanoBOOLEANTINYINT(1)BIT
TimestampTIMESTAMPDATETIMEDATETIME2
UUIDUUIDCHAR(36)UNIQUEIDENTIFIER
JSONJSONBJSONNVARCHAR(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çãoObjetivoExemplo
DROP TABLERemover uma tabela e os seus dadosDROP TABLE IF EXISTS staging_orders;
CREATE TABLEDefinir uma nova tabelaCREATE TABLE users (...);
CREATE TYPEDefinir tipo personalizadoCREATE TYPE status AS ENUM (...);
ALTER TABLE ADDAdicionar coluna/restriçãoALTER TABLE t ADD COLUMN c INT;
PRIMARY KEYIdentificador único de linhaid SERIAL PRIMARY KEY
FOREIGN KEYReferenciar outra tabelaREFERENCES users(id)
UNIQUESem valores duplicadosemail TEXT UNIQUE
NOT NULLValor obrigatórioname VARCHAR(100) NOT NULL
DEFAULTValor predefinidostatus TEXT DEFAULT 'active'
CHECKValidar dadosCHECK (price >= 0)

Referências e leitura adicional

Mais publicações