Skip to content

Commit

Permalink
Mise à jour en version 9.6RC1
Browse files Browse the repository at this point in the history
  • Loading branch information
@gleu
gleu committed Sep 26, 2016
1 parent 1f4e5ac commit b078fe1
Show file tree
Hide file tree
Showing 59 changed files with 2,630 additions and 1,886 deletions.
173 changes: 149 additions & 24 deletions postgresql/adminpack.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -11,31 +11,156 @@
support que <application>pgAdmin</application> ou d'autres outils de gestion
et d'administration peuvent utiliser pour fournir des fonctionnalités
supplémentaires, comme la gestion à distance de journaux applicatifs.
L'utilisation de toutes ces fonctions est restreinte aux superutilisateurs.
</para>

<sect2>
<title>Fonctions codées</title>
<para>
Les fonctions ajoutées par <filename>adminpack</filename> ne peuvent
être exécutées que par un super-utilisateur. La liste des fonctions est la
suivante&nbsp;:

<programlisting>
int8 pg_catalog.pg_file_write(fname text, data text, append bool)
bool pg_catalog.pg_file_rename(oldname text, newname text, archivename text)
bool pg_catalog.pg_file_rename(oldname text, newname text)
bool pg_catalog.pg_file_unlink(fname text)
setof record pg_catalog.pg_logdir_ls()

/* Renommage des fonctions internes existantes pour une compatibilité
avec pgAdmin */
int8 pg_catalog.pg_file_read(fname text, data text, append bool)
bigint pg_catalog.pg_file_length(text)
int4 pg_catalog.pg_logfile_rotate()
</programlisting>

</para>

</sect2>
<para>
Les fonctions affichées dans <xref linkend="functions-adminpack-table"/>
fournissent des accès en écriture aux fichiers de la machine hébergeant le
serveur. (Voir aussi les fonctions dans <xref
linkend="functions-admin-genfile-table"/>, qui fournissent des accès en
lecture seule.) Seuls les fichiers du répertoire principal de l'instance
sont accessibles mais un chemin relatif ou absolu est permis.
</para>

<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>

<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>
</tgroup>
</table>

<indexterm>
<primary>pg_file_write</primary>
</indexterm>
<para>
<function>pg_file_write</function> écrit les données indiquées par le
paramètre <parameter>data</parameter> dans le fichier indiqué par le
paramètre <parameter>filename</parameter>. Si le paramètre
<parameter>append</parameter> vaut false, le fichier ne doit pas déjà
exister. S'il vaut true, le fichier peut déjà exister et les données y
seront ajoutées. Renvoit le nombre d'octets écrits.
</para>

<indexterm>
<primary>pg_file_rename</primary>
</indexterm>
<para>
<function>pg_file_rename</function> renomme un fichier. Si
<parameter>archivename</parameter> est omis ou vaut NULL, il renomme
simplement <parameter>oldname</parameter> en <parameter>newname</parameter>
(qui ne doit pas déjà exister). Si <parameter>archivename</parameter> est
fourni, il renomme tout d'abord <parameter>newname</parameter> en
<parameter>archivename</parameter> (qui ne doit pas déjà exister), puis il
renomme <parameter>oldname</parameter> en <parameter>newname</parameter>. En
cas d'échec à la deuxième étape, il essaiera de renommer
<parameter>archivename</parameter> en <parameter>newname</parameter> avant
de renvoyer l'erreur. Renvoit true en cas de succès, false si les fichiers
sources ne sont pas présents ou modifiables. Dans tous les autres cas, elle
renvoit une erreur.
</para>

<indexterm>
<primary>pg_file_unlink</primary>
</indexterm>
<para>
<function>pg_file_unlink</function> supprime le fichier indiqué. Renvoit
true en cas de succès, false si le fichier spécifié n'est pas présent ou si
l'appel à <function>unlink()</function> échoue. Dans tous les autres cas,
elle renvoit une erreur.
</para>

<indexterm>
<primary>pg_logdir_ls</primary>
</indexterm>
<para>
<function>pg_logdir_ls</function> renvoit l'horodatage et le chemain de tous
les journaux applicatifs stockées dans le répertoire indiqué par le
paramètre <xref linkend="guc-log-directory"/>. Le paramètre <xref
linkend="guc-log-filename"/> doit avoir sa configuration par défaut
(<literal>postgresql-%Y-%m-%d_%H%M%S.log</literal>) pour utiliser cette
fonction.
</para>

<para>
Les fonctions affichées dans <xref
linkend="functions-adminpack-deprecated-table"/> sont obsolètes et ne
devraient pas être utilisées dans les nouvelles applications. À la place,
utilisez celles indiquées dans <xref
linkend="functions-admin-signal-table"/> et <xref
linkend="functions-admin-genfile-table"/>. Ces fonctions sont fournies dans
<filename>adminpack</filename> seulement pour assurer la compatibilité avec
les anciennes versions de <application>pgAdmin</application>.
</para>

