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.
Por que razão os esquemas PostgreSQL precisam de bons diagramas
Os esquemas de PostgreSQL contêm frequentemente mais do que simples tabelas. Projetos reais utilizam ENUM tipos, colunas de identidade, nomes qualificados por esquema, campos JSON, tipos de matriz, chaves compostas, colunas geradas, índices parciais e chaves estrangeiras com regras em cascata. Um diagrama ajuda a equipa a compreender toda essa estrutura mais rapidamente do que a ler o DDL linha por linha.
Um gerador de ERD para PostgreSQL lê o seu DDL e cria um diagrama de entidade-relacionamento com tabelas, colunas, chaves primárias, chaves estrangeiras e restrições. O Editor SQL para ERD do Erd Go suporta definições de esquema ao estilo do PostgreSQL para que possa colar DDL e inspecionar o modelo imediatamente.
Funcionalidades do PostgreSQL que valem a pena visualizar
Ao escolher um fluxo de trabalho de diagrama Postgres, certifique-se de que a ferramenta compreende as funcionalidades da base de dados que a sua aplicação realmente utiliza.
- Colunas de identidade e seriais. Chaves primárias como
SERIAL,BIGSERIAL, eGENERATED ALWAYS AS IDENTITYdevem ser reconhecidos como identificadores gerados. - Tipos personalizados.
CREATE TYPE ... AS ENUMos valores devem permanecer visíveis em vez de serem achatados em cadeias de caracteres genéricas. - Chaves estrangeiras. Em linha
REFERENCESe restrições nomeadas ao nível da tabela precisam ambas de produzir relações de diagrama. - Objetos qualificados pelo esquema. Nomes como
billing.invoiceseauth.usersdevem permanecer compreensíveis no diagrama.
Exemplo de DDL PostgreSQL
Cole este exemplo no editor para gerar um ERD com variante PostgreSQL:
CREATE TYPE order_status AS ENUM ('draft', 'paid', 'shipped', 'cancelled');
CREATE TABLE customers (
id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
email TEXT NOT NULL UNIQUE,
full_name TEXT NOT NULL,
metadata JSONB DEFAULT '{}'::jsonb,
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
CREATE TABLE orders (
id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
customer_id BIGINT NOT NULL REFERENCES customers (id),
status order_status NOT NULL DEFAULT 'draft',
total NUMERIC(12, 2) NOT NULL CHECK (total >= 0),
tags TEXT[] DEFAULT ARRAY[]::TEXT[],
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
CREATE TABLE order_events (
id BIGSERIAL PRIMARY KEY,
order_id BIGINT NOT NULL REFERENCES orders (id) ON DELETE CASCADE,
event_name TEXT NOT NULL,
payload JSONB NOT NULL DEFAULT '{}'::jsonb,
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
CREATE INDEX idx_orders_customer_id ON orders (customer_id);
CREATE INDEX idx_order_events_order_id ON order_events (order_id);As relações importantes são customers → orders e orders → order_events. O enum personalizado, colunas JSONB, arrays, verificações e índices adicionam detalhes de implementação sem ocultar o modelo de Dados principal.
Fluxo de trabalho ERD de Postgres
Para equipas que usam PostgreSQL, um fluxo de trabalho de diagrama focado primeiro em SQL é geralmente o mais fiável.
- Exporte ou copie o DDL atual dos seus ficheiros de migração, dump de esquema ou pull request.
- Cole-o no Erd Go para gerar o diagrama automaticamente.
- Mova tabelas importantes para clusters legíveis, tais como auth, billing, catalog e audit.
- Utilize o diagrama durante a revisão para verificar a falta de chaves estrangeiras e limites de propriedade confusos.
- Após a aprovação da migração, regenere o ERD a partir do DDL atualizado para que o diagrama permaneça sincronizado.



