49.14. pg_constraint
Le catalogue pg_constraint stocke les vérifications, clés primaires, clés uniques, étrangères et d'exclusion des tables. (Les contraintes de colonnes ne sont pas traitées de manière particulière. Elles sont équivalentes à des contraintes de tables.) Les contraintes NOT NULL sont représentées dans le catalogue pg_attribute, pas ici.
Les triggers de contraintes définies par des utilisateurs (créés avec CREATE CONSTRAINT TRIGGER) ont aussi une entrée dans cette table.
Les contraintes de vérification de domaine sont également stockées dans ce catalogue.
Tableau 49.14. Colonnes de pg_constraint
| Nom | Type | Références | Description |
|---|---|---|---|
| oid | oid | Identifiant de ligne (attribut caché ; doit être sélectionné explicitement) | |
| conname | name | Nom de la contrainte (pas nécessairement unique !) | |
| connamespace | oid | pg_namespace.oid | OID du namespace qui contient la contrainte. |
| contype | char | c = contrainte de vérification, f = contrainte de clé étrangère, p = contrainte de clé primaire, u = contrainte d'unicité, t = contrainte trigger, x = contrainte d'exclusion | |
| condeferrable | bool | La contrainte peut-elle être retardée (deferable) ? | |
| condeferred | bool | La contrainte est-elle retardée par défaut ? | |
| convalidated | bool | La contrainte a-t-elle été validée ? actuellement, peut seulement valoir false pour les clés étrangères et les contraintes CHECK | |
| conrelid | oid | pg_class.oid | Table à laquelle appartient la contrainte ; 0 si ce n'est pas une contrainte de table. |
| contypid | oid | pg_type.oid | Domaine auquel appartient la contrainte ; 0 si ce n'est pas une contrainte de domaine. |
| conindid | oid | pg_class.oid | L'index qui force cette contrainte (unique, clé primaire, clé étrangère, d'exclusion) ; sinon 0 |
| confrelid | oid | pg_class.oid | Si c'est une clé étrangère, la table référencée ; sinon 0 |
| confupdtype | char | Code de l'action de mise à jour de la clé étrangère : a = no action, r = restrict, c = cascade, n = set null, d = set default | |
| confdeltype | char | Code de l'action de suppression de clé étrangère : a = no action, r = restrict, c = cascade, n = set null, d = set default | |
| confmatchtype | char | Type de concordance de la clé étrangère : f = full, p = partial, s = simple | |
| conislocal | bool | Cette contrainte est définie localement dans la relation. Notez qu'une contrainte peut être définie localement et héritée simultanément | |
| coninhcount | int4 | Le nombre d'ancêtres d'héritage directs que cette contraite possède. Une contrainte avec un nombre non nul d'ancêtres ne peut être ni supprimée ni renommée. | |
| connoinherit | bool | Cette contrainte est définie localement pour la relation. C'est une contrainte non héritable. | |
| conkey | int2[] | pg_attribute.attnum | S'il s'agit d'une contrainte de table (incluant les clés étrangères mais pas les triggers de contraintes), liste des colonnes contraintes |
| confkey | int2[] | pg_attribute.attnum | S'il s'agit d'une clé étrangère, liste des colonnes référencées |
| conpfeqop | oid[] | pg_operator.oid | S'il s'agit d'une clé étrangère, liste des opérateurs d'égalité pour les comparaisons clé primaire/clé étrangère |
| conppeqop | oid[] | pg_operator.oid | S'il s'agit d'une clé étrangère, liste des opérateurs d'égalité pour les comparaisons clé primaire/clé primaire |
| conffeqop | oid[] | pg_operator.oid | S'il s'agit d'une clé étrangère, liste des opérateurs d'égalité pour les comparaisons clé étrangère/clé étrangère |
| conexclop | oid[] | pg_operator.oid | Si une contrainte d'exclusion, liste les opérateurs d'exclusion par colonne |
| conbin | pg_node_tree | S'il s'agit d'une contrainte de vérification, représentation interne de l'expression | |
| consrc | text | S'il s'agit d'une contrainte de vérification, représentation compréhensible de l'expression |
Dans le cas d'une contrainte d'exclusion, conkey est seulement utile pour les éléments contraints qui sont de simples références de colonnes. Dans les autres cas, un zéro apparaît dans conkey et l'index associé doit être consulté pour découvrir l'expression contrainte. (du coup, conkey a le même contenu que pg_index.indkey pour l'index.)
![[Note]](images/note.png)
Note
consrc n'est pas actualisé lors de la modification d'objets référencés ; par exemple, il ne piste pas les renommages de colonnes. Plutôt que se fier à ce champ, il est préférable d'utiliser pg_get_constraintdef() pour extraire la définition d'une contrainte de vérification.
Note
pg_class.relchecks doit accepter le même nombre de contraintes de vérification pour chaque relation.
pg_collation