<table id="functions-adminpack-deprecated-table">
<title>Fonctions obsolètes de <filename>adminpack</filename></title>
<tgroup cols="3">
<thead>
<row><entry>Nom</entry> <entry>Type en retour</entry> <entry>Description</entry>
</row>
</thead>

<tbody>
<row>
<entry><function>pg_catalog.pg_file_read(filename text, offset bigint, nbytes bigint)</function></entry>
<entry><type>text</type></entry>
<entry>
Nom alternatif pour <function>pg_read_file()</function>
</entry>
</row>
<row>
<entry><function>pg_catalog.pg_file_length(filename text)</function></entry>
<entry><type>bigint</type></entry>
<entry>
Identique à la colonne <structfield>size</structfield> renvoyée par
<function>pg_stat_file()</function>
</entry>
</row>
<row>
<entry><function>pg_catalog.pg_logfile_rotate()</function></entry>
<entry><type>integer</type></entry>
<entry>
Nom alternatif pour <function>pg_rotate_logfile()</function>, mais notez
qu'elle renvoit un entier (valant 0 ou 1) à la place d'un booléen
</entry>
</row>
</tbody>
</tgroup>
</table>

</sect1>
31 changes: 28 additions & 3 deletions postgresql/catalogs.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -540,9 +540,10 @@

<para>
Le catalogue <structname>pg_am</structname> stocke les informations
concernant les méthodes d'accès aux index. On trouve une ligne par méthode
d'accès supportée par le système. Ce qui concerne les méthodes d'accès aux
index est discuté en détails dans <xref linkend="indexam"/>.
concernant les méthodes d'accès aux relations. On trouve une ligne par
méthode d'accès supportée par le système. Actuellement, seuls les index ont
des méthodes d'accès. Ce qui concerne les méthodes d'accès aux index est
discuté en détails dans <xref linkend="indexam"/>.
</para>

<table>
Expand Down Expand Up @@ -587,10 +588,34 @@
</entry>
</row>

<row>
<entry><structfield>amtype</structfield></entry>
<entry><type>char</type></entry>
<entry></entry>
<entry>
Actuellement toujours à <literal>i</literal> pour indiquer une méthode
d'accès à un index. D'autres valeurs pourraient être autorisées dans le
futur.
</entry>
</row>

</tbody>
</tgroup>
</table>

<note>
<para>
Avant <productname>PostgreSQL</productname> 9.6,
<structname>pg_am</structname> containait plusieurs colonnes
supplémentaires représentant des propriétés des méthodes d'accès aux
index. Ces données sont maintenant uniquement visibles au niveau du code
C. Néanmoins, <function>pg_index_column_has_property()</function> et les
fonctions relatives ont été ajoutées pour permettre aux requêtes SQL
d'inspecter les propriétés des méthodes d'accès aux index. Voir <xref
linkend="functions-info-catalog-table"/>.
</para>
</note>

</sect1>


Expand Down
36 changes: 17 additions & 19 deletions postgresql/config.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1271,8 +1271,8 @@ include 'nom_fichier'

<para>
Si ce paramètre est activé, les utilisateurs doivent être créés sous
la forme <literal>nomutilisateur@nom_base</literal>. Quand
<literal>nomutilisateur</literal> est passé par un client se
la forme <replaceable>nomutilisateur@nom_base</replaceable>. Quand
<replaceable>nomutilisateur</replaceable> est passé par un client se
connectant, <literal>@</literal> et le nom
de la base de données sont ajoutés au nom de l'utilisateur et ce nom
d'utilisateur spécifique à la base est recherché par le
Expand Down Expand Up @@ -2109,8 +2109,8 @@ block : bloc vidé, dirty bloc : bloc à vider ?
linkend="guc-max-worker-processes"/>. Notez que le nombre demandé de
processus parallèles pourrait ne pas être disponible à l'exécution. Si
cela survient, le plan s'exécutera avec moins de processus qu'attendu, ce
qui pourrait être inefficace. La valeur par défaut est 2. Configurer
cette valeur à 0 désactive l'exécution de requêtes parallélisées.
qui pourrait être inefficace. Configurer cette valeur à 0, ce qui est la
valeur par défaut, désactive l'exécution de requêtes parallélisées.
</para>

<para>
Expand Down Expand Up @@ -5604,9 +5604,12 @@ COPY postgres_log FROM '/chemin/complet/vers/le/logfile.csv' WITH csv;
<title>Titre des processus</title>

