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.
Porquê Visualizar o Seu Esquema SQL?
Uma base de dados bem estruturada pode conter dezenas — até centenas — de tabelas, cada uma ligada por chaves estrangeiras, restrições e índices. Ler em bruto CREATE TABLE instruções apenas conta parte da história. Um Diagrama de Entidade-Relacionamento (ERD) transforma esse SQL num mapa visual, tornando muito mais fácil:
- Identifique relações de chave estrangeira em falta ou incorretas num relance.
- Integrar novos membros da equipa que precisam de compreender o modelo de Dados rapidamente.
- Comunique decisões de esquema em revisões de pull-request, documentos de arquitetura e reuniões com partes interessadas.
- Detetar problemas de normalização, tais como colunas redundantes ou referências circulares.
- Planeie migrações e refatorações vendo o gráfico de dependências completo.
A forma mais rápida de passar de SQL para diagrama é utilizar um gerador automático de ERD. Com o Editor do Erd Go, basta colar o seu SQL e receber um diagrama interativo e editável em segundos — sem necessidade de desenho manual.
Geração de ERD Manual vs Automática
Existem duas abordagens gerais para criar um ERD a partir de um esquema existente, e compreender as vantagens e desvantagens ajuda-o a escolher a ferramenta certa para o trabalho.
Diagramação Manual
- Desenha cada caixa de tabela manualmente numa ferramenta como o Lucidchart, draw.io ou até mesmo num quadro branco.
- Controlo criativo total sobre o layout e o estilo visual.
- Desvantagens: extremamente moroso para esquemas grandes, fácil de introduzir discrepâncias entre o diagrama e a base de dados real, e tem de atualizar o desenho sempre que o esquema muda.
Geração Automática
- Uma ferramenta analisa o seu SQL DDL (Data Definition Language) e constrói o diagrama programaticamente.
- Deriva o diagrama a partir de definições SQL suportadas. Reveja os avisos do analisador e as referências em falta; a análise automática não prova que o SQL ou as regras de negócio estejam corretos.
- A regeneração após uma migração demora segundos em vez de uma sessão de edição manual.
- Desvantagens: o esquema automático pode não parecer perfeito inicialmente, pelo que por vezes é necessário arrastar as tabelas para uma disposição mais limpa.
Para a maioria das equipas, geração automática com ligeiros ajustes manuais é o fluxo de trabalho ideal. Obtém velocidade e precisão.
Passo a passo: Gerar um ERD com o Erd Go
Siga estes passos para transformar um esquema SQL suportado num ERD legível. Esquemas grandes e dumps incompletos podem precisar de limpeza antes da revisão.
Passo 1 — Abrir o Editor
Navegue para o Editor do Erd Go. Escolha um ficheiro SQL vazio ou um exemplo inicial. O espaço de trabalho fornece um painel SQL e uma tela de diagrama; em ecrãs mais pequenos, alterne as vistas conforme necessário.
Passo 2 — Cole o seu SQL
Copie o seu CREATE TABLE instruções (incluindo chaves estrangeiras) e cole-as no painel SQL. O Erd Go suporta a sintaxe SQL padrão do PostgreSQL, MySQL, SQLite e SQL Server.
Passo 3 — Veja o Diagrama Aparecer
O editor analisa o seu DDL em tempo real e renderiza caixas de tabela com colunas, tipos de dados, chaves primárias e setas de chave estrangeira. As relações são detetadas automaticamente a partir de FOREIGN KEY e REFERENCES cláusulas.
Passo 4 — Refinar o Layout
Arraste as tabelas para as reposicionar. Agrupe entidades relacionadas para maior clareza. O editor mantém as posições das tabelas correspondentes à medida que edita o documento atual. Renomear ou substituir tabelas pode exigir outra revisão do layout; salvar o documento para o preservar para uma sessão posterior.
Passo 5 — Exportar ou partilhar
Exporte um PNG, SVG ou PDF para documentação e apresentações. Para partilhar uma ligação pública de apenas leitura, inicie sessão e salve o documento primeiro; reveja detalhes sensíveis do esquema antes de o tornar público.
Funcionalidades SQL suportadas
O analisador do Erd Go lida com uma vasta gama de construções DDL, mas a cobertura não é idêntica à de um servidor de base de dados. Consulte o sintaxe suportada e limitações e rever diagnósticos ao importar um dump.
| Funcionalidade SQL | Exemplo | Como Aparece no ERD |
|---|---|---|
CREATE TABLE | CREATE TABLE users (...); | Renderizado como uma caixa de tabela com lista de colunas |
PRIMARY KEY | id SERIAL PRIMARY KEY | Coluna marcada com um ícone de chave |
FOREIGN KEY / REFERENCES | REFERENCES users (id) | Seta desenhada entre as duas tabelas |
ENUM types | CREATE TYPE status AS ENUM (...); | Mostrado como um tipo personalizado na definição da coluna |
ALTER TABLE | ALTER TABLE orders ADD COLUMN ...; | Coluna adicionada à caixa da tabela existente |
UNIQUE / NOT NULL | email VARCHAR(255) UNIQUE NOT NULL | Distintivos de restrição exibidos na coluna |
DEFAULT values | created_at TIMESTAMP DEFAULT NOW() | Predefinição retida nos metadados do esquema e SQL; inspecione os detalhes da coluna |
Um Exemplo Completo: Esquema de E-Commerce
Copie o SQL abaixo e cole-o diretamente no Editor do Erd Go para ver um ERD de e-commerce totalmente renderizado.
-- Enum for order status
CREATE TYPE order_status AS ENUM (
'pending', 'processing', 'shipped', 'delivered', 'cancelled'
);
CREATE TABLE customers (
id SERIAL PRIMARY KEY,
full_name VARCHAR(120) NOT NULL,
email VARCHAR(255) UNIQUE NOT NULL,
phone VARCHAR(20),
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
CREATE TABLE categories (
id SERIAL PRIMARY KEY,
name VARCHAR(100) NOT NULL,
slug VARCHAR(100) UNIQUE NOT NULL,
parent_id INT REFERENCES categories (id)
);
CREATE TABLE products (
id SERIAL PRIMARY KEY,
name VARCHAR(200) NOT NULL,
description TEXT,
price NUMERIC(10, 2) NOT NULL CHECK (price > 0),
category_id INT REFERENCES categories (id),
sku VARCHAR(50) UNIQUE,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
CREATE TABLE orders (
id SERIAL PRIMARY KEY,
customer_id INT NOT NULL REFERENCES customers (id),
status order_status DEFAULT 'pending',
total NUMERIC(12, 2) NOT NULL DEFAULT 0,
ordered_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
CREATE TABLE order_items (
order_id INT NOT NULL REFERENCES orders (id) ON DELETE CASCADE,
product_id INT NOT NULL REFERENCES products (id),
quantity SMALLINT NOT NULL DEFAULT 1 CHECK (quantity > 0),
unit_price NUMERIC(10, 2) NOT NULL,
PRIMARY KEY (order_id, product_id)
);
ALTER TABLE products ADD COLUMN stock INT NOT NULL DEFAULT 0;Este esquema demonstra vários padrões ao mesmo tempo: um-para-muitos (customers → orders), muitos-para-muitos (orders ↔ products via order_items), uma chave estrangeira autorreferencial (categories.parent_id), um ENUM tipo, CHECK restrições, e um ALTER TABLE instrução. O editor Erd Go trata de todas elas.
Dicas para ERDs limpos e legíveis
Mesmo com a geração automática, algumas boas práticas tornam os seus diagramas significativamente mais úteis:
- Utilize convenções de nomes consistentes. Manter-se fiel a
snake_casepara tabelas e colunas. Nomeie as tabelas de junção após as duas entidades que ligam (por exemplo,order_items,student_courses). - Agrupar tabelas relacionadas visualmente. Coloque o
users,roles, epermissionstabelas próximas umas das outras, longe de tabelas de produtos não relacionadas. - Minimizar o cruzamento de linhas. Reorganize as tabelas para que as setas de chave estrangeira fluam na mesma direção geral (de cima para baixo ou da esquerda para a direita).
- Destacar entidades-chave. Coloque as suas tabelas mais importantes (ex.,
users,orders) no centro do diagrama. - Regere após as migrações. Trate o seu ERD como um documento vivo. Após cada alteração de esquema, volte a colar o SQL atualizado no Editor do Erd Go para manter o diagrama sincronizado.



