Comments¶

Requêtes permettant de retrouver les commentaires des tables, vues, serveurs distants, à des fins de documentation notamment :

(Référence : fonctions système, pg_description, pg_class)

Commentaires des tables et vues¶

\echo Commentaires des tables et vues

SELECT    n.nspname AS schema_nom,
          c.relname AS table_nom,
          relkind,
          left (obj_description (c.oid, 'pg_class') , 100)
FROM      pg_class c        -- table des tables, vues, index
LEFT JOIN pg_namespace n ON n.oid = c.relnamespace -- schémas notamment
WHERE 
-- tables, dont distantes ou partitionnées, vues, dont matérialisées
    relkind IN ('r','v','m','f','p')
AND nspname NOT IN ('pg_catalog','pg_toast','information_schema')
ORDER BY 1,2
;

Commentaires des colonnes¶

\echo Commentaires des colonnes  

SELECT    n.nspname AS schema_nom,
          c.relname AS table_nom,
          relkind,
          a.attnum AS champ_numero,
          a.attname AS champ_nom,
          col_description (c.oid, attnum) AS commentaire
FROM      pg_class c        -- table des tables, vues, index
LEFT JOIN pg_namespace n ON n.oid = c.relnamespace -- schémas notamment
LEFT JOIN pg_attribute a ON (a.attrelid = c.oid)
WHERE 
-- tables, dont distantes ou partitionnées, vues, dont matérialisées
    relkind IN ('r','v','m','f','p')
AND nspname NOT IN ('pg_catalog','pg_toast','information_schema')
AND attnum > 0 -- éviter colonnes système
ORDER BY 1,2,4
;

Commentaires des serveurs distants¶

\echo Commentaires des serveurs distants

SELECT    srvname,
          obj_description (c.oid, 'pg_foreign_server') AS commentaire
FROM      pg_foreign_server c        -- table des tables, vues, index
ORDER BY 1,2
;