Skip to content

Commit

Permalink
Merge v13, première partie
Browse files Browse the repository at this point in the history
Il manque les quatre fichiers ayant subi le plus de modifications.
  • Loading branch information
gleu committed Jun 4, 2020
1 parent 45e9a30 commit 4906e30
Show file tree
Hide file tree
Showing 158 changed files with 15,984 additions and 13,693 deletions.
2 changes: 1 addition & 1 deletion postgresql/acronyms.xml
Original file line number Diff line number Diff line change
Expand Up @@ -766,7 +766,7 @@
<term><acronym>UTF</acronym></term>
<listitem>
<para>
<ulink url="http://www.unicode.org/">Unicode Transformation
<ulink url="https://www.unicode.org/">Unicode Transformation
Format</ulink>
</para>
</listitem>
Expand Down
109 changes: 74 additions & 35 deletions postgresql/adminpack.xml
Original file line number Diff line number Diff line change
Expand Up @@ -29,42 +29,69 @@

<table id="functions-adminpack-table">
<title>Fonctions de <filename>adminpack</filename></title>
<tgroup cols="3">
<thead>
<row><entry>Nom</entry> <entry>Type en retour</entry> <entry>Description</entry>
</row>
</thead>
<tgroup cols="1">
<thead>
<row>
<entry role="func_table_entry"><para role="func_signature">
Fonction
</para>
<para>
Description
</para></entry>
</row>
</thead>

<tbody>
<row>
<entry><function>pg_catalog.pg_file_write(filename text, data text, append boolean)</function></entry>
<entry><type>bigint</type></entry>
<entry>
Écrit dans un fichier
</entry>
</row>
<row>
<entry><function>pg_catalog.pg_file_rename(oldname text, newname text <optional>, archivename text</optional>)</function></entry>
<entry><type>boolean</type></entry>
<entry>
Renomme un fichier
</entry>
</row>
<row>
<entry><function>pg_catalog.pg_file_unlink(filename text)</function></entry>
<entry><type>boolean</type></entry>
<entry>
Supprime un fichier
</entry>
</row>
<row>
<entry><function>pg_catalog.pg_logdir_ls()</function></entry>
<entry><type>setof record</type></entry>
<entry>
Liste les fichiers de trace du répertoire précisé par <varname>log_directory</varname>
</entry>
</row>
</tbody>
<tbody>
<row>
<entry role="func_table_entry"><para role="func_signature">
<function>pg_catalog.pg_file_write</function> ( <parameter>filename</parameter> <type>text</type>, <parameter>data</parameter> <type>text</type>, <parameter>append</parameter> <type>boolean</type> )
<returnvalue>bigint</returnvalue>
</para>
<para>
Écrit dans un fichier
</para></entry>
</row>

<row>
<entry role="func_table_entry"><para role="func_signature">
<function>pg_catalog.pg_file_sync</function> ( <parameter>filename</parameter> <type>text</type> )
<returnvalue>void</returnvalue>
</para>
<para>
Vide un fichier ou un répertoire sur disque.
</para></entry>
</row>

<row>
<entry role="func_table_entry"><para role="func_signature">
<function>pg_catalog.pg_file_rename</function> ( <parameter>oldname</parameter> <type>text</type>, <parameter>newname</parameter> <type>text</type> <optional>, <parameter>archivename</parameter> <type>text</type> </optional> )
<returnvalue>boolean</returnvalue>
</para>
<para>
Renomme un fichier
</para></entry>
</row>

<row>
<entry role="func_table_entry"><para role="func_signature">
<function>pg_catalog.pg_file_unlink</function> ( <parameter>filename</parameter> <type>text</type> )
<returnvalue>boolean</returnvalue>
</para>
<para>
Supprime un fichier.
</para></entry>
</row>

<row>
<entry role="func_table_entry"><para role="func_signature">
<function>pg_catalog.pg_logdir_ls</function> ()
<returnvalue>setof record</returnvalue>
</para>
<para>
Liste les fichiers de trace du répertoire précisé par <varname>log_directory</varname>.
</para></entry>
</row>
</tbody>
</tgroup>
</table>

