[Trad] [svn:pgfr] r1315 - traduc/trunk/postgresql
admin at listes.postgresql.fr
admin at listes.postgresql.fr
Jeu 30 Avr 23:53:49 CEST 2009
Author: gleu
Date: 2009-04-30 23:53:48 +0200 (Thu, 30 Apr 2009)
New Revision: 1315
Modified:
traduc/trunk/postgresql/catalogs.xml
traduc/trunk/postgresql/config.xml
traduc/trunk/postgresql/libpq.xml
traduc/trunk/postgresql/monitoring.xml
traduc/trunk/postgresql/plpgsql.xml
Log:
Suite traduction 8.4, avec un fichier traduit par Marc Cousin.
Modified: traduc/trunk/postgresql/catalogs.xml
===================================================================
--- traduc/trunk/postgresql/catalogs.xml 2009-04-30 07:30:13 UTC (rev 1314)
+++ traduc/trunk/postgresql/catalogs.xml 2009-04-30 21:53:48 UTC (rev 1315)
@@ -3874,7 +3874,7 @@
<entry><type>oid</type></entry>
<entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry>
<entry> Type des données des éléments du tableau de paramètres variadic,
- ou zéro si la fonction n'a pas de paramètres variadiques.
+ ou zéro si la fonction n'a pas de paramètres variadiques.</entry>
</row>
<row>
@@ -5784,7 +5784,7 @@
Le catalogue <structname>pg_user_mapping</structname> stocke les correspondances
entre utilisateurs locaux et distants. L'accès à ce catalogue est interdite
aux utilisateurs normaux, utilisez la vue
- <link linkend="view-pg-user-mappings"><structname>pg_user_mappings</structname>
+ <link linkend="view-pg-user-mappings"><structname>pg_user_mappings</structname></link>
à la place.
</para>
Modified: traduc/trunk/postgresql/config.xml
===================================================================
--- traduc/trunk/postgresql/config.xml 2009-04-30 07:30:13 UTC (rev 1314)
+++ traduc/trunk/postgresql/config.xml 2009-04-30 21:53:48 UTC (rev 1315)
@@ -38,8 +38,8 @@
<para>
Certains paramètres indiquent une valeur de taille mémoire ou de durée.
Ils ont chacun une unité implicite, soit Ko, soit blocs (typiquement
- 8 Ko), soit millisecondes, soit secondes, soit minutes. Default units
- can be found by referencing
+ 8 Ko), soit millisecondes, soit secondes, soit minutes. Les unités par
+ défaut peuvent être obtenues en interrogeant
<structname>pg_settings</structname>.<structfield>unit</structfield>.
Pour simplifier la saisie, une unité différente peut être indiquée
de façon explicite. Les unités mémoire valides sont <literal>kB</literal>
@@ -53,11 +53,11 @@
</para>
<para>
- Parameters of type <quote>enum</quote> are specified in the same way as string
- parameters, but are restricted to a limited set of values. The allowed
- values can be found from
+ Les paramètres de type <quote>enum</quote> sont spécifiés de la même façon
+ que les paramètres de type chaîne, mais sont restreints à un jeu limité de
+ valeurs. Les valeurs autorisées peuvent être obtenues de
<structname>pg_settings</structname>.<structfield>enumvals</structfield>.
- Enum parameter values are case-insensitive.
+ Les paramètres enum sont insensibles à la casse.
</para>
<para>
@@ -182,8 +182,9 @@
paramètres de session à l'exécution. Elle est équivalente à <command>SHOW</command>
et <command>SET</command> mais peut être plus facile à utiliser parce qu'elle
peut être jointe avec d'autres tables et que ses lignes peuvent être
- sélectionnées en utilisant des conditions personnalisées. It also contains more information about
- what values are allowed for the parameters.
+ sélectionnées en utilisant des conditions personnalisées. Elle contient
+ aussi davantage d'informations sur les valeurs autorisées pour les
+ paramètres.
</para>
</sect1>
@@ -601,7 +602,8 @@
Active les connexions <acronym>SSL</acronym>. Lire la
<xref linkend="ssl-tcp"/> avant de l'utiliser. Désactivé par défaut.
Ce paramètre ne peut être configuré qu'au lancement du serveur.
- <acronym>SSL</acronym> communication is only possible with TCP/IP connections.
+ La communication <acronym>SSL</acronym> n'est possible qu'avec des
+ connexions TCP/IP.
</para>
</listitem>
</varlistentry>
@@ -650,10 +652,10 @@
<para>
Configure l'emplacement du fichier contenant la clé secrète du
serveur Kerberos. Voir la <xref linkend="kerberos-auth"/> et la
- la <xref linkend="gssapi-auth"/> pour les
- détails. Ce paramètre ne peut être configuré in the
- <filename>postgresql.conf</filename> file et au lancement
- du serveur.
+ <xref linkend="gssapi-auth"/> pour les détails. Ce paramètre ne
+ peut être configuré que dans le fichier
+ <filename>postgresql.conf</filename> ou indiqué sur la ligne de
+ commande.
</para>
</listitem>
</varlistentry>
@@ -666,9 +668,8 @@
</indexterm>
<para>
Configure le nom du service Kerberos. Voir la <xref linkend="kerberos-auth"/>
- pour les détails. Ce paramètre ne peut être configuré in the
- <filename>postgresql.conf</filename> file ou au lancement
- du serveur.
+ pour les détails. Ce paramètre ne peut être configuré que dans le fichier
+ <filename>postgresql.conf</filename> ou indiqué sur la ligne de commande.
</para>
</listitem>
</varlistentry>
@@ -682,9 +683,9 @@
<para>
Indique si les noms des utilisateurs Kerberos et GSSAPI doivent être traités en
respectant la casse. Désactivé par défaut (insensible à la casse, valeur
- <literal>off</literal>), ce paramètre ne peut être configuré
- in the <filename>postgresql.conf</filename> file et qu'au
- lancement du serveur.
+ <literal>off</literal>), Ce paramètre ne peut être configuré que dans le fichier
+ <filename>postgresql.conf</filename> ou indiqué sur la ligne de commande.
+
</para>
</listitem>
</varlistentry>
@@ -714,14 +715,14 @@
</para>
<para>
- <varname>db_user_namespace</varname> causes the client's and
- server's user name representation to differ.
- Authentication checks are always done with the server's user name
- so authentication methods must be configured for the
- server's user name, not the client's. Because
- <literal>md5</literal> uses the user name as salt on both the
- client and server, <literal>md5</literal> cannot be used with
- <varname>db_user_namespace</varname>.
+ <varname>db_user_namespace</varname> permet aux représentations des noms
+ d'utilisateurs du client et du serveur de différer. Les vérifications sont
+ toujours faites avec les noms d'utilisateurs du serveur, ce qui fait que
+ les méthodes d'authentification doivent être configurées pour le nom
+ d'utilisateur du serveur, pas pour celui du client. Comme
+ <literal>md5</literal> utilise le nom d'utilisateur comme sel à la
+ fois sur le client et le serveur, <literal>md5</literal> ne peut pas
+ être utilisé conjointement avec <varname>db_user_namespace</varname>.
</para>
<para>
@@ -1082,9 +1083,9 @@
</para>
<para>
- Cette fonctionnalité est désactivée par défaut for manually issued
- <command>VACUUM</command> commands. Pour l'activer,
- la variable <varname>vacuum_cost_delay</varname> doit être
+ Cette fonctionnalité est désactivée par défaut pour les commandes
+ <command>VACUUM</command> lancées manuellement. Pour l'activer,
+ la variable <varname>vacuum_cost_delay</varname> doit être
initialisée à une valeur différente de zéro.
</para>
@@ -1107,10 +1108,11 @@
</para>
<para>
- When using cost-based vacuuming, appropriate values for
- <varname>vacuum_cost_delay</varname> are usually quite small, perhaps
- 10 or 20 milliseconds. Adjusting vacuum's resource consumption
- is best done by changing the other vacuum cost parameters.
+ Lors d'utilisation de vacuum basée sur le coût, les valeurs appropriées
+ pour <varname>vacuum_cost_delay</varname> sont habituellement assez
+ petites, de l'ordre de 10 à 20 millisecondes. Il est préférable d'ajuster
+ la consommation de ressource de vacuum en changeant les autres paramètres
+ de coût de vacuum.
</para>
</listitem>
</varlistentry>
@@ -1307,48 +1309,52 @@
</sect2>
<sect2 id="runtime-config-resource-async-behavior">
- <title>Asynchronous Behavior</title>
+ <title>Comportement asynchrone</title>
<variablelist>
<varlistentry id="guc-effective-io-concurrency" xreflabel="effective_io_concurrency">
<term><varname>effective_io_concurrency</varname> (<type>integer</type>)</term>
<indexterm>
- <primary><varname>effective_io_concurrency</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>effective_io_concurrency</varname></primary>
</indexterm>
<listitem>
<para>
- Sets the number of concurrent disk I/O operations that
- <productname>PostgreSQL</productname> expects can be executed
- simultaneously. Raising this value will increase the number of I/O
- operations that any individual <productname>PostgreSQL</productname> session
- attempts to initiate in parallel. The allowed range is 1 to 1000,
- or zero to disable issuance of asynchronous I/O requests.
+ Positionne le nombre d'opérations d'entrées/sorties disque concurrentes
+ que <productname>PostgreSQL</productname> pense pouvoir exécuter
+ simultanément. Augmenter cette valeur va augmenter le nombre d'opérations
+ d'entrée/sortie que chaque session <productname>PostgreSQL</productname>
+ individuelle essayera d'exécuter en parallèle. Les valeurs autorisées
+ vont de 1 à 1000, ou zéro pour désactiver l'exécution de requêtes
+ d'entrée/sortie asynchrones.
</para>
<para>
- A good starting point for this setting is the number of separate
- drives comprising a RAID 0 stripe or RAID 1 mirror being used for the
- database. (For RAID 5 the parity drive should not be counted.)
- However, if the database is often busy with multiple queries issued in
- concurrent sessions, lower values may be sufficient to keep the disk
- array busy. A value higher than needed to keep the disks busy will
- only result in extra CPU overhead.
+ Un bon point départ pour ce paramètre est le nombre de disques que
+ comprend un agrégat par bande RAID 0 ou miroir RAID 1 utilisé pour
+ la base de données. (Pour du RAID 5, le disque de parité ne devrait
+ pas être pris en compte.) Toutefois, si la base est souvent occupée par
+ de nombreuses requêtes exécutées dans des sessions concurrentes, des
+ valeurs plus basses peuvent être suffisantes pour maintenir le groupe
+ de disques occupé. Une valeur plus élevée que nécessaire pour maintenir
+ les disques occupés n'aura comme seul résultat que de surcharger le
+ processeur.
</para>
<para>
- For more exotic systems, such as memory-based storage or a RAID array
- that is limited by bus bandwidth, the correct value might be the
- number of I/O paths available. Some experimentation may be needed
- to find the best value.
+ Pour des systèmes plus exotiques, comme du stockage mémoire ou
+ un groupement RAID qui serait limité par la bande passante du bus,
+ la valeur correcte pourrait être le nombre de chemins d'entrées/sorties
+ disponibles. Il pourrait être nécessaire d'expérimenter afin d'obtenir
+ la valeur idéale.
</para>
<para>
- Asynchronous I/O depends on an effective
- <function>posix_fadvise</function>
- function, which some operating systems lack. If the function is not
- present then setting this parameter to anything but zero will result
- in an error. On some operating systems the function is present but
- does not actually do anything (e.g. Solaris).
+ Les entrées/sorties asynchrones dépendent de la présence d'une fonction
+ <function>posix_fadvise</function> efficace, ce que n'ont pas certains
+ systèmes d'exploitation. Si la fonction n'est pas présente, alors
+ positionner ce paramètre à une valeur autre que zéro entraînera une
+ erreur. Sur certains systèmes, cette fonction est présente mais n'a
+ pas d'effet (par exemple Solaris).
</para>
</listitem>
</varlistentry>
@@ -2326,21 +2332,21 @@
<primary>paramètre de configuration <varname>constraint_exclusion</varname></primary>
</indexterm>
<para>
- Controls the query planner's use of table constraints to
- optimize queries.
- The allowed values of <varname>constraint_exclusion</varname> are
- <literal>on</literal> (examine constraints for all tables),
- <literal>off</literal> (never examine constraints), and
- <literal>partition</literal> (examine constraints only for inheritance child
- tables and <literal>UNION ALL</literal> subqueries).
- <literal>partition</literal> is the default setting.
+ Contrôle l'utilisation par le planificateur de requête des contraintes
+ pour optimiser les requêtes.
+ Les valeurs autorisées de <varname>constraint_exclusion</varname> sont
+ <literal>on</literal> (examiner les contraintes pour toutes les tables),
+ <literal>off</literal> (ne jamais examiner les contraintes) et
+ <literal>partition</literal> (n'examiner les contraintes que pour les
+ tables enfants d'un héritage et pour les sous-requêtes <literal>UNION ALL</literal>).
+ <literal>partition</literal> est la valeur par défaut.
</para>
<para>
- When this parameter allows it for a particular table, the planner
- compares query conditions with the table's <literal>CHECK</literal>
- constraints, and omits scanning tables for which the conditions
- contradict the constraints. For example:
+ Quand ce paramètre l'autorise pour une table particulière, le planificateur
+ compare les conditions de la requête avec les contraintes <literal>CHECK</literal>
+ sur la table, et omet le parcourt des tables pour lesquelles les
+ conditions contredisent les contraintes. Par exemple :
<programlisting>CREATE TABLE parent(clef integer, ...);
CREATE TABLE fils1000(check (clef between 1000 and 1999)) INHERITS(parent);
@@ -2355,17 +2361,19 @@
</para>
<para>
- Currently, constraint exclusion is enabled by default
- only for cases that are often used to implement table partitioning.
- Turning it on for all tables imposes extra planning overhead that is
- quite noticeable on simple queries, and most often will yield no
- benefit for simple queries. If you have no partitioned tables
- you might prefer to turn it off entirely.
+ À l'heure actuelle, l'exclusion de contraintes est activée par défaut
+ seulement pour les cas qui sont souvent utilisés pour implémenter le
+ partitionnement de tables.
+ L'activer pour toutes les tables impose un surcoût pour la planification
+ qui est assez mesurable pour des requêtes simples, et le plus souvent
+ n'apportera aucun bénéfice aux requêtes simples. Si vous n'avez pas de
+ tables partitionnées, vous voudrez peut-être le désactiver entièrement.
</para>
<para>
- Refer to <xref linkend="ddl-partitioning-constraint-exclusion"/> for
- more information on using constraint exclusion and partitioning.
+ Reportez vous à <xref linkend="ddl-partitioning-constraint-exclusion"/>
+ pour plus d'informations sur l'utilisation d'exclusion de contraintes et
+ du partitionnement.
</para>
</listitem>
</varlistentry>
@@ -2373,19 +2381,21 @@
<varlistentry id="guc-cursor-tuple-fraction" xreflabel="cursor_tuple_fraction">
<term><varname>cursor_tuple_fraction</varname> (<type>floating point</type>)</term>
<indexterm>
- <primary><varname>cursor_tuple_fraction</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>cursor_tuple_fraction</varname></primary>
</indexterm>
<listitem>
<para>
- Sets the planner's estimate of the fraction of a cursor's rows that
- will be retrieved. The default is 0.1. Smaller values of this
- setting bias the planner towards using <quote>fast start</quote> plans
- for cursors, which will retrieve the first few rows quickly while
- perhaps taking a long time to fetch all rows. Larger values
- put more emphasis on the total estimated time. At the maximum
- setting of 1.0, cursors are planned exactly like regular queries,
- considering only the total estimated time and not how soon the
- first rows might be delivered.
+ Positionne la fraction, estimée par le planificateur, de la fraction
+ d'enregistrements d'un curseur qui sera récupérée.
+ La valeur par défaut est 0.1. Des valeurs plus petites de ce paramètre
+ rendent le planificateur plus enclin à choisir des plans à démarrage
+ rapide (<quote>fast start</quote>), qui récupèreront les premiers
+ enregistrement rapidement, tout en mettant peut être un temps plus long
+ à récupérer tous les enregistrements. Des valeurs plus grandes mettent
+ l'accent sur le temps total estimé. À la valeur maximum 1.0 du paramètre,
+ les curseurs sont planifiés exactement comme des requêtes classiques,
+ en ne prenant en compte que le temps total estimé et non la vitesse à
+ laquelle les premiers enregistrements seront fournis.
</para>
</listitem>
</varlistentry>
@@ -2555,24 +2565,24 @@
</indexterm>
<para>
Lorsque <varname>logging_collector</varname> est activé, ce paramètre
- indique les noms des fichiers de journaux créés. La valeur est
+ indique les noms des journaux applicatifs créés. La valeur est
traitée comme un motif <systemitem>strftime</systemitem>. Ainsi
les échappements <literal>%</literal> peuvent être utilisés pour
indiquer des noms de fichiers horodatés. (S'il y a des
échappements <literal>%</literal> dépendant des fuseaux horaires, le
calcul se fait dans le fuseau précisé par
<xref linkend="guc-log-timezone"/>.)
- Note that the system's <systemitem>strftime</systemitem> is not used
- directly, so platform-specific (nonstandard) extensions do not work.
+ Notez que la fonction <systemitem>strftime</systemitem> du système n'est
+ pas utilisée directement, ce qui entraîne que les extensions spécifiques
+ à la plateforme (non-standard) ne fonctionneront pas.
</para>
<para>
- If you specify a file name without escapes, you should plan to
- use a log rotation utility to avoid eventually filling the
- entire disk. In releases prior to 8.4, if
- no <literal>%</literal> escapes were
- present, <productname>PostgreSQL</productname> would append
- the epoch of the new log file's creation time, but this is no
- longer the case.
+ Si vous spécifiez un nom de fichier sans échappements, vous devriez
+ prévoir d'utiliser un utilitaire de rotation des journaux pour éviter
+ le risque de remplir le disque entier. Dans les versions précédentes à
+ 8.4, si aucun échappement <literal>%</literal> n'était présent,
+ <productname>PostgreSQL</productname> aurait ajouté l'epoch de la date de
+ création du nouveau journal applicatif mais ce n'est plus le cas.
</para>
<para>
Si la sortie au format CSV est activée dans
@@ -2583,9 +2593,8 @@
le nom du fichier CSV est <literal>server_log.1093827753.csv</literal>.
</para>
<para>
- This parameter can only be set in the
- <filename>postgresql.conf</filename>
- file or on the server command line.
+ Ce paramètre ne peut être positionné que dans le fichier
+ <filename>postgresql.conf</filename> ou en ligne de commande.
</para>
</listitem>
</varlistentry>
@@ -2994,12 +3003,13 @@
</indexterm>
<para>
Ces paramètres activent plusieurs sorties de débogage.
- When set, they print the resulting parse tree, the query rewriter
- output, or the execution plan for each executed query.
- These messages are emitted at <literal>LOG</literal> message level, so by
- default they will appear in the server log but will not be sent to the
- client. You can change that by adjusting
- <xref linkend="guc-client-min-messages"/> and/or
+ Quand positionnés, il affichent l'arbre d'interprétation résultant,
+ la sortie de la réécriture de requête, ou le plan d'exécution pour chaque
+ requête exécutée.
+ Ces messages sont émis au niveau de trace <literal>LOG</literal> , par
+ conséquent ils apparaîtront dans le journal applicatif du serveur, mais
+ ne seront pas envoyés au client. Vous pouvez changer cela en ajustant
+ <xref linkend="guc-client-min-messages"/> et/ou
<xref linkend="guc-log-min-messages"/>.
Ces paramètres sont désactivés par défaut.
</para>
@@ -3009,16 +3019,16 @@
<varlistentry>
<term><varname>debug_pretty_print</varname> (<type>boolean</type>)</term>
<indexterm>
- <primary><varname>debug_pretty_print</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>debug_pretty_print</varname></primary>
</indexterm>
<listitem>
<para>
- When set, <varname>debug_pretty_print</varname> indents the messages
- produced by <varname>debug_print_parse</varname>,
- <varname>debug_print_rewritten</varname>, or
- <varname>debug_print_plan</varname>. This results in more readable
- but much longer output than the <quote>compact</quote> format used when
- it is off. It is on by default.
+ Quand positionné, <varname>debug_pretty_print</varname> indente les
+ messages produits par <varname>debug_print_parse</varname>,
+ <varname>debug_print_rewritten</varname>, ou
+ <varname>debug_print_plan</varname>. Le résultat est une sortie plus
+ lisible mais plus verbeuse que le format <quote>compact</quote> utilisé
+ quand ce paramètre est à off. La valeur par défaut est 'on'.
</para>
</listitem>
</varlistentry>
@@ -3346,13 +3356,14 @@
<para>
Contrôle l'écriture de traces sur l'utilisation des fichiers temporaires. Les
fichiers temporaires peuvent être créés pour des tris, des hachages
- et des résultats temporaires de requête. A log entry is made for each temporary file when it is deleted.
+ et des résultats temporaires de requête. Une entrée de journal est générée
+ pour chaque fichier temporaire au moment ou il est effacé.
Zéro implique une trace
de tous les fichiers temporaires alors qu'une valeur positive ne
trace que les fichiers dont la taille est supérieure ou égale au
nombre indiqué (en kilo-octets). La valeur par défaut est
<literal>-1</literal>, ce qui a pour effet de désactiver les traces.
- Only superusers can change this setting.
+ Seuls les superutilisateurs peuvent modifier ce paramètre.
</para>
</listitem>
</varlistentry>
@@ -3536,15 +3547,15 @@
<varlistentry id="guc-track-activity-query-size" xreflabel="track_activity_query_size">
<term><varname>track_activity_query_size</varname> (<type>integer</type>)</term>
<indexterm>
- <primary><varname>track_activity_query_size</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>track_activity_query_size</varname></primary>
</indexterm>
<listitem>
<para>
- Specifies the number of bytes reserved to track the currently
- executing command for each active session, for the
- <structname>pg_stat_activity</structname>.<structfield>current_query</structfield> field.
- The default value is 1024. This parameter can only be set at server
- start.
+ Spécifie le nombre d'octets réservés pour suivre la commande en cours
+ d'exécution pour chaque session active, pour le champ
+ <structname>pg_stat_activity</structname>.<structfield>current_query</structfield>.
+ La valeur par défaut est 1024. Ce paramètre ne peut être positionné qu'au
+ démarrage du serveur.
</para>
</listitem>
</varlistentry>
@@ -3567,23 +3578,24 @@
<varlistentry id="guc-track-functions" xreflabel="track_functions">
<term><varname>track_functions</varname> (<type>enum</type>)</term>
<indexterm>
- <primary><varname>track_functions</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>track_functions</varname></primary>
</indexterm>
<listitem>
<para>
- Enables tracking of function call counts and time used. Specify
- <literal>pl</literal> to track only procedural-language functions,
- <literal>all</literal> to also track SQL and C language functions.
- The default is <literal>none</literal>, which disables function
- statistics tracking. Only superusers can change this setting.
+ Active le suivi du nombre et de la durée des appels aux fonctions.
+ Précisez <literal>pl</literal> pour ne tracer que les fonctions
+ de langages procéduraux, ou <literal>all</literal> pour suivre aussi
+ les fonctions SQL et C. La valeur par défaut est <literal>none</literal>,
+ qui désactive le suivi des statistiques de fonctions.
+ Seuls les superutilisateurs peuvent modifier ce paramètre.
</para>
<note>
<para>
- SQL-language functions that are simple enough to be
- <quote>inlined</quote>
- into the calling query will not be tracked, regardless of this
- setting.
+ Les fonctions en langage SQL qui sont assez simples pour être
+ <quote>inlined</quote>, c'est à dire substituées dans le code de la
+ requête appelante, ne seront pas suivies, quelle que soit la valeur de
+ ce paramètre.
</para>
</note>
</listitem>
@@ -3608,18 +3620,18 @@
<varlistentry id="guc-stats-temp-directory" xreflabel="stats_temp_directory">
<term><varname>stats_temp_directory</varname> (<type>string</type>)</term>
<indexterm>
- <primary><varname>stats_temp_directory</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>stats_temp_directory</varname></primary>
</indexterm>
<listitem>
<para>
- Sets the directory to store temporary statistics data in. This can be
- a path relative to the data directory or an absolute path. The default
- is <filename>pg_stat_tmp</filename>. Pointing this at a RAM based
- filesystem will decrease physical I/O requirements and can lead to
- improved performance.
- This parameter can only be set in the
- <filename>postgresql.conf</filename>
- file or on the server command line.
+ Précise le répertoire dans lequel stocker les données temporaires
+ de statistiques. Cela peut être un chemin relatif au répertoire de
+ données ou un chemin absolu. La valeur par défaut est
+ <filename>pg_stat_tmp</filename>. Faire pointer ceci vers un système
+ de fichiers mémoire diminuera les entrées/sorties physiques et peut
+ améliorer les performances.
+ Ce paramètre ne peut être positionné que dans le fichier
+ <filename>postgresql.conf</filename> ou sur la ligne de commande.
</para>
</listitem>
</varlistentry>
@@ -4192,20 +4204,20 @@
<varlistentry id="guc-vacuum-freeze-table-age" xreflabel="vacuum_freeze_table_age">
<term><varname>vacuum_freeze_table_age</varname> (<type>integer</type>)</term>
<indexterm>
- <primary><varname>vacuum_freeze_table_age</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>vacuum_freeze_table_age</varname></primary>
</indexterm>
<listitem>
<para>
- <command>VACUUM</command> performs a whole-table scan if the table's
- <structname>pg_class</structname>.<structfield>relfrozenxid</structfield> field has reached
- the age specified by this setting. The default is 150 million
- transactions. Although users can set this value anywhere from zero to
- one billion, <command>VACUUM</command> will silently limit the effective value
- to 95% of <xref linkend="guc-autovacuum-freeze-max-age"/>, so that a
- periodical manual <command>VACUUM</command> has a chance to run before an
- anti-wraparound autovacuum is launched for the table. For more
- information see
- <xref linkend="vacuum-for-wraparound"/>.
+ <command>VACUUM</command> effectuera un parcours complet de la table si
+ le champ <structname>pg_class</structname>.<structfield>relfrozenxid</structfield>
+ de la table a atteint l'âge spécifié par ce paramètre. La valeur par
+ défaut est 150 millions de transactions. Même si les utilisateurs peuvent
+ positionner cette valeur à n'importe quelle valeur comprise entre zéro et
+ 1 milliard, <command>VACUUM</command> limitera silencieusement la valeur
+ effective à 95% de <xref linkend="guc-autovacuum-freeze-max-age"/>, afin
+ qu'un vacuum périodique manuel ait une chance de s'exécuter avant un
+ autovacuum anti-bouclage ne soit lancé pour la table. Pour plus d'informations
+ voyez <xref linkend="vacuum-for-wraparound"/>.
</para>
</listitem>
</varlistentry>
@@ -4329,29 +4341,29 @@
<varlistentry id="guc-intervalstyle" xreflabel="IntervalStyle">
<term><varname>IntervalStyle</varname> (<type>enum</type>)</term>
<indexterm>
- <primary><varname>IntervalStyle</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>IntervalStyle</varname></primary>
</indexterm>
<listitem>
<para>
- Sets the display format for interval values.
- The value <literal>sql_standard</literal> will produce
- output matching <acronym>SQL</acronym> standard interval literals.
- The value <literal>postgres</literal> (which is the default) will produce
- output matching <productname>PostgreSQL</productname> releases prior to 8.4
- when the <xref linkend="guc-datestyle"/>
- parameter was set to <literal>ISO</literal>.
- The value <literal>postgres_verbose</literal> will produce output
- matching <productname>PostgreSQL</productname> releases prior to 8.4
- when the <varname>DateStyle</varname>
- parameter was set to non-<literal>ISO</literal> output.
- The value <literal>iso_8601</literal> will produce output matching the time
- interval <quote>format with designators</quote> defined in section
- 4.4.3.2 of ISO 8601.
+ Positionne le format d'affichage pour les valeurs de type intervalle.
+ La valeur <literal>sql_standard</literal> produira une sortie correspondant
+ aux litéraux d'intervalles du standard <acronym>SQL</acronym>.
+ La valeur <literal>postgres</literal> (qui est la valeur par défaut)
+ produira une sortie correspondant à celle des versions de <productname>PostgreSQL</productname>
+ antérieures à la 8.4 quand le paramètre <xref linkend="guc-datestyle"/>
+ était positionné à <literal>ISO</literal>.
+ La valeur <literal>postgres_verbose</literal> produira une sortie correspondant
+ à celle des versions de <productname>PostgreSQL</productname>
+ antérieures à la 8.4 quand le paramètre <varname>DateStyle</varname>
+ était positionné à une valeur autre que <literal>ISO</literal>
+ La valeur <literal>iso_8601</literal> produira une sortie correspondant
+ au <quote>format avec designateurs</quote> d'intervalle de temps défini
+ dans le paragraphe 4.4.3.2 de l'ISO 8601.
</para>
<para>
- The <varname>IntervalStyle</varname> parameter also affects the
- interpretation of ambiguous interval input. See
- <xref linkend="datatype-interval-input"/> for more information.
+ Le paramètre <varname>IntervalStyle</varname> affecte aussi l'interprétation
+ des entrées ambigües d'intervalles. Voir <xref linkend="datatype-interval-input"/>
+ pour plus d'informations.
</para>
</listitem>
</varlistentry>
@@ -5188,16 +5200,15 @@
<varlistentry id="guc-segment-size" xreflabel="segment_size">
<term><varname>segment_size</varname> (<type>integer</type>)</term>
<indexterm>
- <primary><varname>segment_size</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>segment_size</varname></primary>
</indexterm>
<listitem>
<para>
- Reports the number of blocks (pages) that can be stored within a file
- segment. It is determined by the value of
- <literal>RELSEG_SIZE</literal>
- when building the server. The maximum size of a segment file in bytes
- is equal to <varname>segment_size</varname> multiplied by
- <varname>block_size</varname>; by default this is 1GB.
+ Retourne le nombre de blocs (pages) qui peuvent être stockés dans un
+ segment de fichier. C'est déterminé par la valeur de <literal>RELSEG_SIZE</literal>
+ à la compilation du serveur. La valeur maximum d'un fichier de segment
+ en octet est égal à <varname>segment_size</varname> multiplié par
+ <varname>block_size</varname> ; par défaut, c'est 1 Go.
</para>
</listitem>
</varlistentry>
@@ -5249,13 +5260,13 @@
<varlistentry id="guc-wal-block-size" xreflabel="wal_block_size">
<term><varname>wal_block_size</varname> (<type>integer</type>)</term>
<indexterm>
- <primary><varname>wal_block_size</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>wal_block_size</varname></primary>
</indexterm>
<listitem>
<para>
- Reports the size of a WAL disk block. It is determined by the value
- of <literal>XLOG_BLCKSZ</literal> when building the server. The default value
- is 8192 bytes.
+ Retourne la taille d'un bloc disque de WAL. C'est déterminé par la valeur
+ <literal>XLOG_BLCKSZ</literal> à la compilation du serveur. La valeur
+ par défaut est 8192 octets.
</para>
</listitem>
</varlistentry>
@@ -5263,16 +5274,15 @@
<varlistentry id="guc-wal-segment-size" xreflabel="wal_segment_size">
<term><varname>wal_segment_size</varname> (<type>integer</type>)</term>
<indexterm>
- <primary><varname>wal_segment_size</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>wal_segment_size</varname></primary>
</indexterm>
<listitem>
<para>
- Reports the number of blocks (pages) in a WAL segment file.
- The total size of a WAL segment file in bytes is equal to
- <varname>wal_segment_size</varname> multiplied by
- <varname>wal_block_size</varname>;
- by default this is 16MB. See <xref linkend="wal-configuration"/> for
- more information.
+ Retourne le nombre de blocs (pages) dans un fichier de segment WAL.
+ La taille totale d'un fichier de segment WAL en octets est égale à
+ <varname>wal_segment_size</varname> multiplié par
+ <varname>wal_block_size</varname> ; Par défaut, c'est 16 Mo.
+ Voir <xref linkend="wal-configuration"/> pour plus d'informations.
</para>
</listitem>
</varlistentry>
@@ -5479,18 +5489,18 @@
<varlistentry>
<term><varname>trace_locks</varname> (<type>boolean</type>)</term>
<indexterm>
- <primary><varname>trace_locks</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>trace_locks</varname></primary>
</indexterm>
<listitem>
<para>
- If on, emit information about lock usage. Information dumped
- includes the type of lock operation, the type of lock and the unique
- identifier of the object being locked or unlocked. Also included
- are bitmasks for the lock types already granted on this object as
- well as for the lock types awaited on this object. For each lock
- type a count of the number of granted locks and waiting locks is
- also dumped as well as the totals. An example of the log file output
- is shown here:
+ Si activé, émet des informations à propos de l'utilisation des verrous.
+ L'information fournie inclut le type d'opération de verrouillage,
+ le type de verrou et l'identifiant unique de l'objet verrouillé ou
+ déverrouillé. Sont aussi inclus les masques de bits pour les types de
+ verrous déjà accordés pour cet objet, ainsi que pour les types de verrous
+ attendus sur cet objet. Pour chaque type de verrou un décompte du nombre
+ de verrous accordés et en attente est aussi retourné, ainsi que les totaux.
+ Un exemple de sortie dans le journal applicatif est montré ici :
</para>
<para>
LOG: LockAcquire: new: lock(0xb7acd844) id(24688,24696,0,0,0,1)
@@ -5514,13 +5524,13 @@
wait(0) type(INVALID)
</para>
<para>
- Details of the structure being dumped may be found in
- src/include/storage/lock.h
+ Les détails de la structure retournée peuvent être trouvés dans
+ src/include/storage/lock.h.
</para>
<para>
- This parameter is only available if the <symbol>LOCK_DEBUG</symbol>
- macro was defined when <productname>PostgreSQL</productname> was
- compiled.
+ Ce paramètre n'est disponible que si la macro <symbol>LOCK_DEBUG</symbol>
+ a été définie quand <productname>PostgreSQL</productname> a été
+ compilé.
</para>
</listitem>
</varlistentry>
@@ -5528,18 +5538,19 @@
<varlistentry>
<term><varname>trace_lwlocks</varname> (<type>boolean</type>)</term>
<indexterm>
- <primary><varname>trace_lwlocks</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>trace_lwlocks</varname></primary>
</indexterm>
<listitem>
<para>
- If on, emit information about lightweight lock usage. Lightweight
- locks are intended primarily to provide mutual exclusion of access
- to shared-memory data structures.
+ Si à on, génère des informations à propos de l'utilisation de verrous
+ légers (lightweight lock). Les verrous légers servent principalement
+ à fournir une exclusion mutuelle d'accès aux structures de données en
+ mémoire partagée.
</para>
<para>
- This parameter is only available if the <symbol>LOCK_DEBUG</symbol>
- macro was defined when <productname>PostgreSQL</productname> was
- compiled.
+ Ce paramètre n'est disponible que si la macro <symbol>LOCK_DEBUG</symbol>
+ a été définie quand <productname>PostgreSQL</productname> a été
+ compilé.
</para>
</listitem>
</varlistentry>
@@ -5547,21 +5558,22 @@
<varlistentry>
<term><varname>trace_userlocks</varname> (<type>boolean</type>)</term>
<indexterm>
- <primary><varname>trace_userlocks</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>trace_userlocks</varname></primary>
</indexterm>
<listitem>
<para>
- If on, emit information about user lock usage. Output is the same
- as for <symbol>trace_locks</symbol>, only for user locks.
+ Si activé, génère des informations à propos de l'utilisation de verrous
+ utilisateurs. La sortie est la même que pour <symbol>trace_locks</symbol>,
+ mais restreinte aux verrous utilisateurs.
</para>
<para>
- User locks were removed as of PostgreSQL version 8.2. This option
- currently has no effect.
+ Les verrous utilisateurs ont été supprimés depuis PostgreSQL version 8.2.
+ Cette option n'a aucun effet maintenant.
</para>
<para>
- This parameter is only available if the <symbol>LOCK_DEBUG</symbol>
- macro was defined when <productname>PostgreSQL</productname> was
- compiled.
+ Ce paramètre n'est disponible que si la macro <symbol>LOCK_DEBUG</symbol>
+ a été définie quand <productname>PostgreSQL</productname> a été
+ compilé.
</para>
</listitem>
</varlistentry>
@@ -5569,17 +5581,18 @@
<varlistentry>
<term><varname>trace_lock_oidmin</varname> (<type>integer</type>)</term>
<indexterm>
- <primary><varname>trace_lock_oidmin</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>trace_lock_oidmin</varname></primary>
</indexterm>
<listitem>
<para>
- If set, do not trace locks for tables below this OID. (use to avoid
- output on system tables)
+ Si positionné, ne trace pas les verrouillages pour des tables en dessous
+ de cet OID. (à utiliser pour ne pas avoir de sortie pour les tables
+ systèmes)
</para>
<para>
- This parameter is only available if the <symbol>LOCK_DEBUG</symbol>
- macro was defined when <productname>PostgreSQL</productname> was
- compiled.
+ Ce paramètre n'est disponible que si la macro <symbol>LOCK_DEBUG</symbol>
+ a été définie quand <productname>PostgreSQL</productname> a été
+ compilé.
</para>
</listitem>
</varlistentry>
@@ -5587,16 +5600,16 @@
<varlistentry>
<term><varname>trace_lock_table</varname> (<type>integer</type>)</term>
<indexterm>
- <primary><varname>trace_lock_table</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>trace_lock_table</varname></primary>
</indexterm>
<listitem>
<para>
- Unconditionally trace locks on this table (OID).
+ Tracer les verrouillages sur cette table de façon inconditionnelle.
</para>
<para>
- This parameter is only available if the <symbol>LOCK_DEBUG</symbol>
- macro was defined when <productname>PostgreSQL</productname> was
- compiled.
+ Ce paramètre n'est disponible que si la macro <symbol>LOCK_DEBUG</symbol>
+ a été définie quand <productname>PostgreSQL</productname> a été
+ compilé.
</para>
</listitem>
</varlistentry>
@@ -5604,17 +5617,18 @@
<varlistentry>
<term><varname>debug_deadlocks</varname> (<type>boolean</type>)</term>
<indexterm>
- <primary><varname>debug_deadlocks</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>debug_deadlocks</varname></primary>
</indexterm>
<listitem>
<para>
- If set, dumps information about all current locks when a
- DeadLockTimeout occurs.
+ Si positionné, génère des informations à propos de tous les verrous en cours
+ quand un DeadLockTimeout (expiration de temps d'attente de verrou mortel)
+ se produit.
</para>
<para>
- This parameter is only available if the <symbol>LOCK_DEBUG</symbol>
- macro was defined when <productname>PostgreSQL</productname> was
- compiled.
+ Ce paramètre n'est disponible que si la macro <symbol>LOCK_DEBUG</symbol>
+ a été définie quand <productname>PostgreSQL</productname> a été
+ compilé.
</para>
</listitem>
</varlistentry>
@@ -5622,17 +5636,17 @@
<varlistentry>
<term><varname>log_btree_build_stats</varname> (<type>boolean</type>)</term>
<indexterm>
- <primary><varname>log_btree_build_stats</varname> configuration parameter</primary>
+ <primary>paramètre de configuration <varname>log_btree_build_stats</varname></primary>
</indexterm>
<listitem>
<para>
- If set, logs system resource usage statistics (memory and CPU) on
- various btree operations.
+ Si positionné, trace des statistiques d'utilisation de ressource système
+ (mémoire et processeur) sur différentes opérations btree.
</para>
<para>
- This parameter is only available if the <symbol>BTREE_BUILD_STATS</symbol>
- macro was defined when <productname>PostgreSQL</productname> was
- compiled.
+ Ce paramètre n'est disponible que si la macro <symbol>BTREE_BUILD_STATS</symbol>
+ a été définie quand <productname>PostgreSQL</productname> a été
+ compilé.
</para>
</listitem>
</varlistentry>
Modified: traduc/trunk/postgresql/libpq.xml
===================================================================
--- traduc/trunk/postgresql/libpq.xml 2009-04-30 07:30:13 UTC (rev 1314)
+++ traduc/trunk/postgresql/libpq.xml 2009-04-30 21:53:48 UTC (rev 1315)
@@ -71,16 +71,16 @@
<note>
<para>
- On Windows, there is a way to improve performance if a single
- database connection is repeatedly started and shutdown. Internally,
- libpq calls WSAStartup() and WSACleanup() for connection startup
- and shutdown, respectively. WSAStartup() increments an internal
- Windows library reference count which is decremented by WSACleanup().
- When the reference count is just one, calling WSACleanup() frees
- all resources and all DLLs are unloaded. This is an expensive
- operation. To avoid this, an application can manually call
- WSAStartup() so resources will not be freed when the last database
- connection is closed.
+ Sur Windows, il existe un moyen pour améliorer les performances si une
+ connexion seule à la base de données est ouverte puis fermée de façon
+ répétée. En interne, libpq appelle WSAStartup() et WSACleanup()
+ respectivement pour le début et la fin de la transaction. WSAStartup()
+ incrémente un compteur de référence interne à la bibliothèque Windows.
+ Ce compteur est décrémenté par WSACleanup(). Quand le compteur arrive à
+ un, appeler WSACleanup() libère toutes les ressources et toutes les DLL
+ associées. C'est une opération coûteuse. Pour éviter cela, une application
+ peut appeler manuellement WSAStartup() afin que les ressources ne soient
+ pas libérées quand la dernière connexion est fermée.
</para>
</note>
@@ -235,11 +235,12 @@
<term><literal>options</literal></term>
<listitem>
<para>
- Adds command-line options to send to the server at run-time.
- For example, setting this to <literal>-c geqo=off</literal> sets the
- session's value of the <varname>geqo</varname> parameter to
- <literal>off</literal>. For a detailed discussion of the available
- options, consult <xref linkend="runtime-config"/>.
+ Ajout d'options en ligne de commande à envoyer au serveur à
+ l'exécution. Par exemple, en le configurant à <literal>-c
+ geqo=off</literal>, cela configure la valeur de la session
+ pour le paramètre <varname>geqo</varname> à
+ <literal>off</literal>. Pour une discussion détaillée des options
+ disponibles, voir <xref linkend="runtime-config"/>.
</para>
</listitem>
</varlistentry>
@@ -286,35 +287,35 @@
<term><literal>sslverify</literal></term>
<listitem>
<para>
- This option controls how libpq verifies the certificate on the
- server when performing an <acronym>SSL</acronym> connection. There are
- three options: <literal>none</literal> disables verification completely
- (not recommended); <literal>cert</literal> enables verification that
- the server certificate chains to a known certificate
- authority (CA); <literal>cn</literal> will both verify that the
- certificate chains to a known CA and that the <literal>cn</literal>
- attribute of the server certificate matches the server's
- hostname (default).
+ Cette option contrôle la façon dont libpq vérifie le certificat sur
+ le serveur lors de la connexion <acronym>SSL</acronym>. Il existe
+ trois options : <literal>none</literal> désactive complètement
+ la vérification (non recommandé) ; <literal>cert</literal>
+ active la vérification que le certificat serveur est lié à un
+ certificat d'autorité connu (CA) ; <literal>cn</literal>
+ vérifiera que le certificat est lié à un CA connu et que
+ l'attribut <literal>cn</literal> du certificat serveur
+ correspond au nom d'hôte du serveur (valeur par défaut).
</para>
<para>
- It is always recommended to use the <literal>cn</literal> value for
- this parameter, since this is the only option that prevents
- man-in-the-middle attacks. Note that this requires the server
- name on the certificate to match exactly with the host name
- used for the connection, and therefore does not support connections
- to aliased names. It can be used with pure IP address connections
- only if the certificate also has just the IP address in the
- <literal>cn</literal> field.
+ Il est toujours recommandé d'utiliser la valeur <literal>cn</literal>
+ pour ce paramètre car c'est la seule option qui empêche les attaques
+ de type <foreignphrase>man-in-the-middle</foreignphrase>. Notez que
+ ceci nécessite que le nom du serveur sur le certificat corresponde
+ au nom d'hôte utilisé pour la connexion, et du coup ne supporte pas
+ la connexion vers des alias. Il peut être utilisé avec des connexions
+ d'adresses IP seulement si le certificat a aussi l'adresse IP dans
+ le champ <literal>cn</literal>.
</para>
<para>
- If the <literal>cn</literal> attribute in the certificate sent by the
- server starts with an asterisk (<literal>*</literal>), it will be treated
- as a wildcard. This wildcard can only be present at the start of
- the value, and will match all characters <emphasis>except</emphasis> a
- dot (<literal>.</literal>). This means the certificate will not match
- subdomains.
+ Si l'attribut <literal>cn</literal> dans le certificat envoyé par le
+ serveur commence avec une étoile (<literal>*</literal>), il sera
+ traité comme un joker. Ce joker sera seulement présent au début de
+ la valeur et correspondra à tous les caractères
+ <emphasis>sauf</emphasis> un point (<literal>.</literal>). Cela
+ signifie que le certificat ne correspondra pas aux sous-domaines.
</para>
</listitem>
</varlistentry>
@@ -343,8 +344,7 @@
<term><literal>sslcert</literal></term>
<listitem>
<para>
- This parameter specifies the file name of the client SSL
- certificate.
+ Ce paramètre indique le nom du fichier du certificat SSL client.
</para>
</listitem>
</varlistentry>
@@ -353,13 +353,14 @@
<term><literal>sslkey</literal></term>
<listitem>
<para>
- This parameter specifies the location for the secret key
- used for the client certificate. It can either specify a filename
- that will be used instead of the default
- <filename>~/.postgresql/postgresql.key</filename>, or can specify an external
- engine (engines are <productname>OpenSSL</productname> loadable modules). The
- external engine specification should consist of a colon-separated
- engine name and an engine-specific key identifier.
+ Ce paramètre indique l'emplacement de la clé secrète utilisée pour
+ le certificat client. Il peut soit indiquer un nom de fichier qui
+ sera utilisé à la place du fichier
+ <filename>~/.postgresql/postgresql.key</filename> par défaut, soit
+ indiquer un moteur externe (les moteurs sont des modules chargeables
+ d'<productname>OpenSSL</productname>). La spécification du moteur
+ externe devrait consister en un nom de moteur et un identifiant de
+ clé spécifique au moteur, les deux séparés par une virgule.
</para>
</listitem>
</varlistentry>
@@ -368,7 +369,7 @@
<term><literal>sslrootcert</literal></term>
<listitem>
<para>
- This parameter specifies the file name of the root SSL certificate.
+ Ce paramètre indique le nom du fichier du certificat SSL racine.
</para>
</listitem>
</varlistentry>
@@ -377,8 +378,8 @@
<term><literal>sslcrl</literal></term>
<listitem>
<para>
- This parameter specifies the file name of the SSL certificate
- revocation list (CRL).
+ Ce paramètre indique le nom du fichier de la liste de révocation
+ du certificat SSL.
</para>
</listitem>
</varlistentry>
@@ -1239,8 +1240,8 @@
</para>
<para>
- Cette fonction can be applied after either a failed or successful
- connection attempt to detect whether the server demanded a password.
+ Cette fonction peut être utilisée après une connexion, réussie ou en
+ échec, pour détecter si le serveur demande un mot de passe.
</para>
</listitem>
</varlistentry>
@@ -1443,16 +1444,15 @@
tableau est nul, alors tous les paramètres sont présumés être des chaînes
de texte.
</para>
- <para>
- Values passed in binary format require knowlege of
- the internal representation expected by the backend.
- For example, integers must be passed in network byte
- order. Passing <type>numeric</type> values requires
- knowledge of the server storage format, as implemented
- in
- <filename>src/backend/utils/adt/numeric.c::numeric_send()</filename> and
- <filename>src/backend/utils/adt/numeric.c::numeric_recv()</filename>.
- </para>
+ <para>
+ Les valeurs passées dans le format binaire nécessitent de connaître la
+ représentation interne attendue par le moteur. Par exemple, les entiers
+ doivent être passés dans l'ordre réseau pour les octets. Passer des
+ valeurs <type>numeric</type> requiert de connaître le format de stockage
+ du serveur, comme implémenté dans
+ <filename>src/backend/utils/adt/numeric.c::numeric_send()</filename> et
+ <filename>src/backend/utils/adt/numeric.c::numeric_recv()</filename>.
+ </para>
</listitem>
</varlistentry>
@@ -4102,25 +4102,24 @@
<listitem>
<para>
- Frees memory allocated by <application>libpq</application>.
+ Libère la mémoire allouée par <application>libpq</application>.
<synopsis>
void PQfreemem(void *ptr);
</synopsis>
</para>
<para>
- Frees memory allocated by <application>libpq</application>, particularly
- <function>PQescapeByteaConn</function>,
- <function>PQescapeBytea</function>,
- <function>PQunescapeBytea</function>,
- and <function>PQnotifies</function>.
- It is particularly important that this function, rather than
- <function>free()</function>, be used on Microsoft Windows. This is because
- allocating memory in a DLL and releasing it in the application works
- only if multithreaded/single-threaded, release/debug, and static/dynamic
- flags are the same for the DLL and the application. On non-Microsoft
- Windows platforms, this function is the same as the standard library
- function <function>free()</function>.
+ Libère la mémoire allouée par <application>libpq</application>,
+ particulièrement <function>PQescapeByteaConn</function>,
+ <function>PQescapeBytea</function>, <function>PQunescapeBytea</function>,
+ et <function>PQnotifies</function>. Il est particulièrement important
+ que cette fonction, plutôt que <function>free()</function>, soit utilisée
+ sur Microsoft Windows. Ceci est dû à l'allocation de la mémoire dans une
+ DLL et la relâcher dans l'application fonctionne seulement si les drapeaux
+ multi-thread/mon-thread, release/debug et static/dynamic sont les mêmes
+ pour la DLL et l'application. Sur les plateformes autres que Microsoft
+ Windows, cette fonction est identique à la fonction
+ <function>free()</function> de la bibliothèque standard.
</para>
</listitem>
</varlistentry>
@@ -4135,8 +4134,8 @@
<listitem>
<para>
- Frees the data structures allocated by
- <function>PQconndefaults</function> or
+ Libère les structures de données allouées par
+ <function>PQconndefaults</function> ou
<function>PQconninfoParse</function>.
<synopsis>
void PQconninfoFree(PQconninfoOption *connOptions);
@@ -4144,8 +4143,8 @@
</para>
<para>
- A simple <function>PQfreemem</function> will not do for this, since
- the array contains references to subsidiary strings.
+ Un simple appel à <function>PQfreemem</function> ne suffira pas car le
+ tableau contient des références à des chaînes supplémentaires.
</para>
</listitem>
</varlistentry>
@@ -5566,12 +5565,11 @@
</para>
<para>
- When the <literal>sslverify</literal> parameter is set to
- <literal>cn</literal> or
- <literal>cert</literal>, libpq will verify that the server certificate is
- trustworthy by checking the certificate chain up to a <acronym>CA</acronym>.
- For this to work, place the certificate of a trusted <acronym>CA</acronym>
- in the
+ Quand le paramètre <literal>sslverify</literal> est configuré à
+ <literal>cn</literal> ou <literal>cert</literal>, libpq vérifiera que le
+ certificat du serveur est de confiance en vérifiant la chaîne du certificat
+ jusqu'à un <acronym>CA</acronym>. Pour que cela fonctione, placez le
+ certificat d'un <acronym>CA</acronym> de confiance dans le
fichier <filename>~/.postgresql/root.crt</filename> dans le répertoire
personnel de l'utilisateur.
(Sur Microsoft Windows, le fichier est nommé
@@ -5583,11 +5581,10 @@
vérifiées si le fichier <filename>~/.postgresql/root.crl</filename> existe
(<filename>%APPDATA%\postgresql\root.crl</filename> sur Microsoft
Windows).
- The location of the root certificate store and the CRL can be overridden
- by the connection parameters <literal>sslrootcert</literal> and
- <literal>sslcrl</literal>
- or the environment variables <envar>PGSSLROOTCERT</envar> and
- <envar>PGSSLCRL</envar>.
+ L'emplacement du certificat racine et du CRL peuvent être surchargés avec
+ les paramètres de connexion <literal>sslrootcert</literal> et
+ <literal>sslcrl</literal>, ou les variables d'environnement
+ <envar>PGSSLROOTCERT</envar> et <envar>PGSSLCRL</envar>.
</para>
<para>
@@ -5597,17 +5594,17 @@
personnel de l'utilisateur. Le certificat doit être signé par une des
autorités (<acronym>CA</acronym>) de confiance du serveur. Un fichier de
clé privé correspondant <filename>~/.postgresql/postgresql.key</filename>
- doit aussi être présent. The private
- key file must not allow any access to world or group; achieve this by the
- command <command>chmod 0600 ~/.postgresql/postgresql.key</command>.
- On Microsoft Windows these files are named
- <filename>%APPDATA%\postgresql\postgresql.crt</filename> and
- <filename>%APPDATA%\postgresql\postgresql.key</filename>, and there
- is no special permissions check since the directory is presumed secure.
- The location of the certificate and key files can be overridden by the
- connection parameters <literal>sslcert</literal> and
- <literal>sslkey</literal> or the
- environment variables <envar>PGSSLCERT</envar> and <envar>PGSSLKEY</envar>.
+ doit aussi être présent. Le fichier de clé privée ne doit pas permettre son
+ accès pour le groupe ou pour le reste du monde ; cela se fait avec la
+ commande <command>chmod 0600 ~/.postgresql/postgresql.key</command>. Sur
+ Microsoft Windows, ces fichiers sont nommés
+ <filename>%APPDATA%\postgresql\postgresql.crt</filename> et
+ <filename>%APPDATA%\postgresql\postgresql.key</filename>, et il n'existe pas
+ de vérification de droits car ce répertoire est présumé sécurisé.
+ L'emplacement des fichiers certificat et clé peut être surchargé par les
+ paramètres de connexion <literal>sslcert</literal> et
+ <literal>sslkey</literal>, ou les variables d'environnement
+ <envar>PGSSLCERT</envar> et <envar>PGSSLKEY</envar>.
</para>
<table id="libpq-ssl-file-usage">
Modified: traduc/trunk/postgresql/monitoring.xml
===================================================================
--- traduc/trunk/postgresql/monitoring.xml 2009-04-30 07:30:13 UTC (rev 1314)
+++ traduc/trunk/postgresql/monitoring.xml 2009-04-30 21:53:48 UTC (rev 1315)
@@ -753,10 +753,10 @@
<entry><literal><function>pg_stat_get_activity</function>(<type>integer</type>)</literal></entry>
<entry><type>setof record</type></entry>
<entry>
- Returns a record of information about the backend with the specified pid, or
- one record for each active backend in the system if <symbol>NULL</symbol> is
- specified. The fields returned are the same as in the
- <structname>pg_stat_activity</structname> view
+ Renvoie un ensemble d'informations sur le processus serveur correspondant
+ au PID indiqué, ou un enregistrement pour chaque processus serveur actif
+ sur le système si le PID vaut NULL. Les champs renvoyés sont les mêmes
+ que ceux de la vue <structname>pg_stat_activity</structname>
</entry>
</row>
@@ -764,7 +764,7 @@
<entry><literal><function>pg_stat_get_function_calls</function>(<type>oid</type>)</literal></entry>
<entry><type>bigint</type></entry>
<entry>
- Number of times the function has been called.
+ Nombre d'appels de la fonction.
</entry>
</row>
@@ -772,8 +772,8 @@
<entry><literal><function>pg_stat_get_function_time</function>(<type>oid</type>)</literal></entry>
<entry><type>bigint</type></entry>
<entry>
- Total wall clock time spent in the function, in microseconds. Includes
- the time spent in functions called by this one.
+ Temps passé dans la fonction, en microsecondes. Inclut le temps passé
+ dans les fonctions appelées par cette fonction.
</entry>
</row>
@@ -781,8 +781,8 @@
<entry><literal><function>pg_stat_get_function_self_time</function>(<type>oid</type>)</literal></entry>
<entry><type>bigint</type></entry>
<entry>
- Time spent in only this function. Time spent in called functions
- is excluded.
+ Temps passé uniquement dans cette fonction. Le temps passé dans les
+ fonctions appelantes est exclu.
</entry>
</row>
@@ -790,8 +790,8 @@
<entry><literal><function>pg_stat_get_backend_idset</function>()</literal></entry>
<entry><type>setof integer</type></entry>
<entry>
- Set of currently active server process numbers (from 1 to the
- number of active server processes). See usage example in the text
+ PID des processus serveurs actifs à ce moment (de 1 au nombre de processus
+ serveurs actifs). Voir un exemple d'utilisation dans le texte.
</entry>
</row>
@@ -1124,95 +1124,95 @@
<row>
<entry>transaction-start</entry>
<entry>(LocalTransactionId)</entry>
- <entry>Probe that fires at the start of a new transaction.
- arg0 is the transaction id.</entry>
+ <entry>Sonde qui se déclenche au lancement d'une nouvelle transaction.
+ arg0 est l'identifiant de transaction.</entry>
</row>
<row>
<entry>transaction-commit</entry>
<entry>(LocalTransactionId)</entry>
- <entry>Probe that fires when a transaction completes successfully.
- arg0 is the transaction id.</entry>
+ <entry>Sonde qui se déclenche quand une transaction se termine avec succès.
+ arg0 est l'identifiant de transaction.</entry>
</row>
<row>
<entry>transaction-abort</entry>
<entry>(LocalTransactionId)</entry>
- <entry>Probe that fires when a transaction completes unsuccessfully.
- arg0 is the transaction id.</entry>
+ <entry>Sonde qui se déclenche quand une transaction échoue.
+ arg0 est l'identifiant de transaction.</entry>
</row>
<row>
<entry>query-start</entry>
<entry>(const char *)</entry>
- <entry>Probe that fires when the processing of a query is started.
- arg0 is the query string.</entry>
+ <entry>Sonde qui se déclenche lorsque le traitement d'une requête commence.
+ arg0 est la requête.</entry>
</row>
<row>
<entry>query-done</entry>
<entry>(const char *)</entry>
- <entry>Probe that fires when the processing of a query is complete.
- arg0 is the query string.</entry>
+ <entry>Sonde qui se déclenche lorsque le traitement d'une requête se termine.
+ arg0 est la requête.</entry>
</row>
<row>
<entry>query-parse-start</entry>
<entry>(const char *)</entry>
- <entry>Probe that fires when the parsing of a query is started.
- arg0 is the query string.</entry>
+ <entry>Sonde qui se déclenche lorsque l'analyse d'une requête commence.
+ arg0 est la requête.</entry>
</row>
<row>
<entry>query-parse-done</entry>
<entry>(const char *)</entry>
- <entry>Probe that fires when the parsing of a query is complete.
- arg0 is the query string.</entry>
+ <entry>Sonde qui se déclenche lorsque l'analyse d'une requête se termine.
+ arg0 est la requête.</entry>
</row>
<row>
<entry>query-rewrite-start</entry>
<entry>(const char *)</entry>
- <entry>Probe that fires when the rewriting of a query is started.
- arg0 is the query string.</entry>
+ <entry>Sonde qui se déclenche lorsque la ré-écriture d'une requête commence.
+ arg0 est la requête.</entry>
</row>
<row>
<entry>query-rewrite-done</entry>
<entry>(const char *)</entry>
- <entry>Probe that fires when the rewriting of a query is complete.
- arg0 is the query string.</entry>
+ <entry>Sonde qui se déclenche lorsque la ré-écriture d'une requête se termine.
+ arg0 est la requête.</entry>
</row>
<row>
<entry>query-plan-start</entry>
<entry>()</entry>
- <entry>Probe that fires when the planning of a query is started.</entry>
+ <entry>Sonde qui se déclenche lorsque la planification d'une requête commence.</entry>
</row>
<row>
<entry>query-plan-done</entry>
<entry>()</entry>
- <entry>Probe that fires when the planning of a query is complete.</entry>
+ <entry>Sonde qui se déclenche lorsque la planification d'une requête se termine.</entry>
</row>
<row>
<entry>query-execute-start</entry>
<entry>()</entry>
- <entry>Probe that fires when the execution of a query is started.</entry>
+ <entry>Sonde qui se déclenche lorsque l'exécution d'une requête commence.</entry>
</row>
<row>
<entry>query-execute-done</entry>
<entry>()</entry>
- <entry>Probe that fires when the execution of a query is complete.</entry>
+ <entry>Sonde qui se déclenche lorsque l'exécution d'une requête se termine.</entry>
</row>
<row>
<entry>statement-status</entry>
<entry>(const char *)</entry>
- <entry>Probe that fires anytime the server process updates its
+ <entry>Sonde qui se déclenche anytime the server process updates its
<structname>pg_stat_activity</structname>.<structfield>current_query</structfield> status.
arg0 is the new status string.</entry>
</row>
<row>
<entry>checkpoint-start</entry>
<entry>(int)</entry>
- <entry>Probe that fires when a checkpoint is started.
+ <entry>Sonde qui se déclenche when a checkpoint is started.
arg0 holds the bitwise flags used to distinguish different checkpoint
types, such as shutdown, immediate or force.</entry>
</row>
<row>
<entry>checkpoint-done</entry>
<entry>(int, int, int, int, int)</entry>
- <entry>Probe that fires when a checkpoint is complete.
+ <entry>Sonde qui se déclenche when a checkpoint is complete.
(The probes listed next fire in sequence during checkpoint processing.)
arg0 is the number of buffers written. arg1 is the total number of
buffers. arg2, arg3 and arg4 contain the number of xlog file(s) added,
@@ -1221,20 +1221,20 @@
<row>
<entry>clog-checkpoint-start</entry>
<entry>(bool)</entry>
- <entry>Probe that fires when the CLOG portion of a checkpoint is started.
+ <entry>Sonde qui se déclenche when the CLOG portion of a checkpoint is started.
arg0 is true for normal checkpoint, false for shutdown
checkpoint.</entry>
</row>
<row>
<entry>clog-checkpoint-done</entry>
<entry>(bool)</entry>
- <entry>Probe that fires when the CLOG portion of a checkpoint is
+ <entry>Sonde qui se déclenche when the CLOG portion of a checkpoint is
complete. arg0 has the same meaning as for clog-checkpoint-start.</entry>
</row>
<row>
<entry>subtrans-checkpoint-start</entry>
<entry>(bool)</entry>
- <entry>Probe that fires when the SUBTRANS portion of a checkpoint is
+ <entry>Sonde qui se déclenche when the SUBTRANS portion of a checkpoint is
started.
arg0 is true for normal checkpoint, false for shutdown
checkpoint.</entry>
@@ -1242,14 +1242,14 @@
<row>
<entry>subtrans-checkpoint-done</entry>
<entry>(bool)</entry>
- <entry>Probe that fires when the SUBTRANS portion of a checkpoint is
+ <entry>Sonde qui se déclenche when the SUBTRANS portion of a checkpoint is
complete. arg0 has the same meaning as for
subtrans-checkpoint-start.</entry>
</row>
<row>
<entry>multixact-checkpoint-start</entry>
<entry>(bool)</entry>
- <entry>Probe that fires when the MultiXact portion of a checkpoint is
+ <entry>Sonde qui se déclenche when the MultiXact portion of a checkpoint is
started.
arg0 is true for normal checkpoint, false for shutdown
checkpoint.</entry>
@@ -1257,14 +1257,14 @@
<row>
<entry>multixact-checkpoint-done</entry>
<entry>(bool)</entry>
- <entry>Probe that fires when the MultiXact portion of a checkpoint is
+ <entry>Sonde qui se déclenche when the MultiXact portion of a checkpoint is
complete. arg0 has the same meaning as for
multixact-checkpoint-start.</entry>
</row>
<row>
<entry>buffer-checkpoint-start</entry>
<entry>(int)</entry>
- <entry>Probe that fires when the buffer-writing portion of a checkpoint
+ <entry>Sonde qui se déclenche when the buffer-writing portion of a checkpoint
is started.
arg0 holds the bitwise flags used to distinguish different checkpoint
types, such as shutdown, immediate or force.</entry>
@@ -1272,7 +1272,7 @@
<row>
<entry>buffer-sync-start</entry>
<entry>(int, int)</entry>
- <entry>Probe that fires when we begin to write dirty buffers during
+ <entry>Sonde qui se déclenche when we begin to write dirty buffers during
checkpoint (after identifying which buffers must be written).
arg0 is the total number of buffers.
arg1 is the number that are currently dirty and need to be written.</entry>
@@ -1280,13 +1280,13 @@
<row>
<entry>buffer-sync-written</entry>
<entry>(int)</entry>
- <entry>Probe that fires after each buffer is written during checkpoint.
+ <entry>Sonde qui se déclenche after each buffer is written during checkpoint.
arg0 is the ID number of the buffer.</entry>
</row>
<row>
<entry>buffer-sync-done</entry>
<entry>(int, int, int)</entry>
- <entry>Probe that fires when all dirty buffers have been written.
+ <entry>Sonde qui se déclenche when all dirty buffers have been written.
arg0 is the total number of buffers.
arg1 is the number of buffers actually written by the checkpoint process.
arg2 is the number that were expected to be written (arg1 of
@@ -1296,31 +1296,31 @@
<row>
<entry>buffer-checkpoint-sync-start</entry>
<entry>()</entry>
- <entry>Probe that fires after dirty buffers have been written to the
+ <entry>Sonde qui se déclenche after dirty buffers have been written to the
kernel, and before starting to issue fsync requests.</entry>
</row>
<row>
<entry>buffer-checkpoint-done</entry>
<entry>()</entry>
- <entry>Probe that fires when syncing of buffers to disk is
+ <entry>Sonde qui se déclenche when syncing of buffers to disk is
complete.</entry>
</row>
<row>
<entry>twophase-checkpoint-start</entry>
<entry>()</entry>
- <entry>Probe that fires when the two-phase portion of a checkpoint is
+ <entry>Sonde qui se déclenche when the two-phase portion of a checkpoint is
started.</entry>
</row>
<row>
<entry>twophase-checkpoint-done</entry>
<entry>()</entry>
- <entry>Probe that fires when the two-phase portion of a checkpoint is
+ <entry>Sonde qui se déclenche when the two-phase portion of a checkpoint is
complete.</entry>
</row>
<row>
<entry>buffer-read-start</entry>
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid, bool, bool)</entry>
- <entry>Probe that fires when a buffer read is started.
+ <entry>Sonde qui se déclenche when a buffer read is started.
arg0 and arg1 contain the fork and block numbers of the page (but
arg1 will be -1 if this is a relation extension request).
arg2, arg3, and arg4 contain the tablespace, database, and relation OIDs
@@ -1332,7 +1332,7 @@
<row>
<entry>buffer-read-done</entry>
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid, bool, bool, bool)</entry>
- <entry>Probe that fires when a buffer read is complete.
+ <entry>Sonde qui se déclenche when a buffer read is complete.
arg0 and arg1 contain the fork and block numbers of the page (if this
is a relation extension request, arg1 now contains the block number
of the newly added block).
@@ -1346,7 +1346,7 @@
<row>
<entry>buffer-flush-start</entry>
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid)</entry>
- <entry>Probe that fires before issuing any write request for a shared
+ <entry>Sonde qui se déclenche before issuing any write request for a shared
buffer.
arg0 and arg1 contain the fork and block numbers of the page.
arg2, arg3, and arg4 contain the tablespace, database, and relation OIDs
@@ -1355,7 +1355,7 @@
<row>
<entry>buffer-flush-done</entry>
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid)</entry>
- <entry>Probe that fires when a write request is complete. (Note
+ <entry>Sonde qui se déclenche when a write request is complete. (Note
that this just reflects the time to pass the data to the kernel;
it's typically not actually been written to disk yet.)
The arguments are the same as for buffer-flush-start.</entry>
@@ -1363,7 +1363,7 @@
<row>
<entry>buffer-write-dirty-start</entry>
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid)</entry>
- <entry>Probe that fires when a server process begins to write a dirty
+ <entry>Sonde qui se déclenche when a server process begins to write a dirty
buffer. (If this happens often, it implies that
<xref linkend="guc-shared-buffers"/> is too
small or the bgwriter control parameters need adjustment.)
@@ -1374,13 +1374,13 @@
<row>
<entry>buffer-write-dirty-done</entry>
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid)</entry>
- <entry>Probe that fires when a dirty-buffer write is complete.
+ <entry>Sonde qui se déclenche when a dirty-buffer write is complete.
The arguments are the same as for buffer-write-dirty-start.</entry>
</row>
<row>
<entry>wal-buffer-write-dirty-start</entry>
<entry>()</entry>
- <entry>Probe that fires when when a server process begins to write a
+ <entry>Sonde qui se déclenche when when a server process begins to write a
dirty WAL buffer because no more WAL buffer space is available.
(If this happens often, it implies that
<xref linkend="guc-wal-buffers"/> is too small.)</entry>
@@ -1388,24 +1388,24 @@
<row>
<entry>wal-buffer-write-dirty-done</entry>
<entry>()</entry>
- <entry>Probe that fires when a dirty WAL buffer write is complete.</entry>
+ <entry>Sonde qui se déclenche when a dirty WAL buffer write is complete.</entry>
</row>
<row>
<entry>xlog-insert</entry>
<entry>(unsigned char, unsigned char)</entry>
- <entry>Probe that fires when a WAL record is inserted.
+ <entry>Sonde qui se déclenche when a WAL record is inserted.
arg0 is the resource manager (rmid) for the record.
arg1 contains the info flags.</entry>
</row>
<row>
<entry>xlog-switch</entry>
<entry>()</entry>
- <entry>Probe that fires when a WAL segment switch is requested.</entry>
+ <entry>Sonde qui se déclenche when a WAL segment switch is requested.</entry>
</row>
<row>
<entry>smgr-md-read-start</entry>
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid)</entry>
- <entry>Probe that fires when beginning to read a block from a relation.
+ <entry>Sonde qui se déclenche when beginning to read a block from a relation.
arg0 and arg1 contain the fork and block numbers of the page.
arg2, arg3, and arg4 contain the tablespace, database, and relation OIDs
identifying the relation.</entry>
@@ -1413,7 +1413,7 @@
<row>
<entry>smgr-md-read-done</entry>
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid, int, int)</entry>
- <entry>Probe that fires when a block read is complete.
+ <entry>Sonde qui se déclenche when a block read is complete.
arg0 and arg1 contain the fork and block numbers of the page.
arg2, arg3, and arg4 contain the tablespace, database, and relation OIDs
identifying the relation.
@@ -1423,7 +1423,7 @@
<row>
<entry>smgr-md-write-start</entry>
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid)</entry>
- <entry>Probe that fires when beginning to write a block to a relation.
+ <entry>Sonde qui se déclenche when beginning to write a block to a relation.
arg0 and arg1 contain the fork and block numbers of the page.
arg2, arg3, and arg4 contain the tablespace, database, and relation OIDs
identifying the relation.</entry>
@@ -1431,7 +1431,7 @@
<row>
<entry>smgr-md-write-done</entry>
<entry>(ForkNumber, BlockNumber, Oid, Oid, Oid, int, int)</entry>
- <entry>Probe that fires when a block write is complete.
+ <entry>Sonde qui se déclenche when a block write is complete.
arg0 and arg1 contain the fork and block numbers of the page.
arg2, arg3, and arg4 contain the tablespace, database, and relation OIDs
identifying the relation.
@@ -1441,7 +1441,7 @@
<row>
<entry>sort-start</entry>
<entry>(int, bool, int, int, bool)</entry>
- <entry>Probe that fires when a sort operation is started.
+ <entry>Sonde qui se déclenche when a sort operation is started.
arg0 indicates heap, index or datum sort.
arg1 is true for unique-value enforcement.
arg2 is the number of key columns.
@@ -1451,7 +1451,7 @@
<row>
<entry>sort-done</entry>
<entry>(bool, long)</entry>
- <entry>Probe that fires when a sort is complete.
+ <entry>Sonde qui se déclenche when a sort is complete.
arg0 is true for external sort, false for internal sort.
arg1 is the number of disk blocks used for an external sort,
or kilobytes of memory used for an internal sort.</entry>
@@ -1459,21 +1459,21 @@
<row>
<entry>lwlock-acquire</entry>
<entry>(LWLockId, LWLockMode)</entry>
- <entry>Probe that fires when an LWLock has been acquired.
+ <entry>Sonde qui se déclenche when an LWLock has been acquired.
arg0 is the LWLock's ID.
arg1 is the requested lock mode, either exclusive or shared.</entry>
</row>
<row>
<entry>lwlock-release</entry>
<entry>(LWLockId)</entry>
- <entry>Probe that fires when an LWLock has been released (but note
+ <entry>Sonde qui se déclenche when an LWLock has been released (but note
that any released waiters have not yet been awakened).
arg0 is the LWLock's ID.</entry>
</row>
<row>
<entry>lwlock-wait-start</entry>
<entry>(LWLockId, LWLockMode)</entry>
- <entry>Probe that fires when an LWLock was not immediately available and
+ <entry>Sonde qui se déclenche when an LWLock was not immediately available and
a server process has begun to wait for the lock to become available.
arg0 is the LWLock's ID.
arg1 is the requested lock mode, either exclusive or shared.</entry>
@@ -1481,7 +1481,7 @@
<row>
<entry>lwlock-wait-done</entry>
<entry>(LWLockId, LWLockMode)</entry>
- <entry>Probe that fires when a server process has been released from its
+ <entry>Sonde qui se déclenche when a server process has been released from its
wait for an LWLock (it does not actually have the lock yet).
arg0 is the LWLock's ID.
arg1 is the requested lock mode, either exclusive or shared.</entry>
@@ -1489,7 +1489,7 @@
<row>
<entry>lwlock-condacquire</entry>
<entry>(LWLockId, LWLockMode)</entry>
- <entry>Probe that fires when an LWLock was successfully acquired when the
+ <entry>Sonde qui se déclenche when an LWLock was successfully acquired when the
caller specified no waiting.
arg0 is the LWLock's ID.
arg1 is the requested lock mode, either exclusive or shared.</entry>
@@ -1497,7 +1497,7 @@
<row>
<entry>lwlock-condacquire-fail</entry>
<entry>(LWLockId, LWLockMode)</entry>
- <entry>Probe that fires when an LWLock was not successfully acquired when
+ <entry>Sonde qui se déclenche when an LWLock was not successfully acquired when
the caller specified no waiting.
arg0 is the LWLock's ID.
arg1 is the requested lock mode, either exclusive or shared.</entry>
@@ -1505,7 +1505,7 @@
<row>
<entry>lock-wait-start</entry>
<entry>(unsigned int, unsigned int, unsigned int, unsigned int, unsigned int, LOCKMODE)</entry>
- <entry>Probe that fires when a request for a heavyweight lock (lmgr lock)
+ <entry>Sonde qui se déclenche when a request for a heavyweight lock (lmgr lock)
has begun to wait because the lock is not available.
arg0 through arg3 are the tag fields identifying the object being
locked. arg4 indicates the type of object being locked.
@@ -1514,14 +1514,14 @@
<row>
<entry>lock-wait-done</entry>
<entry>(unsigned int, unsigned int, unsigned int, unsigned int, unsigned int, LOCKMODE)</entry>
- <entry>Probe that fires when a request for a heavyweight lock (lmgr lock)
+ <entry>Sonde qui se déclenche when a request for a heavyweight lock (lmgr lock)
has finished waiting (i.e., has acquired the lock).
The arguments are the same as for lock-wait-start.</entry>
</row>
<row>
<entry>deadlock-found</entry>
<entry>()</entry>
- <entry>Probe that fires when a deadlock is found by the deadlock
+ <entry>Sonde qui se déclenche when a deadlock is found by the deadlock
detector.</entry>
</row>
@@ -1530,7 +1530,7 @@
</table>
<table id="typedefs-table">
- <title>Defined Types Used in Probe Parameters</title>
+ <title>Types définis utilisés comme paramètres de sonde</title>
<tgroup cols="2">
<thead>
<row>
@@ -1637,76 +1637,77 @@
<para>
De nouvelles sondes peuvent être définies dans le code partout où le
développeur le souhaite bien que cela nécessite une nouvelle compilation.
- Below are the steps for inserting new probes:
+ Voici les étapes nécessaires pour insérer de nouvelles sondes :
</para>
<procedure>
<step>
<para>
- Decide on probe names and data to be made available through the probes
+ Décider du nom de la sonde et des données nécessaires pour la sonde
</para>
</step>
<step>
<para>
- Add the probe definitions to
+ Ajoutez les définitions de sonde dans
<filename>src/backend/utils/probes.d</filename>
</para>
</step>
<step>
<para>
- Include <filename>pg_trace.h</filename> if it is not already present in the
- module(s) containing the probe points, and insert
- <literal>TRACE_POSTGRESQL</literal> probe macros at the desired locations
- in the source code
+ Inclure <filename>pg_trace.h</filename> s'il n'est pas déjà présent dans le
+ module contenant les points de sonde, et insérer les macros
+ <literal>TRACE_POSTGRESQL</literal> aux emplacements souhaités dans le code
+ source
</para>
</step>
<step>
<para>
- Recompile and verify that the new probes are available
+ Recompiler et vérifier que les nouvelles sondes sont disponibles
</para>
</step>
</procedure>
<formalpara>
- <title>Example:</title>
+ <title>Exemple :</title>
<para>
- Here is an example of how you would add a probe to trace all new
- transactions by transaction ID.
+ Voici un exemple d'ajout d'une sonde pour tracer toutes les nouvelles
+ transactions par identifiant de transaction.
</para>
</formalpara>
<procedure>
<step>
<para>
- Decide that the probe will be named <literal>transaction-start</literal> and
- requires a parameter of type LocalTransactionId
+ La sonde sera nommée <literal>transaction-start</literal> et nécessite
+ un paramètre de type LocalTransactionId
</para>
</step>
<step>
<para>
- Add the probe definition to
- <filename>src/backend/utils/probes.d</filename>:
+ Ajout de la définition de la sonde dans
+ <filename>src/backend/utils/probes.d</filename> :
<programlisting>
probe transaction__start(LocalTransactionId);
</programlisting>
- Note the use of the double underline in the probe name. In a DTrace
- script using the probe, the double underline needs to be replaced with a
- hyphen, so <literal>transaction-start</literal> is the name to document for
- users.
+ Notez l'utilisation du double tiret bas dans le nom de la sonde. Dans un
+ script DTrace utilisant la sonde, le double tiret bas doit être remplacé
+ par un tiret, donc <literal>transaction-start</literal> est le nom à
+ documenter pour les utilisateurs.
</para>
</step>
<step>
<para>
- At compile time, <literal>transaction__start</literal> is converted to a macro
- called <literal>TRACE_POSTGRESQL_TRANSACTION_START</literal> (notice the
- underscores are single here), which is available by including
- <filename>pg_trace.h</filename>. Add the macro call to the appropriate location
- in the source code. In this case, it looks like the following:
+ Au moment de la compilation, <literal>transaction__start</literal> est
+ converti en une macro appelée <literal>TRACE_POSTGRESQL_TRANSACTION_START</literal>
+ (notez que les tirets bas ne sont plus doubles ici), qui est disponible
+ en incluant le fichier <filename>pg_trace.h</filename>. Il faut ajouter
+ l'appel à la macro aux bons emplacements dans le code source. Dans ce
+ cas, cela ressemble à :
<programlisting>
TRACE_POSTGRESQL_TRANSACTION_START(vxid.localTransactionId);
@@ -1716,9 +1717,9 @@
<step>
<para>
- After recompiling and running the new binary, check that your newly added
- probe is available by executing the following DTrace command. You
- should see similar output:
+ Après une nouvelle compilation et l'exécution du nouveau binaire, il
+ faut vérifier que la nouvelle sonde est disponible en exécutant la
+ commande DTrace suivante. Vous deviez avoir cette sortie :
<screen>
# dtrace -ln transaction-start
ID PROVIDER MODULE FUNCTION NAME
@@ -1733,37 +1734,39 @@
</procedure>
<para>
- There are a few things to be careful about when adding trace macros
- to the C code:
+ Il faut faire attention à d'autres choses lors de l'ajout de macros de
+ trace dans le code C :
<itemizedlist>
<listitem>
<para>
- You should take care that the data types specified for a probe's
- parameters match the data types of the variables used in the macro.
- Otherwise, you will get compilation errors.
+ Vous devez faire attention au fait que les types de données indiqués
+ pour les paramètres d'une sonde correspondent aux types de données des
+ variables utilisées dans la macro. Dans le cas contraire, vous obtiendrez
+ des erreurs de compilation.
</para>
</listitem>
<listitem>
<para>
- On most platforms, if <productname>PostgreSQL</productname> is
- built with <option>--enable-dtrace</option>, the arguments to a trace
- macro will be evaluated whenever control passes through the
- macro, <emphasis>even if no tracing is being done</emphasis>. This is
- usually not worth worrying about if you are just reporting the
- values of a few local variables. But beware of putting expensive
- function calls into the arguments. If you need to do that,
- consider protecting the macro with a check to see if the trace
- is actually enabled:
+ Sur la plupart des platformes, si <productname>PostgreSQL</productname>
+ est construit avec <option>--enable-dtrace</option>, les arguments pour
+ une macro de trace seront évalués à chaque fois que le contrôle passe
+ dans la macro, <emphasis>même si aucun traçage n'est réellement en
+ cours</emphasis>. Cela a généralement peu d'importance si vous rapportez
+ seulement les valeurs de quelques variables locales mais faites bien
+ attention à l'utilisation de fonctions coûteuses. Si vous devez le faire,
+ pensez à protéger la macro avec une vérification pour vous assurer que
+ la trace est bien activée :
<programlisting>
if (TRACE_POSTGRESQL_TRANSACTION_START_ENABLED())
TRACE_POSTGRESQL_TRANSACTION_START(some_function(...));
</programlisting>
- Each trace macro has a corresponding <literal>ENABLED</literal> macro.
+ Chaque macro de trace a une macro <literal>ENABLED</literal>
+ correspondante.
</para>
</listitem>
</itemizedlist>
Modified: traduc/trunk/postgresql/plpgsql.xml
===================================================================
--- traduc/trunk/postgresql/plpgsql.xml 2009-04-30 07:30:13 UTC (rev 1314)
+++ traduc/trunk/postgresql/plpgsql.xml 2009-04-30 21:53:48 UTC (rev 1315)
@@ -1066,48 +1066,50 @@
</para>
<para>
- The command string can use parameter values, which are referenced
- in the command as <literal>$1</literal>, <literal>$2</literal>, etc.
- These symbols refer to values supplied in the <literal>USING</literal>
- clause. This method is often preferable to inserting data values
- into the command string as text: it avoids run-time overhead of
- converting the values to text and back, and it is much less prone
- to SQL-injection attacks since there is no need for quoting or escaping.
- An example is:
+ La chaîne de commande peut utiliser des valeurs de paramètres, référencées
+ dans la commande avec <literal>$1</literal>, <literal>$2</literal>, etc.
+ Ces symboles font référence aux valeurs fournies dans la clause
+ <literal>USING</literal>. Cette méthode est souvent préférable à
+ l'insertion des valeurs en texte dans une chaîne de commande : cela
+ évite la surcharge à l'exécution pour la conversion des valeurs en texte
+ et vice-versa. C'est aussi moins sensible aux attaques par injection SQL
+ car il n'est pas nécessaire de mettre entre guillemets ou d'échapper les
+ valeurs. Voici un exemple :
<programlisting>
-EXECUTE 'SELECT count(*) FROM mytable WHERE inserted_by = $1 AND inserted <= $2'
+EXECUTE 'SELECT count(*) FROM matable WHERE insere_par = $1 AND insere <= $2'
INTO c
- USING checked_user, checked_date;
+ USING utilisateur_verifie, date_verifiee;
</programlisting>
- Note that parameter symbols can only be used for data values
- — if you want to use dynamically determined table or column
- names, you must insert them into the command string textually.
- For example, if the preceding query needed to be done against a
- dynamically selected table, you could do this:
+ Notez que les symboles de paramètres peuvent seulement être utilisés pour
+ des valeurs de données — si vous voulez utiliser des noms de tables
+ et/ou colonnes déterminés dynamiquement, vous devez les insérer dans la
+ chaîne de commande en texte. Par exemple, si la requête précédente devait
+ se faire avec une table sélectionnée dynamiquement, vous devriez faire
+ ceci :
<programlisting>
EXECUTE 'SELECT count(*) FROM '
|| tabname::regclass
- || ' WHERE inserted_by = $1 AND inserted <= $2'
+ || ' WHERE insere_par = $1 AND insere <= $2'
INTO c
- USING checked_user, checked_date;
+ USING utilisateur_verifie, date_verifiee;
</programlisting>
</para>
<para>
- An <command>EXECUTE</command> with a simple constant command string and some
- <literal>USING</literal> parameters, as in the first example above, is
- functionally equivalent to just writing the command directly in
- <application>PL/pgSQL</application> and allowing replacement of
- <application>PL/pgSQL</application> variables to happen automatically.
- The important difference is that <command>EXECUTE</command> will re-plan
- the command on each execution, generating a plan that is specific
- to the current parameter values; whereas
- <application>PL/pgSQL</application> normally creates a generic plan
- and caches it for re-use. In situations where the best plan depends
- strongly on the parameter values, <command>EXECUTE</command> can be
- significantly faster; while when the plan is not sensitive to parameter
- values, re-planning will be a waste.
+ Un <command>EXECUTE</command> avec une chaîne de commande constante et des
+ paramètres <literal>USING</literal>, comme dans le premier exemple
+ ci-dessus, est équivalent fonctionnellement à l'écriture simple d'une
+ commande directement dans <application>PL/pgSQL</application> et permet
+ le remplacement automatique des variables <application>PL/pgSQL</application>.
+ La différence importante est que <command>EXECUTE</command> va planifier de
+ nouveau la commande pour chaque exécution, générant un plan qui est
+ spécifique aux valeurs actuelles des paramètres ; alors que
+ <application>PL/pgSQL</application> crée habituellement un plan générique
+ et le stocke pour le réutiliser. Dans des situations où le meilleur plan
+ dépend fortement des valeurs des paramètres, <command>EXECUTE</command>
+ peut être beaucoup plus rapide : alors que lorsque le plan n'est pas
+ sensible aux valeurs des paramètres, la replanification sera une perte.
</para>
<para>
@@ -1186,26 +1188,27 @@
</para>
<para>
- Because <function>quote_literal</function> is labelled
- <literal>STRICT</literal>, it will always return null when called with a
- null argument. In the above example, if <literal>newvalue</literal> or
- <literal>keyvalue</literal> were null, the entire dynamic query string would
- become null, leading to an error from <command>EXECUTE</command>.
- You can avoid this problem by using the <function>quote_nullable</function>
- function, which works the same as <function>quote_literal</function> except that
- when called with a null argument it returns the string
+ Comme <function>quote_literal</function> est labelisé
+ <literal>STRICT</literal>, elle renverra toujours NULL lorsqu'elle est
+ appelée avec un argument NULL. Dans l'exemple ci-dessus, si
+ <literal>nouvelle_valeur</literal> ou <literal>valeur_clé</literal>
+ étaient NULL, la requête dynamique entière deviendrait NULL, amenant une
+ erreur à partir du <command>EXECUTE</command>. Vous pouvez éviter ce
+ problème en utilisant la fonction <function>quote_nullable</function> qui
+ fonctionne de façon identique à <function>quote_literal</function> sauf
+ si elle est appelée avec un argument NULL, elle renvoie la chaîne
<literal>NULL</literal>.
- For example,
+ Par exemple,
<programlisting>
EXECUTE 'UPDATE tbl SET '
- || quote_ident(colname)
+ || quote_ident(nom_colonne)
|| ' = '
- || quote_nullable(newvalue)
+ || quote_nullable(nouvelle_valeur)
|| ' WHERE key = '
- || quote_nullable(keyvalue);
+ || quote_nullable(valeur_clé);
</programlisting>
- If you are dealing with values that might be null, you should usually
- use <function>quote_nullable</function> in place of
+ Si vous travaillez avez des valeurs qui peuvent être NULL, vous devez
+ utiliser <function>quote_nullable</function> à la place de
<function>quote_literal</function>.
</para>
@@ -1696,17 +1699,16 @@
</synopsis>
<para>
- Sometimes there are more than just two alternatives.
- <literal>IF-THEN-ELSIF</literal> provides a convenient
- method of checking several alternatives in turn.
- The <literal>IF</literal> conditions are tested successively
- until the first one that is true is found. Then the
- associated statement(s) are executed, after which control
- passes to the next statement after <literal>END IF</literal>.
- (Any subsequent <literal>IF</literal> conditions are
- <emphasis>not</emphasis>
- tested.) If none of the <literal>IF</literal> conditions is true,
- then the <literal>ELSE</literal> block (if any) is executed.
+ Quelques fois, il existe plus de deux alternatives.
+ <literal>IF-THEN-ELSIF</literal> fournit une méthode agréable pour
+ vérifier différentes alternatives. Les conditions
+ <literal>IF</literal> sont testées successivement jusqu'à trouver la
+ bonne. Alors les instructions associées sont exécutées, puis le
+ contrôle est passé à la prochaine instruction après <literal>END
+ IF</literal>. (Toute autre condition <literal>IF</literal> n'est
+ <emphasis>pas</emphasis> testée.) Si aucune des conditions
+ <literal>IF</literal> n'est vraie, alors le bloc
+ <literal>ELSE</literal> (s'il y en a un) est exécuté.
</para>
<para>
@@ -1726,14 +1728,14 @@
</para>
<para>
- The key word <literal>ELSIF</literal> can also be spelled
+ Le mot clé <literal>ELSIF</literal> peut aussi s'écrire
<literal>ELSEIF</literal>.
</para>
<para>
- An alternative way of accomplishing the same task is to nest
- <literal>IF-THEN-ELSE</literal> statements, as in the
- following example:
+ Une façon alternative d'accomplir la même tâche est d'intégrer les
+ instructions <literal>IF-THEN-ELSE</literal>, comme dans l'exemple
+ suivant :
<programlisting>
IF demo_row.sex = 'm' THEN
@@ -1747,25 +1749,25 @@
</para>
<para>
- However, this method requires writing a matching <literal>END
- IF</literal>
- for each <literal>IF</literal>, so it is much more cumbersome than
- using <literal>ELSIF</literal> when there are many alternatives.
+ Néanmoins, cette méthode requiert d'écrire un <literal>END
+ IF</literal> pour chaque <literal>IF</literal>, donc c'est un peu plus
+ compliqué que d'utiliser <literal>ELSIF</literal> quand il y a beaucoup
+ d'autres alternatives.
</para>
</sect3>
<sect3>
- <title>Simple <literal>CASE</literal></title>
+ <title><literal>CASE</literal> simple</title>
<synopsis>
-CASE <replaceable>search-expression</replaceable>
+CASE <replaceable>expression_recherche</replaceable>
WHEN <replaceable>expression</replaceable> <optional>, <replaceable>expression</replaceable> <optional> ... </optional></optional> THEN
- <replaceable>statements</replaceable>
+ <replaceable>instructions</replaceable>
<optional> WHEN <replaceable>expression</replaceable> <optional>, <replaceable>expression</replaceable> <optional> ... </optional></optional> THEN
- <replaceable>statements</replaceable>
+ <replaceable>instructions</replaceable>
... </optional>
<optional> ELSE
- <replaceable>statements</replaceable> </optional>
+ <replaceable>instructions</replaceable> </optional>
END CASE;
</synopsis>
@@ -1784,31 +1786,31 @@
</para>
<para>
- Here is a simple example:
+ Voici un exemple simple :
<programlisting>
CASE x
WHEN 1, 2 THEN
- msg := 'one or two';
+ msg := 'un ou deux';
ELSE
- msg := 'other value than one or two';
+ msg := 'autre valeur que un ou deux';
END CASE;
</programlisting>
</para>
</sect3>
<sect3>
- <title>Searched <literal>CASE</literal></title>
+ <title><literal>CASE</literal> recherché</title>
<synopsis>
CASE
- WHEN <replaceable>boolean-expression</replaceable> THEN
- <replaceable>statements</replaceable>
- <optional> WHEN <replaceable>boolean-expression</replaceable> THEN
- <replaceable>statements</replaceable>
+ WHEN <replaceable>expression_booléenne</replaceable> THEN
+ <replaceable>instructions</replaceable>
+ <optional> WHEN <replaceable>expression_booléenne</replaceable> THEN
+ <replaceable>instructions</replaceable>
... </optional>
<optional> ELSE
- <replaceable>statements</replaceable> </optional>
+ <replaceable>instructions</replaceable> </optional>
END CASE;
</synopsis>
@@ -1828,23 +1830,23 @@
</para>
<para>
- Here is an example:
+ Voici un exemple :
<programlisting>
CASE
WHEN x BETWEEN 0 AND 10 THEN
- msg := 'value is between zero and ten';
+ msg := 'valeur entre zéro et dix';
WHEN x BETWEEN 11 AND 20 THEN
- msg := 'value is between eleven and twenty';
+ msg := 'valeur entre onze et vingt';
END CASE;
</programlisting>
</para>
<para>
- This form of <command>CASE</command> is entirely equivalent to
- <literal>IF-THEN-ELSIF</literal>, except for the rule that reaching
- an omitted <literal>ELSE</literal> clause results in an error rather
- than doing nothing.
+ Cette forme de <command>CASE</command> est entièrement équivalente à
+ <literal>IF-THEN-ELSIF</literal>, sauf pour la règle qui dit qu'atteindre
+ une clause <literal>ELSE</literal> omise résulte dans une erreur plutôt
+ que ne rien faire.
</para>
</sect3>
@@ -2783,31 +2785,31 @@
</sect2>
<sect2 id="plpgsql-cursor-for-loop">
- <title>Looping Through a Cursor's Result</title>
+ <title>Boucler dans les résultats d'un curseur</title>
<para>
- There is a variant of the <command>FOR</command> statement that allows
- iterating through the rows returned by a cursor. The syntax is:
+ C'est une variante de l'instruction <command>FOR</command> qui permet
+ l'itération sur les lignes renvoyées par un curseur. La syntaxe est :
<synopsis>
<optional> <<<replaceable>label</replaceable>>> </optional>
-FOR <replaceable>recordvar</replaceable> IN <replaceable>bound_cursor</replaceable> <optional> ( <replaceable>argument_values</replaceable> ) </optional> LOOP
- <replaceable>statements</replaceable>
+FOR <replaceable>var_record</replaceable> IN <replaceable>curseur_lié</replaceable> <optional> ( <replaceable>valeurs_argument</replaceable> ) </optional> LOOP
+ <replaceable>instructions</replaceable>
END LOOP <optional> <replaceable>label</replaceable> </optional>;
</synopsis>
- The cursor variable must have been bound to some query when it was
- declared, and it <emphasis>cannot</emphasis> be open already. The
- <command>FOR</command> statement automatically opens the cursor, and it closes
- the cursor again when the loop exits. A list of actual argument value
- expressions must appear if and only if the cursor was declared to take
- arguments. These values will be substituted in the query, in just
- the same way as during an <command>OPEN</command>.
- The variable <replaceable>recordvar</replaceable> is automatically
- defined as type <type>record</type> and exists only inside the loop (any
- existing definition of the variable name is ignored within the loop).
- Each row returned by the cursor is successively assigned to this
- record variable and the loop body is executed.
+ La variable curseur doit avoir été liée à une requête lors de sa déclaration
+ et il <emphasis>ne peut pas</emphasis> être déjà ouvert. L'instruction
+ <command>FOR</command> ouvre automatiquement le curseur, et il ferme
+ le curseur en sortie de la boucle. Une liste des expressions de valeurs
+ des arguments doit apparaître si et seulement si le curseur a été déclaré
+ prendre des arguments. Ces valeurs seront substitutées dans la requête,
+ de la même façon que lors d'un <command>OPEN</command>. La variable
+ variable <replaceable>var_record</replaceable> est définie automatiquement
+ avec le type <type>record</type> et existe seulement dans la boucle (toute
+ définition existante d'un nom de variable est ignorée dans la boucle).
+ Chaque ligne renvoyée par le curseur est successivement affectée à la variable
+ d'enregistrement et le corps de la boucle est exécuté.
</para>
</sect2>
@@ -2829,18 +2831,18 @@
Utilisez l'instruction <command>RAISE</command> pour rapporter des messages et
lever des erreurs.
-<synopsis>RAISE <optional> <replaceable class="parameter">level</replaceable> </optional> '<replaceable class="parameter">format</replaceable>' <optional>, <replaceable class="parameter">expression</replaceable> <optional>, ...</optional></optional> <optional> USING <replaceable class="parameter">option</replaceable> = <replaceable class="parameter">expression</replaceable> <optional>, ... </optional> </optional>;
-RAISE <optional> <replaceable class="parameter">level</replaceable> </optional> <replaceable class="parameter">condition_name</replaceable> <optional> USING <replaceable class="parameter">option</replaceable> = <replaceable class="parameter">expression</replaceable> <optional>, ... </optional> </optional>;
-RAISE <optional> <replaceable class="parameter">level</replaceable> </optional> SQLSTATE '<replaceable class="parameter">sqlstate</replaceable>' <optional> USING <replaceable class="parameter">option</replaceable> = <replaceable class="parameter">expression</replaceable> <optional>, ... </optional> </optional>;
-RAISE <optional> <replaceable class="parameter">level</replaceable> </optional> USING <replaceable class="parameter">option</replaceable> = <replaceable class="parameter">expression</replaceable> <optional>, ... </optional>;
+<synopsis>RAISE <optional> <replaceable class="parameter">niveau</replaceable> </optional> '<replaceable class="parameter">format</replaceable>' <optional>, <replaceable class="parameter">expression</replaceable> <optional>, ...</optional></optional> <optional> USING <replaceable class="parameter">option</replaceable> = <replaceable class="parameter">expression</replaceable> <optional>, ... </optional> </optional>;
+RAISE <optional> <replaceable class="parameter">niveau</replaceable> </optional> <replaceable class="parameter">nom_condition</replaceable> <optional> USING <replaceable class="parameter">option</replaceable> = <replaceable class="parameter">expression</replaceable> <optional>, ... </optional> </optional>;
+RAISE <optional> <replaceable class="parameter">niveau</replaceable> </optional> SQLSTATE '<replaceable class="parameter">état_sql</replaceable>' <optional> USING <replaceable class="parameter">option</replaceable> = <replaceable class="parameter">expression</replaceable> <optional>, ... </optional> </optional>;
+RAISE <optional> <replaceable class="parameter">niveau</replaceable> </optional> USING <replaceable class="parameter">option</replaceable> = <replaceable class="parameter">expression</replaceable> <optional>, ... </optional>;
RAISE ;
</synopsis>
- The <replaceable class="parameter">level</replaceable> option specifies
- the error severity. Allowed niveaux sont <literal>DEBUG</literal>,
+ L'option <replaceable class="parameter">niveau</replaceable> indique la
+ sévérité de l'erreur. Les niveaux autorisés sont <literal>DEBUG</literal>,
<literal>LOG</literal>, <literal>INFO</literal>, <literal>NOTICE</literal>,
- <literal>WARNING</literal> et <literal>EXCEPTION</literal>, with <literal>EXCEPTION</literal>
- being the default.
+ <literal>WARNING</literal> et <literal>EXCEPTION</literal>, ce dernier étant
+ la valeur par défaut.
<literal>EXCEPTION</literal> lève une erreur (ce qui annule habituellement
la transaction en cours). Les autres niveaux ne font que générer des messages aux
différents niveaux de priorité.
@@ -2851,15 +2853,14 @@
</para>
<para>
- After <replaceable class="parameter">level</replaceable> if any,
- you can write a <replaceable class="parameter">format</replaceable>
- (which must be a simple string literal, not an expression). The
- format string specifies the error message text to be reported.
- The format string can be followed
- by optional argument expressions to be inserted into the message.
- Inside the format string, <literal>%</literal> is replaced by the
- string representation of the next optional argument's value. Write
- <literal>%%</literal> to emit a literal <literal>%</literal>.
+ Après <replaceable class="parameter">niveau</replaceable>, vous pouvez
+ écrire un <replaceable class="parameter">format</replaceable>
+ (qui doit être une chaîne litérale, pas une expression). La chaîne format
+ indique le texte du message d'erreur à rapporter. Elle peut être suivie
+ par des expressions optionnelles à insérer dans le message. Dans la chaîne,
+ <literal>%</literal> est remplacé par la représentation de la valeur du
+ prochain argument. Écrivez <literal>%%</literal> pour saisir un
+ <literal>%</literal> litéral.
</para>
<para>
@@ -2891,15 +2892,16 @@
</para>
<para>
- This example will abort the transaction with the given error message
- and hint:
+ Cet exemple annulera la transaction avec le message d'erreur et l'astuce
+ donnés :
<programlisting>
RAISE EXCEPTION 'Nonexistent ID --> %', user_id USING HINT = 'Please check your user id';
</programlisting>
</para>
<para>
- These two examples show equivalent ways of setting the SQLSTATE:
+ Ces deux exemples affichent des façons équivalents pour initialiser
+ SQLSTATE :
<programlisting>
RAISE 'Duplicate user ID: %', user_id USING ERRCODE = 'unique_violation';
RAISE 'Duplicate user ID: %', user_id USING ERRCODE = '23505';
@@ -2907,51 +2909,51 @@
</para>
<para>
- There is a second <command>RAISE</command> syntax in which the main argument
- is the condition name or SQLSTATE to be reported, for example:
+ Il existe une deuxième syntaxe <command>RAISE</command> pour laquelle
+ l'argument principale est le nom de la condition ou le SQLSTATE à rapporter,
+ par exemple :
<programlisting>
RAISE division_by_zero;
RAISE SQLSTATE '22012';
</programlisting>
- In this syntax, <literal>USING</literal> can be used to supply a custom
- error message, detail, or hint. Another way to do the earlier
- example is
+ Dans cette syntaxe, <literal>USING</literal> peut être utilisé pour fournir
+ un message d'erreur, un détail ou une astuce personnalisé. Voici une autre
+ façon de faire l'exemple précédent :
<programlisting>
RAISE unique_violation USING MESSAGE = 'Duplicate user ID: ' || user_id;
</programlisting>
</para>
<para>
- Still another variant is to write <literal>RAISE USING</literal> or <literal>RAISE
- <replaceable class="parameter">level</replaceable> USING</literal> and put
- everything else into the <literal>USING</literal> list.
+ Une autre variante est d'écrire <literal>RAISE USING</literal> ou <literal>RAISE
+ <replaceable class="parameter">niveau</replaceable> USING</literal> et de placer
+ tout le reste dans la liste <literal>USING</literal>.
</para>
<para>
- The last variant of <command>RAISE</command> has no parameters at all.
- This form can only be used inside a <literal>BEGIN</literal> block's
- <literal>EXCEPTION</literal> clause;
- it causes the error currently being handled to be re-thrown to the
- next enclosing block.
+ La dernière variante de <command>RAISE</command> n'a aucun paramètre. Cette
+ forme peut seulement être utilisée dans un bloc <literal>BEGIN</literal>
+ d'une clause <literal>EXCEPTION</literal> ; cela fait que l'erreur est
+ renvoyée au prochain bloc englobant.
</para>
<para>
- If no condition name nor SQLSTATE is specified in a
- <command>RAISE EXCEPTION</command> command, the default is to use
- <literal>RAISE_EXCEPTION</literal> (<literal>P0001</literal>). If no message
- text is specified, the default is to use the condition name or
- SQLSTATE as message text.
+ Si aucun nom de condition ou SQLSTATE n'est indiqué dans une commande
+ <command>RAISE EXCEPTION</command>, la valeur par défaut est d'utiliser
+ <literal>RAISE_EXCEPTION</literal> (<literal>P0001</literal>). Si aucun
+ message texte n'est indiqué, la valeur par défaut est d'utiliser le nom
+ de la condition ou le SQLSTATE comme texte de message.
</para>
<note>
<para>
- When specifying an error code by SQLSTATE code, you are not
- limited to the predefined error codes, but can select any
- error code consisting of five digits and/or upper-case ASCII
- letters, other than <literal>00000</literal>. It is recommended that
- you avoid throwing error codes that end in three zeroes, because
- these are category codes and can only be trapped by trapping
- the whole category.
+ Lors de la spécification du code d'erreur par un code SQLSTATE, vous n'êtes
+ pas limité aux codes d'erreur prédéfinis, mais pouvez sélectionner tout
+ code d'erreur consistant en cinq chiffres et/ou des lettres ASCII
+ majuscules, autre que <literal>00000</literal>. Il est recommandé d'éviter
+ d'envoyer des codes d'erreur qui se terminent avec trois zéros car il y a
+ des codes de catégorie, et peuvent seulement être récupérés en filtrant
+ la catégorie complète.
</para>
</note>
</sect1>
@@ -4050,18 +4052,18 @@
<listitem>
<para>
- <command>FOR</command> loops over queries (other than cursors) also work
- differently: the target variable(s) must have been declared,
- whereas <application>PL/SQL</application> always declares them implicitly.
- An advantage of this is that the variable values are still accessible
- after the loop exits.
+ Les boucles <command>FOR</command> sur des requêtes (autres que des
+ curseurs) fonctionnent aussi différemment : la variable cible doit
+ avoir été déclarée alors que <application>PL/SQL</application> les déclare
+ toujours implicitement. Un avantage de ceci est que les valeurs des
+ variables sont toujours accessibles à la sortie de la boucle.
</para>
</listitem>
<listitem>
<para>
- There are various notational differences for the use of cursor
- variables.
+ Il existe plusieurs différences de notation pour l'utilisation des
+ variables curseurs.
</para>
</listitem>
Plus d'informations sur la liste de diffusion Trad