IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)

47.11. pg_class

Le catalogue pg_class liste les tables, et à peu près tout ce qui contient des colonnes ou ressemble de près ou de loin à une table. Cela inclut les index (mais il faut aussi aller voir dans pg_index), les séquences, les vues, les vues matérialisées, les types composites et les tables TOAST ; voir relkind. Par la suite, lorsque l'on parle de « relation », on sous-entend tous ces types d'objets. Les colonnes ne sont pas toutes significatives pour tous les types de relations.

Tableau 47.11. Colonnes de pg_class

Nom Type Références Description
oid oid   Identifiant de ligne (attribut caché ; doit être sélectionné explicitement)
relname name   Nom de la table, vue, index, etc.
relnamespace oid pg_namespace.oid OID du namespace qui contient la relation.
reltype oid pg_type.oid OID du type de données qui correspond au type de ligne de la table, s'il y en a un. 0 pour les index qui n'ont pas d'entrée dans pg_type.
reloftype oid pg_type.oid Pour les tables typées, l'OID du type composite sous-jacent. Sinon, 0 dans tous les autres cas.
relowner oid pg_authid.oid Propriétaire de la relation.
relam oid pg_am.oid S'il s'agit d'un index, OID de la méthode d'accès utilisée (B-tree, hash, etc.)
relfilenode oid   Nom du fichier disque de la relation ; zéro signifie que c'est une relation « mapped » dont le nom de fichier est déterminé par un statut de bas niveau.
reltablespace oid pg_tablespace.oid Le tablespace dans lequel est stocké la relation. Si 0, il s'agit du tablespace par défaut de la base de données. (Sans intérêt si la relation n'est pas liée à un fichier disque.)
relpages int4   Taille du fichier disque, exprimée en pages (de taille BLCKSZ). Ce n'est qu'une estimation utilisée par le planificateur. Elle est mise à jour par les commandes VACUUM, ANALYZE et quelques commandes DDL comme CREATE INDEX.
reltuples float4   Nombre de lignes de la table. Ce n'est qu'une estimation utilisée par le planificateur. Elle est mise à jour par les commandes VACUUM, ANALYZE et quelques commandes DDL comme CREATE INDEX.
relallvisible int4   Nombre de pages marquées entièrement visibles dans la carte de visibilité de la table. Ceci n'est qu'une estimation utilisée par le planificateur. Elle est mise à jour par VACUUM, ANALYZE et quelques commandes DDL comme CREATE INDEX.
reltoastrelid oid pg_class.oid OID de la table TOAST associée à cette table. 0 s'il n'y en a pas. La table TOAST stocke les attributs de grande taille « hors ligne » dans une table secondaire.
reltoastidxid oid pg_class.oid Pour une table TOAST, OID de son index. 0 si ce n'est pas une table TOAST.
relhasindex bool   Vrai si c'est une table et qu'elle possède (ou possédait encore récemment) quelque index.
relisshared bool   Vrai si cette table est partagée par toutes les bases de données du cluster. Seuls certains catalogues système (comme pg_database) sont partagés.
relpersistence char   p = table permanente, u = table non tracée dans les journaux de transactions, t = table temporaire
relkind char   r = table ordinaire, i = index, S = séquence, v = vue, m = vue matérialisée, c = type composite, t = table TOAST, f = table distante.
relnatts int2   Nombre de colonnes utilisateur dans la relation (sans compter les colonnes système). Il doit y avoir le même nombre d'entrées dans pg_attribute. Voir aussi pg_attribute.attnum.
relchecks int2   Nombre de contraintes de vérification (CHECK) sur la table ; voir le catalogue pg_constraint.
relhasoids bool   Vrai si un OID est engendré pour chaque ligne de la relation.
relhaspkey bool   Vrai si la table a (ou a eu) une clé primaire.
relhasrules bool   Vrai si la table contient (ou a contenu) des règles ; voir le catalogue pg_rewrite.
relhastriggers bool   Vrai si la table a (ou a eu) des triggers ; voir le catalogue pg_trigger
relhassubclass bool   Vrai si au moins une table hérite ou a hérité de la table considérée.
relispopulated bool   Vrai si la relation est peuplée (ceci est vrai pour toutes les relations autres que certaines vues matérialisées)
relfrozenxid xid   Tous les ID de transaction avant celui-ci ont été remplacés par un ID de transaction permanent (« frozen »). Ceci est utilisé pour déterminer si la table doit être nettoyée (VACUUM) pour éviter un bouclage des ID de transaction (ID wraparound) ou pour compacter pg_clog. 0 (InvalidTransactionId) si la relation n'est pas une table.
relminmxid xid   Tous les identifiants de multitransactions avant celui-i ont été remplacés par un identifiant de transaction dans cette table. Ceci est utilisé pour tracer si la table a besoin d'être traitée par le VACUUM pour empêcher un bouclage des identifiants de multitransactions ou pour permettre à pg_clog d'être réduits. Cette colonne vaut zéro (InvalidTransactionId) si la relation n'est pas une table.
relacl aclitem[]   Droits d'accès ; voir GRANT(7) et REVOKE(7) pour plus de détails.
reloptions text[]   Options spécifiques de la méthode d'accès, représentées par des chaînes du type « motclé=valeur »

Plusieurs des drapeaux booléens dans pg_class sont maintenus faiblement : la valeur true est garantie s'il s'agit du bon état, mais elle pourrait ne pas être remise à false immédiatement quand la condition n'est plus vraie. Par exemple, relhasindex est configurée par CREATE INDEX mais n'est jamais remise à false par DROP INDEX. C'est VACUUM qui le fera relhasindex s'il découvre que la table n'a pas d'index. Cet arrangement évite des fenêtres de vulnérabilité et améliore la concurrence.