Voltar a todos os guias
Ferramentas ERD··3 min de leitura

Gerador ERD para PostgreSQL: visualize tabelas, ENUM e chaves estrangeiras

Gerar diagramas ER de PostgreSQL a partir de CREATE TABLE, CREATE TYPE, colunas de identidade, índices e restrições de chave estrangeira com exemplos práticos.

Colunas BIGSERIAL e TIMESTAMPTZ do PostgreSQL com um diagrama de chave estrangeira de cliente para encomenda
Neste guia
  1. Por que razão os esquemas PostgreSQL precisam de bons diagramas
  2. Funcionalidades do PostgreSQL que valem a pena visualizar
  3. Exemplo de DDL PostgreSQL
  4. Fluxo de trabalho ERD de Postgres
  5. 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.

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.

DDL de PostgreSQL e outros dialetos SQL fluindo para uma tela de diagrama Erd Go
O PostgreSQL tem uma sintaxe DDL rica, mas o ERD ainda precisa de comunicar os mesmos fundamentos: tabelas, chaves, restrições e relações.

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, e GENERATED ALWAYS AS IDENTITY devem ser reconhecidos como identificadores gerados.
  • Tipos personalizados. CREATE TYPE ... AS ENUM os valores devem permanecer visíveis em vez de serem achatados em cadeias de caracteres genéricas.
  • Chaves estrangeiras. Em linha REFERENCES e restrições nomeadas ao nível da tabela precisam ambas de produzir relações de diagrama.
  • Objetos qualificados pelo esquema. Nomes como billing.invoices e auth.users devem 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.

Referências e leitura adicional

Mais publicações