Expand All @@ -80,6 +107,18 @@
seront ajoutées. Renvoit le nombre d'octets écrits.
</para>

<indexterm>
<primary>pg_file_sync</primary>
</indexterm>
<para>
<function>pg_file_sync</function> synchronise sur disque le fichier ou le
répertoire indiqué d'après son <parameter>filename</parameter>. Une erreur
est renvoyée en cas d'échec (par exemple si le fichier indiqué n'est pas
présent). Notez que <xref linkend="guc-data-sync-retry"/> n'a pas d'effet
sur cette fonction, et de ce fait, une erreur de niveau PANIC ne sera pas
renvoyée même en cas d'échec pour synchroniser les fichiers de la base.
</para>

<indexterm>
<primary>pg_file_rename</primary>
</indexterm>
Expand Down
27 changes: 24 additions & 3 deletions postgresql/amcheck.xml
Original file line number Diff line number Diff line change
Expand Up @@ -130,8 +130,7 @@ ORDER BY c.relpages DESC LIMIT 10;
B-Tree, respecte un certain nombre de propriétés invariantes. En option,
quand l'argument <parameter>heapallindexed</parameter> vaut
<literal>true</literal>, la fonction vérifie la présence de toutes les
lignes dans la table, et la présence de tous les liens dans la structure
de l'index. Quand l'argument optionel <parameter>rootdescend</parameter>
lignes dans la table. Quand l'argument optionel <parameter>rootdescend</parameter>
vaut <literal>true</literal>, la vérification recherche de nouveau les
lignes au niveau des feuilles en réalisant une nouvelle recherche à partir
de la racine pour chaque ligne. Les vérifications réalisables par
Expand All @@ -141,7 +140,8 @@ ORDER BY c.relpages DESC LIMIT 10;
plus minutieuse de <function>bt_index_check</function>&nbsp;:
contrairement à <function>bt_index_check</function>,
<function>bt_index_parent_check</function> vérifie également les
propriétés invariantes qui englobent les relations parent/enfant.
propriétés invariantes qui englobent les relations parent/enfant, et la
présence de tous les liens dans la structure de l'index.
<function>bt_index_parent_check</function>
respecte la convention habituelle qui consiste à retourner une erreur si
une incohérence ou tout autre problème est détecté.
Expand Down Expand Up @@ -174,6 +174,27 @@ ORDER BY c.relpages DESC LIMIT 10;
</listitem>
</varlistentry>
</variablelist>

<tip>
<para>
<function>bt_index_check</function> and
<function>bt_index_parent_check</function> both output log
messages about the verification process at
<literal>DEBUG1</literal> and <literal>DEBUG2</literal> severity
levels. These messages provide detailed information about the
verification process that may be of interest to
<productname>PostgreSQL</productname> developers. Advanced users
may also find this information helpful, since it provides
additional context should verification actually detect an
inconsistency. Running:
<programlisting>
SET client_min_messages = DEBUG1;
</programlisting>
in an interactive <application>psql</application> session before
running a verification query will display messages about the
progress of verification with a manageable level of detail.
</para>
</tip>
</sect2>

<sect2>
Expand Down
20 changes: 20 additions & 0 deletions postgresql/auto-explain.xml
Original file line number Diff line number Diff line change
Expand Up @@ -113,6 +113,26 @@
</listitem>
</varlistentry>

<varlistentry>
<term>
<varname>auto_explain.log_wal</varname> (<type>boolean</type>)
<indexterm>
<primary><varname>auto_explain.log_wal</varname> configuration parameter</primary>
</indexterm>
</term>
<listitem>
<para>
<varname>auto_explain.log_wal</varname> controls whether WAL
usage statistics are printed when an execution plan is logged; it's
equivalent to the <literal>WAL</literal> option of <command>EXPLAIN</command>.
This parameter has no effect
unless <varname>auto_explain.log_analyze</varname> is enabled.
This parameter is off by default.
Only superusers can change this setting.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<varname>auto_explain.log_timing</varname> (<type>boolean</type>)
Expand Down

0 comments on commit 4906e30

Please sign in to comment.