Inserindo comentários na tabela criada – Dicionário de dados Postgres

Exemplos

Anexar um comentário à tabela minha_tabela:

COMMENT ON TABLE minha_tabela IS 'Esta é a minha tabela.';

Remover o comentário:

COMMENT ON TABLE minha_tabela IS NULL;

Alguns outros exemplos:

COMMENT ON AGGREGATE minha_agregacao (double precision) IS 'Calcula a variância da amostra';
COMMENT ON CAST (text AS int4) IS 'Permite transformar texto em int4';
COMMENT ON COLUMN minha_tabela.minha_coluna IS 'Número de identificação do empregado';
COMMENT ON CONVERSION minha_conversao IS 'Conversão para UTF8';
COMMENT ON DATABASE meu_bd IS 'Banco de dados de desenvolvimento';
COMMENT ON DOMAIN meu_dominio IS 'Domínio de endereço de correio eletrônico';
COMMENT ON FUNCTION minha_funcao (timestamp) IS 'Retorna algarismos romanos';
COMMENT ON INDEX meu_indice IS 'Impõe a unicidade do identificador do empregado';
COMMENT ON LANGUAGE plpython IS 'Suporte a Python nos procedimentos armazenados';
COMMENT ON LARGE OBJECT 346344 IS 'Documento de planejamento';
COMMENT ON OPERATOR ^ (text, text) IS 'Realiza a interseção de dois textos';
COMMENT ON OPERATOR - (NONE, text) IS 'Este é um operador de prefixo para texto';
COMMENT ON OPERATOR CLASS int4ops USING btree IS 'Operadores inteiro de 4 bytes para árvores-B';
COMMENT ON ROLE meu_papel IS 'Grupo de administração para tabelas financeiras';
COMMENT ON RULE minha_regra ON minha_tabela IS 'Registra as atualizações das linhas dos empregados';
COMMENT ON SCHEMA meu_esquema IS 'Dados departamentais';
COMMENT ON SEQUENCE minha_sequencia IS 'Usado para gerar as chaves primárias';
COMMENT ON TABLE meu_esquema.minha_tabela IS 'Informações dos empregados';
COMMENT ON TABLESPACE meu_espaco_de_tabelas IS 'Espaço de tabelas para índices';
COMMENT ON TRIGGER meu_gatilho ON minha_tabela IS 'Usado para integridade referencial';
COMMENT ON TYPE complex IS 'Tipo de dado de número complexo';
COMMENT ON VIEW minha_visão IS 'Visão dos custos departamentais';[3]

Comentário na CONSTRAINT:

CREATE TABLE bar (
    uname text NOT NULL,
    another_uname text NOT NULL,
    c circle
    CONSTRAINT bar_uname_check CHECK ((uname <> 'invalid'::text)),
    CONSTRAINT uname_check_not_null CHECK ((uname IS NOT NULL)),
    CONSTRAINT bar_pkey PRIMARY KEY (uname, another_uname),
    CONSTRAINT uname_uniq_cons UNIQUE (uname),
    CONSTRAINT bar_uname_fkey FOREIGN KEY (uname) REFERENCES mytable(uname),
    EXCLUDE USING gist (c WITH &&)
);

COMMENT ON CONSTRAINT bar_uname_check ON bar IS 'constraint for bar';
COMMENT ON CONSTRAINT uname_check_not_null ON bar IS 'not null comment';
COMMENT ON CONSTRAINT bar_pkey ON bar IS 'two column pkey comment';
COMMENT ON CONSTRAINT uname_uniq_cons ON bar IS 'unique constraint comment';
COMMENT ON CONSTRAINT bar_uname_fkey ON bar IS 'fkey comment';
COMMENT ON CONSTRAINT bar_c_excl ON bar IS 'exclusion constraint comment';