O catálogo pg_description armazena
descrições opcionais (comentários) para cada objeto do banco de dados.
As descrições podem ser manipuladas com o comando
COMMENT e visualizadas com os meta-comandos
\d do psql.
As descrições de muitos objetos nativos do sistema são fornecidas no
conteúdo inicial de pg_description.
Veja também pg_shdescription que executa uma função semelhante para descrições envolvendo objetos compartilhados em uma instância de banco de dados.
Tabela 52.19. Colunas de pg_description
Coluna Tipo de dados Descrição |
|---|
OID do objeto ao qual esta descrição pertence |
OID do catálogo do sistema em que este objeto aparece |
Para um comentário em uma coluna de tabela, este é o número da
coluna (o |
Texto arbitrário que serve de descrição desse objeto |
Exemplo 52.11. Exemplo do tradutor
Comentários em tabelas
Uso do catálogo pg_description
para mostrar os comentários relacionados à tabela
estados, e uso também do
meta-comando \dtx+ estados do
psql para mostrar informações sobre esta
mesma tabela.
ana=> COMMENT ON TABLE estados IS ana-> 'Informações sobre os estados do Brasil'; COMMENT ana=> COMMENT ON COLUMN estados.capital IS ana-> 'Nome da capital do estado'; COMMENT ana=> SELECT * ana-> FROM pg_description ana-> WHERE objoid = 'estados'::REGCLASS\gx
-[ RECORD 1 ]--------------------------------------- objoid | 34495 classoid | 1259 objsubid | 0 description | Informações sobre os estados do Brasil -[ RECORD 2 ]--------------------------------------- objoid | 34495 classoid | 1259 objsubid | 2 description | Nome da capital do estado
ana=> \dtx+ estados
List of tables -[ RECORD 1 ]----+--------------------------------------- Esquema | public Nome | estados Tipo | tabela Dono | ana Persistência | permanente Método de acesso | heap Tamanho | 16 kB Descrição | Informações sobre os estados do Brasil