Skip to content

Commit

Permalink
Merge v13 beta 2
Browse files Browse the repository at this point in the history
  • Loading branch information
@gleu
gleu committed Jul 3, 2020
1 parent bdc28f4 commit 5e19569
Show file tree
Hide file tree
Showing 39 changed files with 1,697 additions and 962 deletions.
58 changes: 58 additions & 0 deletions postgresql/biblio.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -232,6 +232,64 @@ ssimkovi@ag.or.at
<bibliodiv>
<title>Procédures et articles</title>

<biblioentry id="ports12">
<biblioset relation="article">
<title><ulink url="https://arxiv.org/pdf/1208.4179">Serializable Snapshot Isolation in PostgreSQL</ulink></title>
<authorgroup>
<author>
<firstname>D.</firstname>
<surname>Ports</surname>
</author>
<author>
<firstname>K.</firstname>
<surname>Grittner</surname>
</author>
</authorgroup>
</biblioset>
<confgroup>
<conftitle>VLDB Conference</conftitle>
<confdates>August 2012</confdates>
<address>Istanbul, Turkey</address>
</confgroup>
</biblioentry>

<biblioentry id="berenson95">
<biblioset relation="article">
<title><ulink url="https://www.microsoft.com/en-us/research/wp-content/uploads/2016/02/tr-95-51.pdf">A Critique of ANSI SQL Isolation Levels</ulink></title>
<authorgroup>
<author>
<firstname>H.</firstname>
<surname>Berenson</surname>
</author>
<author>
<firstname>P.</firstname>
<surname>Bernstein</surname>
</author>
<author>
<firstname>J.</firstname>
<surname>Gray</surname>
</author>
<author>
<firstname>J.</firstname>
<surname>Melton</surname>
</author>
<author>
<firstname>E.</firstname>
<surname>O'Neil</surname>
</author>
<author>
<firstname>P.</firstname>
<surname>O'Neil</surname>
</author>
</authorgroup>
</biblioset>
<confgroup>
<conftitle>ACM-SIGMOD Conference on Management of Data</conftitle>
<confdates>June 1995</confdates>
<address>San Jose, California</address>
</confgroup>
</biblioentry>

<biblioentry id="olson93">
<title>Partial indexing in POSTGRES: research project</title>
<authorgroup>
Expand Down
36 changes: 32 additions & 4 deletions postgresql/brin.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -514,7 +514,6 @@ LOG: request for BRIN range summarization for index "brin_wi_idx" page 128 was
<para>
Il y a quatre méthodes qu'un opérateur de classe pour <acronym>BRIN</acronym>
doit fournir&nbsp;:
</para>

<variablelist>
<varlistentry>
Expand Down Expand Up @@ -588,9 +587,38 @@ typedef struct BrinOpcInfo
</varlistentry>
</variablelist>

<para>
La distribution du noyau inclut du support pour les deux types de classe
d'opérateur&nbsp;: minmax et inclusion.
An operator class for <acronym>BRIN</acronym> can optionally specify the
following method:

<variablelist>
<varlistentry>
<term><function>void options(local_relopts *relopts)</function></term>
<listitem>
<para>
Defines a set of user-visible parameters that control operator class
behavior.
</para>

<para>
The <function>options</function> function is passed a pointer to a
<replaceable>local_relopts</replaceable> struct, which needs to be
filled with a set of operator class specific options. The options
can be accessed from other support functions using the
<literal>PG_HAS_OPCLASS_OPTIONS()</literal> and
<literal>PG_GET_OPCLASS_OPTIONS()</literal> macros.
</para>

<para>
Since both key extraction of indexed values and representation of the
key in <acronym>GIN</acronym> are flexible, they may depend on
user-specified parameters.
</para>
</listitem>
</varlistentry>
</variablelist>

La distribution du noyau inclut du support pour les deux types de classe
d'opérateur&nbsp;: minmax et inclusion.

Les définitions de classes d'opérateur qui les utilisent sont envoyées en
types de données basiques appropriées.
Expand Down
94 changes: 74 additions & 20 deletions postgresql/btree.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -220,7 +220,7 @@

<para>
Comme montré dans <xref linkend="xindex-btree-support-table"/>, btree définit
une fonction de support obligatoire et trois facultatives. Les quatre
une fonction de support obligatoire et quatre facultatives. Les cinq
méthodes définies par l'utilisateur sont&nbsp;:
</para>

