 Catalogues système
|
 
|
pg_am
|
Le catalogue pg_aggregate stocke les informations concernant les fonctions d'agrégat. Une fonction d'agrégat est une fonction qui opère sur un ensemble de données (typiquement une colonne de chaque ligne qui correspond à une condition de requête) et retourne une valeur unique calculée à partir de toutes ces valeurs. Les fonctions d'agrégat classiques sont sum (somme), count (compteur) et max (plus grande valeur). Chaque entrée de pg_aggregate est une extension d'une entrée de pg_proc. L'entrée de pg_proc contient le nom de l'agrégat, les types de données d'entrée et de sortie, et d'autres informations similaires aux fonctions ordinaires.
Tableau 49.2. Les colonnes de pg_aggregate
| Nom | Type | Références | Description |
|---|---|---|---|
| aggfnoid | regproc | pg_proc.oid | OID pg_proc de la fonction d'agrégat |
| aggkind | char | Type d'agrégat : n pour les agrégats « normaux » (standards), o pour les agrégats d'« ensemble trié », ou h pour les agrégats d'« ensembles hypothétiques » | |
| aggnumdirectargs | int2 | Nombre d'arguments directs (non agrégés) d'un ensemble trié ou d'un ensemble hypothétique, comptant un tableau variadique comme un seul argument. Si cette valeur est égale à pronargs, l'agrégat doit être variadique et le tableau variadique décrit aussi les arguments agrégés ainsi que les arguments directs finaux. Toujours à 0 pour les agrégats standards. | |
| aggtransfn | regproc | pg_proc.oid | Fonction de transition |
| aggfinalfn | regproc | pg_proc.oid | Fonction finale (0 s'il n'y en a pas) |
| aggmtransfn | regproc | pg_proc.oid | Fonction de transition en avant pour le mode d'agrégat avec déplacement (zéro sinon) |
| aggminvtransfn | regproc | pg_proc.oid | Fonction de transition inverse pour le mode d'agrégat avec déplacement (zéro sinon) |
| aggmfinalfn | regproc | pg_proc.oid | Fonction finale pour le mode d'agrégat avec déplacement (zéro sinon) |
| aggfinalextra | bool | Vrai pour passer des arguments supplémentaires à aggfinalfn | |
| aggmfinalextra | bool | Vrai pour passer des arguments supplémentaires à aggmfinalfn | |
| aggsortop | oid | pg_operator.oid | Opérateur de tri associé (0 s'il n'y en a pas) |
| aggtranstype | oid | pg_type.oid | Type de la donnée interne de transition (état) de la fonction d'agrégat |
| aggtransspace | int4 | Taille moyenne approximative (en octets) des données de l'état de transition, ou zéro pour utiliser une estimation par défaut | |
| aggmtranstype | oid | pg_type.oid | Type de données de la transition interne (état) de la fonction d'agrégat pour le mode d'agrégat avec déplacement (zéro sinon) |
| aggmtransspace | int4 | Taille moyenne approximative (en octets) des données d'état de transition pour le mode d'agrégat avec déplacement ou zéro pour utiliser une estimation par défaut | |
| agginitval | text | Valeur initiale de la fonction de transition. C'est un champ texte qui contient la valeur initiale dans sa représentation externe en chaîne de caractères. Si ce champ est NULL, la valeur d'état de transition est initialement NULL. | |
| aggminitval | text | La valeur initiale de l'état de transition pour le mode d'agrégat avec déplacement. C'est un champ texte contenant la valeur initiale dans sa représentation externe sous forme de chaîne. Si ce champ est NULL, la valeur de l'état de transition commence avec NULL. |
Les nouvelles fonctions d'agrégat sont enregistrées avec la commande CREATE AGGREGATE(7). La Section 35.10, « Agrégats utilisateur » fournit de plus amples informations sur l'écriture des fonctions d'agrégat et sur la signification des fonctions de transition.