Skip to content

Commit

Permalink
Merge v12 beta 2
Browse files Browse the repository at this point in the history
  • Loading branch information
@gleu
gleu committed Jun 20, 2019
1 parent 9a64d8e commit 907dfd6
Show file tree
Hide file tree
Showing 25 changed files with 834 additions and 6,950 deletions.
271 changes: 258 additions & 13 deletions postgresql/catalogs.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@

<row>
<entry><link linkend="catalog-pg-am"><structname>pg_am</structname></link></entry>
<entry>méthodes d'accès aux index</entry>
<entry>méthodes d'accès aux relations</entry>
</row>

<row>
Expand Down Expand Up @@ -298,7 +298,12 @@

<row>
<entry><link linkend="catalog-pg-statistic-ext"><structname>pg_statistic_ext</structname></link></entry>
<entry>statistiques étendues de l'optimiseur de requêtes</entry>
<entry>statistiques étendues de l'optimiseur de requêtes (définitions)</entry>
</row>

<row>
<entry><link linkend="catalog-pg-statistic-ext-data"><structname>pg_statistic_ext_data</structname></link></entry>
<entry>statistiques étendues de l'optimiseur de requêtes (statistiques)</entry>
</row>

<row>
Expand Down Expand Up @@ -6661,6 +6666,30 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
l'utilisateur courant.
</para>

<para>
<structname>pg_statistic</structname> ne doit pas être lisible par le
public, car même les informations statistiques sur le contenu de la table
pourraient être considérées comme sensibles. (Par exemple, les valeurs
minimale et maximale de la colonne salaire pourraient être très
intéressantes.) <link
linkend="view-pg-stats"><structname>pg_stats</structname></link> est une
vue, lisible par tout le monde, interrogeant
<structname>pg_statistic</structname> en exposant uniquement les
informations sur les tables visibles par l'utilisateur courant.
</para>

<para>
De la même façon, <structname>pg_statistic_ext_data</structname> ne doit
pas être lisible par tout le monde car son contenu peut être considéré
comme sensible. (Par exemple, les combinaisons de valeurs les plus communes
des colonnes pourraient être intéressantes.) <link
linkend="view-pg-stats-ext"><structname>pg_stats_ext</structname></link>
est une vue, lisible par tout le monde, interrogeant
<structname>pg_statistic_ext_data</structname> (après une jointure sur
<structname>pg_statistic_ext</structname>) en exposant uniquement les
informations sur les tables et colonnes visibles par l'utilisateur courant.
</para>

<table>
<title>Colonnes de <structname>pg_statistic</structname></title>

Expand Down Expand Up @@ -6809,7 +6838,7 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl

<para>
Le catalogue <structname>pg_statistic_ext</structname> contient des
statistiques étendues pour l'optimiseur de requêtes. Chaque ligne de ce
définitions des statistiques étendues pour l'optimiseur de requêtes. Chaque ligne de ce
catalogue correspond à un <firstterm>objet statistique</firstterm> créé
avec <xref linkend="sql-createstatistics"/>.
</para>
Expand Down Expand Up @@ -6882,9 +6911,58 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
<acronym>MCV</acronym>).
</entry>
</row>
</tbody>
</tgroup>
</table>

<para>
Le champ <structfield>stxkind</structfield> est rempli à la création de
l'objet statistique, indiquant le (ou les) type(s) de statistiques
désiré(s). Les statistiques (une fois calculées par
<command>ANALYZE</command>) sont enregistrées dans le catalogue <link
linkend="catalog-pg-statistic-ext-data"><structname>pg_statistic_ext_data</structname></link>.
</para>
</sect1>

<sect1 id="catalog-pg-statistic-ext-data">
<title><structname>pg_statistic_ext_data</structname></title>

<indexterm zone="catalog-pg-statistic-ext">
<primary>pg_statistic_ext_data</primary>
</indexterm>

<para>
Le catalogue <structname>pg_statistic_ext_data</structname> contient les
données pour les statistiques étendues de l'optimiseur, définies dans
<structname>pg_statistic_ext</structname>. Chaque ligne de ce catalogue
correspond à un <firstterm>objet statistique</firstterm> créé avec <xref
linkend="sql-createstatistics"/>.
</para>

