Documentation PostgreSQL 14.22 » Internes » Catalogues système » `pg_stats_ext_exprs`

Précédent | Niveau supérieur | Suivant
52.90. `pg_stats_ext` | Sommaire | 52.92. `pg_tables`

## 52.91. `pg_stats_ext_exprs`

La vue `pg_stats_ext_exprs` fournit un accès aux informations sur toutes les expressions incluses dans les objets de statistiques étendues, combinant des informations enregistrées dans les catalogues `pg_statistic_ext` et `pg_statistic_ext_data`. Cette vue donne accès seulement aux lignes de `pg_statistic_ext` et `pg_statistic_ext_data` qui correspondent aux tables dont l'utilisateur est le propriétaire, et qu'il est de ce fait sûr de permettre un accès en lecture pour cette vue.

`pg_stats_ext_exprs` est aussi conçu pour présenter l'information dans un format plus lisible que les catalogues sous-jacents -- au coût que ce schéma doit être étendu quand la structure des statistiques change dans `pg_statistic_ext`.

Tableau 52.92. Colonnes de `pg_stats_ext_exprs`

Type de colonne Description
`schemaname` `name` (references `pg_namespace`.`nspname`) Nom du schéma contenant la table
`tablename` `name` (references `pg_class`.`relname`) Nom de la table sur laquelle l'objet de statistiques est défini
`statistics_schemaname` `name` (references `pg_namespace`.`nspname`) Nom du schéma contenant l'objet de statistiques
`statistics_name` `name` (references `pg_statistic_ext`.`stxname`) Nom de l'objet de statistique étendu
`statistics_owner` `name` (references `pg_authid`.`rolname`) Propriétaire de l'objet de statistique étendu
`expr` `text` Expression incluse dans l'objet de statistique étendu
`null_frac` `float4` Fraction des entrées NULL de l'expression
`avg_width` `int4` Taille moyenne en octets des entrées de l'expression
`n_distinct` `float4` Si supérieur à zéro, le nombre estimé de valeurs distinctes dans l'expression. Si inférieur à zéro, le négatif du nombre de valeurs distinctes divisé par le nombre de lignes. (La forme inverse est utilisé quand `ANALYZE` croit que le nombre de valeurs distinctes va augmenter en même temps que la table grossit ; la forme positive est utilisée quand l'expression semble avoir un nombre fixe de valeurs possibles.) Par exemple, -1 indique une expression unique pour laquelle le nombre de valeurs distinctes est identique au nombre de lignes.
`most_common_vals` `anyarray` Une liste des valeurs les plus communes de l'expression. (NULL si aucune valeur ne semble plus commune que les autres.)
`most_common_freqs` `float4[]` Une liste des fréquences des valeurs les plus communes, autrement dit nombre d'occurences de chaque divisé par nombre total de lignes. (NULL quand `most_common_vals` l'est.)
`histogram_bounds` `anyarray` Une liste des valeurs qui divisent les valeurs de l'expression en groupes de population approximativement identique. Les valeurs dans `most_common_vals`, si présent, sont omises de ce calcul d'histogramme. (Cette expression est NULL si le type de données de l'expression n'a pas d'opérateur `<` ou si la liste `most_common_vals` contint la population entière.)
`correlation` `float4` Corrélation statistique entre l'ordre physique des lignes et l'ordre logique des valeurs de l'expression. Ceci va de -1 à +1. Lorsque la valeur est proche de -1 ou +1, un parcours de l'index sur l'expression est estimé moins coûteux que si cette valeur tend vers 0, à cause de la réduction du nombre d'accès aléatoires au disque. (Cette expression est NULL si le type de données de l'expression ne dispose pas de l'opérateur `<`.)
`most_common_elems` `anyarray` Une liste de valeurs éléments non NULL apparaissant le plus fréquence dans les valeurs de l'expression. (NULL pour les types scalaires.)
`most_common_elem_freqs` `float4[]` Une liste des fréquences des valeurs d'éléments les plus communes, autrement dit la fraction des lignes contenant au moins une instance de la valeur donnée. Deux ou trois valeurs supplémentaires suivent les fréquences par élément ; ce sont les minimum et maximum des fréquences précédentes par élément, et optionnellement lafréquence des éléments NULL. (NULL quand `most_common_elems` l'est.)
`elem_count_histogram` `float4[]` Un histogramme du nombre de valeurs d'éléments distinctes nonNULL parmi les valeurs de l'expression, suivi par le nombre moyen d'éléments distincts non NULL. (NULL pour les types scalaires.)

Le nombre maximum d'entrées dans les champs de type tableau peut être contrôlé colonne par colonne en utilisant l'instruction column-by-column basis using the `ALTER TABLE SET STATISTICS` ou globalement en configurant le paramètre default_statistics_target.