Expand Down Expand Up @@ -557,6 +557,40 @@ equalimage(<replaceable>opcintype</replaceable> <type>oid</type>) returns bool
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><function>options</function></term>
<listitem>
<para>
Optionally, a B-tree operator family may provide
<function>options</function> (<quote>operator class specific
options</quote>) support functions, registered under support
function number 5. These functions define a set of user-visible
parameters that control operator class behavior.
</para>
<para>
An <function>options</function> support function must have the
signature
<synopsis>
options(<replaceable>relopts</replaceable> <type>local_relopts *</type>) returns void
</synopsis>
The function is passed a pointer to a <replaceable>local_relopts</replaceable>
struct, which needs to be filled with a set of operator class
specific options. The options can be accessed from other support
functions using the <literal>PG_HAS_OPCLASS_OPTIONS()</literal> and
<literal>PG_GET_OPCLASS_OPTIONS()</literal> macros.
</para>
<para>
Currently, no B-Tree operator class has an <function>options</function>
support function. B-tree doesn't allow flexible representation of keys
like GiST, SP-GiST, GIN and BRIN do. So, <function>options</function>
probably doesn't have much application in the current B-tree index
access method. Nevertheless, this support function was added to B-tree
for uniformity, and will probably find uses during further
evolution of B-tree in <productname>PostgreSQL</productname>.
</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>

Expand Down Expand Up @@ -616,7 +650,7 @@ equalimage(<replaceable>opcintype</replaceable> <type>oid</type>) returns bool
Un doublon est un tuple de page feuille (un tuple qui pointe sur un
enregistrement en table) où <emphasis>toutes</emphasis> les valeurs des
colonnes clés de l'index correspondent aux valeurs de colonnes respectives
d'au moins un autre tuple de page feuille à proximité dans le même index.
d'au moins un autre tuple de page feuille dans le même index.
Les tuples doublons sont assez communs en pratique. Les index B-Tree
peuvent utiliser une représentation spéciale gérant efficacement l'espace
pour les doublons lorsqu'une fonctionalité est activée : le
Expand All @@ -639,13 +673,13 @@ equalimage(<replaceable>opcintype</replaceable> <type>oid</type>) returns bool

<note>
<para>
Alors que NULL n'est généralement pas considéré comme égal à n'importe
quelle autre valeur, NULL inclus, NULL est cependant traité juste comme
une autre valeur pour le périmètre des valeurs indexées dans
l'implémentation B-Tree (sauf dans le cas où la contrainte d'unicité est
appliquée dans un index unique). Le dédoublement B-Tree est par conséquent
tout autant efficace avec les <quote>doublons</quote> qui contiennent une
valeur NULL.
B-Tree deduplication is just as effective with
<quote>duplicates</quote> that contain a NULL value, even though
NULL values are never equal to each other according to the
<literal>=</literal> member of any B-Tree operator class. As far
as any part of the implementation that understands the on-disk
B-Tree structure is concerned, NULL is just another value from the
domain of indexed values.
</para>
</note>

Expand All @@ -663,6 +697,21 @@ equalimage(<replaceable>opcintype</replaceable> <type>oid</type>) returns bool
est activé par défaut.
</para>

<para>
<command>CREATE INDEX</command> and <command>REINDEX</command>
apply deduplication to create posting list tuples, though the
strategy they use is slightly different. Each group of duplicate
ordinary tuples encountered in the sorted input taken from the
table is merged into a posting list tuple
<emphasis>before</emphasis> being added to the current pending leaf
page. Individual posting list tuples are packed with as many
<acronym>TID</acronym>s as possible. Leaf pages are written out in
the usual way, without any separate deduplication pass. This
strategy is well-suited to <command>CREATE INDEX</command> and
<command>REINDEX</command> because they are once-off batch
operations.
</para>