<table>
<title>Colonnes de <structname>pg_statistic_ext_data</structname></title>

<tgroup cols="4">
<thead>
<row>
<entry>Nom</entry>
<entry>Type</entry>
<entry>Référence</entry>
<entry>Description</entry>
</row>
</thead>

<tbody>

<row>
<entry><structfield>stxoid</structfield></entry>
<entry><type>oid</type></entry>
<entry><literal><link linkend="catalog-pg-statistic-ext"><structname>pg_statistic_ext</structname></link>.oid</literal></entry>
<entry>Statistique étendue contenant la définition pour cette donnée.</entry>
</row>

<row>
<entry><structfield>stxndistinct</structfield></entry>
<entry><structfield>stxdndistinct</structfield></entry>
<entry><type>pg_ndistinct</type></entry>
<entry></entry>
<entry>
Expand All @@ -6894,7 +6972,7 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
</row>

<row>
<entry><structfield>stxdependencies</structfield></entry>
<entry><structfield>stxddependencies</structfield></entry>
<entry><type>pg_dependencies</type></entry>
<entry></entry>
<entry>
Expand All @@ -6904,7 +6982,7 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
</row>

<row>
<entry><structfield>stxmcv</structfield></entry>
<entry><structfield>stxdmcv</structfield></entry>
<entry><type>pg_mcv_list</type></entry>
<entry></entry>
<entry>
Expand All @@ -6916,13 +6994,6 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
</tbody>
</tgroup>
</table>

<para>
Le champ <structfield>stxkind</structfield> est rempli à la création de
l'objet statistique, indiquant les types de statistique désirés. Les champs
suivants sont initialement à zéro et seulement remplis quand la statistique
correspondante a été calculée par <command>ANALYZE</command>.
</para>
</sect1>

<sect1 id="catalog-pg-subscription">
Expand Down Expand Up @@ -8694,6 +8765,11 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
<entry>statistiques du planificateur</entry>
</row>

<row>
<entry><link linkend="view-pg-stats-ext"><structname>pg_stats_ext</structname></link></entry>
<entry>statistiques étendues du planificateur</entry>
</row>

<row>
<entry><link linkend="view-pg-tables"><structname>pg_tables</structname></link></entry>
<entry>tables</entry>
Expand Down Expand Up @@ -11406,6 +11482,175 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx

</sect1>

<sect1 id="view-pg-stats-ext">
<title><structname>pg_stats_ext</structname></title>

<indexterm zone="view-pg-stats-ext">
<primary>pg_stats_ext</primary>
</indexterm>

<para>
La vue <structname>pg_stats_ext</structname> fournit un accès aux
informations enregistrées dans les catalogues <link
linkend="catalog-pg-statistic-ext"><structname>pg_statistic_ext</structname></link>
et <link
linkend="catalog-pg-statistic-ext-data"><structname>pg_statistic_ext_data</structname></link>.
Cette vue autorise l'accès aux seules lignes de
<structname>pg_statistic_ext</structname> et
<structname>pg_statistic_ext_data</structname> correspondant aux tables que
l'utilisateur a le droit de lire et, du coup, l'accès public à cette vue ne
pose pas de problème de sécurité.
</para>

<para>
<structname>pg_stats_ext</structname> est aussi conçu pour présenter les
informations dans un format plus lisible que celles du catalogue
sous-jacent &mdash; son schéma doit cependant être étendu quand de nouveaux
types de statistiques étendues sont ajoutés à
<structname>pg_statistic_ext</structname>.
</para>

<table>
<title>Colonnes de <structname>pg_stats_ext</structname></title>

<tgroup cols="4">
<thead>
<row>
<entry>Nom</entry>
<entry>Type</entry>
<entry>Référence</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
<row>
<entry><structfield>schemaname</structfield></entry>
<entry><type>name</type></entry>
<entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.nspname</literal></entry>
<entry>Nom du schéma contenant la table</entry>
</row>

<row>
<entry><structfield>tablename</structfield></entry>
<entry><type>name</type></entry>
<entry><literal><link linkend="catalog-pg-class"><structname>pg_class</structname></link>.relname</literal></entry>
<entry>Nom de la table</entry>
</row>