<para>
Ces paramètres contrôlent comment le titre du processus, tel qu'il est
vu par la commande <command>ps</command>, est modifié. Voir <xref
linkend="monitoring-ps"/> pour des détails.
Ces paramètres contrôlent comment les titres de processus des processus
serveurs sont modifiés. Les titres de processus sont affichées
typiquement en utilisant des programmes comme
<application>ps</application> ou, sur Windows, <application>Process
Explorer</application>. Voir <xref linkend="monitoring-ps"/> pour plus de
détails.
</para>

<variablelist>
Expand All @@ -5619,7 +5622,7 @@ COPY postgres_log FROM '/chemin/complet/vers/le/logfile.csv' WITH csv;
<listitem>
<para>
Positionne le nom de l'instance qui apparaît dans le titre du
processus pour tous les processus de cette instance. Le nom peut être
processus pour tous les processus serveurs de cette instance. Le nom peut être
n'importe quelle chaîne de caractères de longueur inférieure à
<symbol>NAMEDATALEN</symbol> (64 caractères dans une compilation
standard du serveur). Seuls les caractères ASCII imprimables
Expand All @@ -5630,11 +5633,6 @@ COPY postgres_log FROM '/chemin/complet/vers/le/logfile.csv' WITH csv;
<literal>''</literal> (ce qui est la valeur par défaut). Ce
paramètre ne peut être positionné qu'au démarrage du serveur.
</para>
<para>
Le titre du processus est typiquement visualisé avec des
programmes tel que <application>ps</application> ou, sur Windows,
<application>Process Explorer</application>.
</para>
</listitem>
</varlistentry>

Expand All @@ -5646,12 +5644,12 @@ COPY postgres_log FROM '/chemin/complet/vers/le/logfile.csv' WITH csv;
</term>
<listitem>
<para>
Active la mise à jour du titre du processus chaque fois
qu'une nouvelle commande SQL est reçue par le serveur.
Le titre du processus est typiquement visualisé avec des
programmes tel que <application>ps</application> ou, sur Windows,
<application>Process Explorer</application>. Seuls les
superutilisateurs peuvent modifier ce paramètre.
Active la mise à jour du titre du processus chaque fois qu'une
nouvelle commande SQL est reçue par le serveur. Ce paramètre est à
<literal>on</literal> par défaut sur la plupart des plateformes mais
il est à <literal>off</literal> sur Windows car cette plateforme
souffre de lenteurs plus importantes pour la mise à jour du titre du
processus. Seuls les superutilisateurs peuvent modifier ce paramètre.
</para>
</listitem>
</varlistentry>
Expand Down
17 changes: 14 additions & 3 deletions postgresql/ddl.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2604,7 +2604,7 @@ VALUES ('Albany', NULL, NULL, 'NY');</programlisting>
enfants ne peuvent être supprimées ou modifiées si elles sont héritées.
La suppression d'une table et de tous ces descendants peut être aisément
obtenue en supprimant la table mère avec l'option
<literal>CASCADE</literal>.
<literal>CASCADE</literal> (voir <xref linkend="ddl-depend"/>).
</para>

<para>
Expand Down Expand Up @@ -3608,15 +3608,17 @@ dépendants.</screen>
supprimer individuellement chaque objet dépendant, on peut
lancer
<screen>DROP TABLE produits CASCADE;</screen>
et tous les objets dépendants sont ainsi effacés. Dans ce cas, la table des
et tous les objets dépendants sont ainsi effacés, comme tous les objets
dépendant de ces derniers, récursivement. Dans ce cas, la table des
commandes n'est pas supprimée, mais seulement la contrainte de clé étrangère.
Elle s'arrête là car rien ne dépend d'une contrainte de clé étrangère.
(Pour vérifier ce que fait <command>DROP ... CASCADE</command>, on peut
lancer <command>DROP</command> sans <literal>CASCADE</literal> et lire les messages
<literal>DETAIL</literal>.)
</para>

<para>
Toutes les commandes <command>DROP</command> dans
Pratiquement toutes les commandes <command>DROP</command> dans
<productname>PostgreSQL</productname> supportent l'utilisation de
<literal>CASCADE</literal>. La nature des dépendances
est évidemment fonction de la nature des objets. On peut aussi écrire
Expand All @@ -3637,6 +3639,15 @@ dépendants.</screen>
</para>
</note>

<para>
Si une commande <command>DROP</command> liste plusieurs objets,
<literal>CASCADE</literal> est seulement requis quand il existe des
dépendances en dehors du groupe spécifié. Par exemple, en indiquant
<literal>DROP TABLE tab1, tab2</literal>, l'existence d'une clé étrangère
référençant <literal>tab1</literal> à partir de <literal>tab2</literal> ne
signifie pas que <literal>CASCADE</literal> est nécessaire pour réussir.
</para>

<para>
Pour les fonctions définies par les utilisateurs,
<productname>PostgreSQL</productname> trace les dépendances associées avec
Expand Down

0 comments on commit b078fe1

Please sign in to comment.