<para>
Les charges de travail majoritaires en écriture et qui ne bénéficient pas
du dédoublement du fait qu'il y a peu ou pas de doublons dans les index,
Expand All @@ -680,17 +729,22 @@ equalimage(<replaceable>opcintype</replaceable> <type>oid</type>) returns bool
Pour les index B-Tree, sous MVCC, il peut y avoir plusieurs versions
existantes du même enregistrement logique en table&nbsp;; pour un index,
chaque tuple est un objet indépendant qui nécessite sa propre entrée dans
l'index. Ainsi, la mise à jour d'un enregistrement crée toujours de
nouvelles entrées pour l'enregistrement, même si les valeurs des clés ne
changent pas. Certains types de charges de travail peuvent être impactées
par l'inflation d'index causée par les doublons de version causés par cette
implémentation (c'est un problème typique pour les charges de travail
majoritairement dues aux <command>UPDATE</command> ne pouvant pas appliquer
l'optimisation <acronym>HOT</acronym> car elles modifient au moins une
colonne d'index). Le dédoublement B-Tree ne distingue pas entre les
doublons de version dus à l'implémentation MVCC et les doublons
conventionnels. Le dédoublement peut cependant aider au contrôle de
l'inflation d'index causée par l'implémentation du versionement.
l'index. <quote>Version duplicates</quote> may sometimes accumulate
and adversely affect query latency and throughput. This typically
occurs with <command>UPDATE</command>-heavy workloads where most
individual updates cannot apply the <acronym>HOT</acronym>
optimization (often because at least one indexed column gets
modified, necessitating a new set of index tuple versions &mdash;
one new tuple for <emphasis>each and every</emphasis> index). In
effect, B-Tree deduplication ameliorates index bloat caused by
version churn. Note that even the tuples from a unique index are
not necessarily <emphasis>physically</emphasis> unique when stored
on disk due to version churn. The deduplication optimization is
selectively applied within unique indexes. It targets those pages
that appear to have version duplicates. The high level goal is to
give <command>VACUUM</command> more time to run before an
<quote>unnecessary</quote> page split caused by version churn can
take place.
</para>

<tip>
Expand Down
22 changes: 12 additions & 10 deletions postgresql/catalogs.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2173,7 +2173,9 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
<literal>d</literal> = par défaut (clé primaire, si présente),
<literal>n</literal> = rien,
<literal>f</literal> = toutes les colonnes
<literal>i</literal> = index avec <structfield>indisreplident</structfield> configuré, ou par défaut
<literal>i</literal> = index avec
<structfield>indisreplident</structfield> configuré (identique à rien
si l'index utilisé a été supprimé)
</para></entry>
</row>

Expand Down Expand Up @@ -9548,13 +9550,13 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
</row>

<row>
<entry><link linkend="view-pg-stats"><structname>pg_stats</structname></link></entry>
<entry>statistiques du planificateur</entry>
<entry><link linkend="view-pg-shmem-allocations"><structname>pg_shmem_allocations</structname></link></entry>
<entry>allocations de mémoire partagée</entry>
</row>

<row>
<entry><link linkend="view-pg-shmem-allocations"><structname>pg_shmem_allocations</structname></link></entry>
<entry>allocations de mémoire partagée</entry>
<entry><link linkend="view-pg-stats"><structname>pg_stats</structname></link></entry>
<entry>statistiques du planificateur</entry>
</row>

<row>
Expand Down Expand Up @@ -10738,12 +10740,12 @@ SCRAM-SHA-256$<replaceable>&lt;nombre d'itération&gt;</replaceable>:<replaceabl
</para>

<para>
La colonne
<structfield>pid</structfield> peut être jointe à la colonne
La colonne <structfield>pid</structfield> peut être jointe à la colonne
<structfield>pid</structfield> de la vue <link
linkend="pg-stat-activity-view"><structname>pg_stat_activity</structname></link> pour obtenir plus
d'informations sur la session qui détient ou attend un verrou,
par exemple&nbsp;:
linkend="monitoring-pg-stat-activity-view">
<structname>pg_stat_activity</structname></link> pour obtenir plus
d'informations sur la session qui détient ou attend un verrou, par
exemple&nbsp;:
<programlisting>
SELECT * FROM pg_locks pl LEFT JOIN pg_stat_activity psa
ON pl.pid = psa.pid;
Expand Down
33 changes: 17 additions & 16 deletions postgresql/client-auth.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -91,17 +91,19 @@
échoue, les enregistrements suivants ne sont pas considérés. Si aucun
enregistrement ne correspond, l'accès est refusé.</para>

<para>Un enregistrement peut avoir l'un des sept formats suivants.
<para>Un enregistrement peut avoir différents formats&nbsp;:
<synopsis>
local <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
host <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>address</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
hostssl <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>address</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
hostnossl <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>address</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
host <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>IP-address</replaceable> <replaceable>IP-mask</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
hostssl <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>IP-address</replaceable> <replaceable>IP-mask</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
hostnossl <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>IP-address</replaceable> <replaceable>IP-mask</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
hostgssenc <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>IP-address</replaceable> <replaceable>IP-mask</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
hostnogssenc <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>IP-address</replaceable> <replaceable>IP-mask</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
+local <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
+host <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>address</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
+hostssl <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>address</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
+hostnossl <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>address</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
+hostgssenc <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>address</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
+hostnogssenc <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>address</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
+host <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>IP-address</replaceable> <replaceable>IP-mask</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
+hostssl <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>IP-address</replaceable> <replaceable>IP-mask</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
+hostnossl <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>IP-address</replaceable> <replaceable>IP-mask</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
+hostgssenc <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>IP-address</replaceable> <replaceable>IP-mask</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
+hostnogssenc <replaceable>database</replaceable> <replaceable>user</replaceable> <replaceable>IP-address</replaceable> <replaceable>IP-mask</replaceable> <replaceable>auth-method</replaceable> <optional><replaceable>auth-options</replaceable></optional>
</synopsis>

La signification des champs est la suivante&nbsp;:
Expand Down Expand Up @@ -357,9 +359,8 @@ hostnogssenc <replaceable>database</replaceable> <replaceable>user</replaceable
</para>

<para>
Ce champ ne concerne que les enregistrements
<literal>host</literal>, <literal>hostssl</literal> et
<literal>hostnossl</literal>.
Ces champs ne concernent pas les enregistrements
<literal>local</literal>.
</para>

<note>
Expand Down Expand Up @@ -411,9 +412,9 @@ hostnogssenc <replaceable>database</replaceable> <replaceable>user</replaceable
masque de 32.
</para>

<para>Ces champs ne concernent que les enregistrements
<literal>host</literal>, <literal>hostssl</literal> et
<literal>hostnossl</literal>.
<para>
Ces champs ne concernent pas les enregistrements
<literal>local</literal>.
</para>
</listitem>
</varlistentry>
Expand Down

0 comments on commit 5e19569

Please sign in to comment.