<row>
<entry><structfield>statistics_schemaname</structfield></entry>
<entry><type>name</type></entry>
<entry><literal><link linkend="catalog-pg-namespace"><structname>pg_namespace</structname></link>.nspname</literal></entry>
<entry>Nom du schéma contenant la statistique étendue</entry>
</row>

<row>
<entry><structfield>statistics_name</structfield></entry>
<entry><type>name</type></entry>
<entry><literal><link linkend="catalog-pg-statistic-ext"><structname>pg_statistic_ext</structname></link>.stxname</literal></entry>
<entry>Nom des statistiques étendues</entry>
</row>

<row>
<entry><structfield>statistics_owner</structfield></entry>
<entry><type>oid</type></entry>
<entry><literal><link linkend="catalog-pg-authid"><structname>pg_authid</structname></link>.oid</literal></entry>
<entry>Propriétaire des statistiques étendues</entry>
</row>

<row>
<entry><structfield>attnames</structfield></entry>
<entry><type>name[]</type></entry>
<entry><literal><link linkend="catalog-pg-attribute"><structname>pg_attribute</structname></link>.attname</literal></entry>
<entry>Noms des colonnes sur lesquelles portent les statistiques étendues</entry>
</row>

<row>
<entry><structfield>kinds</structfield></entry>
<entry><type>text[]</type></entry>
<entry></entry>
<entry>Types des statistiques étendues activées pour cet
enregistrement</entry> </row>

<row>
<entry><structfield>n_distinct</structfield></entry>
<entry><type>pg_ndistinct</type></entry>
<entry></entry>
<entry>
Nombre de valeurs distinctes pour la combinaison de colonnes. Si
supérieur à zéro, le nombre estimé de valeurs distinctes dans la
combinaison. Si inférieur à zéro, le négatif du nombre de valeurs
distinctes divisé par le nombre de lignes. (La forme négative est
utilisée quand <command>ANALYZE</command> croit que le nombre de
valeurs distinctes pourrait bien grossir en même temps que la
table&nbsp;; la forme positive est utilisée quand la colonne semble
avoir un nombre fixe de valeurs possibles.) Par exemple, -1 indique une
combinaison unique de colonnes pour laquelle le nombre de combinaisons
distinctes est identique au nombre de lignes.
</entry>
</row>

<row>
<entry><structfield>dependencies</structfield></entry>
<entry><type>pg_dependencies</type></entry>
<entry></entry>
<entry>Statistiques de dépendance fonctionnelle</entry>
</row>

<row>
<entry><structfield>most_common_vals</structfield></entry>
<entry><type>anyarray</type></entry>
<entry></entry>
<entry>
Une liste des combinaisons les plus communes dans les colonnes. (NULL
si aucune valeur n'est plus commune que les autres.)
</entry>
</row>

<row>
<entry><structfield>most_common_val_nulls</structfield></entry>
<entry><type>anyarray</type></entry>
<entry></entry>
<entry>
Une liste de drapeaux NULL pour les combinaisons les plus communes de
valeurs. (NULL quand <structfield>most_common_vals</structfield>
l'est.)
</entry>
</row>

<row>
<entry><structfield>most_common_freqs</structfield></entry>
<entry><type>real[]</type></entry>
<entry></entry>
<entry>
Une liste des fréquences des combinaisons les plus communes, autrement
dit le nombre d'occurences de chacune divisé par le nombre total de
lignes. (NULL quand <structfield>most_common_vals</structfield> l'est.)
</entry>
</row>

<row>
<entry><structfield>most_common_base_freqs</structfield></entry>
<entry><type>real[]</type></entry>
<entry></entry>
<entry>
Une liste des fréquences de base des combinaisons les plus communes,
autrement dit un produit des fréquences par valeur. (NULL quand
<structfield>most_common_vals</structfield> l'est.)
</entry>
</row>
</tbody>
</tgroup>
</table>

<para>
Le nombre maximum d'entrées dans le tableau peut être contrôlé sur une base
par colonne en utilisant la commande <command>ALTER TABLE SET
STATISTICS</command> ou globalement en configurant le paramètre <xref
linkend="guc-default-statistics-target"/>.
</para>
</sect1>

<sect1 id="view-pg-tables">
<title><structname>pg_tables</structname></title>

Expand Down

0 comments on commit 907dfd6

Please sign in to comment.