[Trad] [svn:pgfr] r1115 - traduc/trunk/postgresql
admin at listes.postgresql.fr
admin at listes.postgresql.fr
Mar 5 Aou 17:26:25 CEST 2008
Author: sas
Date: 2008-08-05 17:26:24 +0200 (Tue, 05 Aug 2008)
New Revision: 1115
Modified:
traduc/trunk/postgresql/func.xml
Log:
Relcture en cours, toujours
Modified: traduc/trunk/postgresql/func.xml
===================================================================
--- traduc/trunk/postgresql/func.xml 2008-07-28 17:52:47 UTC (rev 1114)
+++ traduc/trunk/postgresql/func.xml 2008-08-05 15:26:24 UTC (rev 1115)
@@ -4610,7 +4610,6 @@
<!-- SAS 20070731 : gourmandise est un terme sympathique, mais est-ce le
meilleur ?-->
-<!-- SAS::ICI -->
<para>
La gourmandise d'une ER est déterminée par les règles
suivantes :
@@ -4690,13 +4689,13 @@
SELECT SUBSTRING('XY1234Z', 'Y*?([0-9]{1,3})');
<lineannotation>Resultat : </lineannotation><computeroutput>1</computeroutput></screen>
Dans le premier cas, l'ER dans son intégralité est gourmande parce que <literal>Y*</literal>
- est gourmand. Elle peut correspondre au début de <literal>Y</literal> et
- établlit une correspondance avec la chaîne la plus longue à partir de là,
+ est gourmand. Il peut établir une correspondance qui débute à <literal>Y</literal> et
+ correspondre à la chaîne la plus longue à partir de là,
soit <literal>Y123</literal>. La sortie reprend la partie entre parenthèses, soit
<literal>123</literal>. Dans le second cas, l'ER dans son ensemble n'est
pas gourmande
- car <literal>Y*?</literal> ne l'est pas. Elle peut correspondre au
- début de <literal>Y</literal> et établit une correspondance avec la chaîne la plus courte
+ car <literal>Y*?</literal> ne l'est pas. Il peut établir une
+ correspondance qui débute à <literal>Y</literal> et correspond à la chaîne la plus courte
à partir de là, soit <literal>Y1</literal>. La sous-expression
<literal>[0-9]{1,3}</literal> est gourmande mais elle ne peut pas changer la
décision sur la longueur totale de la correspondance ; elle ne peut
@@ -4801,7 +4800,7 @@
</para>
<para>
- Un grand nombre d'extensions ERA sont empruntées de Perl mais certaines
+ Un grand nombre d'extensions ERA sont empruntées à Perl mais certaines
ont été modifiées et quelques extensions Perl ne sont pas
présentes. Les incompatibilités incluent <literal>\b</literal>, <literal>\B</literal>,
le manque de traitement spécial pour le retour à la ligne en fin de chaîne,
@@ -4852,14 +4851,14 @@
délimiteurs de frontières sont <literal>\{</literal> et <literal>\}</literal>, avec <literal>{</literal> et
<literal>}</literal> étant eux-même des caractères ordinaires. Les parenthèses
pour les sous-expressions imbriquées sont <literal>\(</literal> et <literal>\)</literal>,
- avec <literal>(</literal> et <literal>)</literal> eux-mêmes des caractères
+ <literal>(</literal> et <literal>)</literal> restent des caractères
ordinaires. <literal>^</literal> est un caractère ordinaire sauf au début d'une ER
ou au début d'une sous-expression entre parenthèses,
<literal>$</literal> est un caractère ordinaire sauf à la fin d'une ER
ou à la fin d'une sous-expression entre parenthèses et
<literal>*</literal> est un caractère ordinaire s'il apparaît au début d'une ER ou
au début d'une sous-expression entre parenthèses (après un possible
- <literal>^</literal>). Enfin, les références arrières à un chiffre sont disponibles, et
+ <literal>^</literal>). Enfin, les rétro-références à un chiffre sont disponibles, et
<literal>\<</literal> et <literal>\></literal> sont des synonymes pour
respectivement <literal>[[:<:]]</literal> et <literal>[[:>:]]</literal> ;
aucun autre échappement n'est disponible.
@@ -4906,9 +4905,9 @@
<para>
La fonction <function>to_timestamp</function> peut aussi prendre un
argument <type>double precision</type> unique pour convertir une valeur de type
- epoch Unix en <type>timestamp with time zone</type>
- (les types epoch Unix (<type>entier</type>) sont implicitement convertis en
- <type>double precision</type>).
+ epoch Unix en <type>timestamp with time zone</type>.
+ (Les types epoch Unix (<type>entier</type>) sont implicitement convertis en
+ <type>double precision</type>.)
</para>
<table id="functions-formatting-table">
@@ -5001,7 +5000,7 @@
Dans une chaîne de modèle de sortie (pour <function>to_char</function>), certains
modèles sont reconnus et remplacés par des données proprement formatées
issues de la valeur à formater. Tout texte qui n'est pas un motif du modèle est
- copié sans modification. De même, dans une chaîne de modèle d'entrée (pour tout
+ copié sans modification. De même, dans une chaîne modèle en entrée (pour tout
sauf <function>to_char</function>), les motifs du modèle identifient les parties de la
chaîne en entrée à rechercher et les valeurs à trouver.
</para>
@@ -5274,9 +5273,11 @@
</thead>
<tbody>
<row>
+ <!-- SAS 20080730 : padding : complétion ou complément ? Complétement ne
+ me paraît pas bon -->
<entry>préfixe <literal>FM</literal></entry>
<entry>mode remplissage (<foreignphrase>Fill Mode</foreignphrase>)
- (supprime les espaces et les zéros)</entry>
+ (supprime les espaces et les zéros de complétion)</entry>
<entry><literal>FMMonth</literal></entry>
</row>
<row>
@@ -5325,7 +5326,7 @@
<!-- trailing blanks, blank padded, leading zeros... -->
<listitem>
<para>
- <literal>TM</literal> n'inclut pas d'espaces en fin de chaîne ;
+ <literal>TM</literal> n'inclut pas les espaces de compéltion en fin de chaîne ;
</para>
</listitem>
@@ -5334,7 +5335,7 @@
<function>to_timestamp</function> et <function>to_date</function>
ignorent les espaces multiples de la chaîne en entrée si l'option
<literal>FX</literal> n'est pas utilisée. <literal>FX</literal> doit
- être indiqué comme premier élément du modèle. Par exemple,
+ être indiquée comme premier élément du modèle. Par exemple,
<literal>to_timestamp('2000 JUN', 'YYYY
MON')</literal> est correct mais
<literal>to_timestamp('2000 JUN', 'FXYYYY
@@ -5362,8 +5363,8 @@
<para>
pour afficher un guillemet double dans la sortie, il faut le faire
précéder d'un antislash. <literal>E'\\"YYYY
- Month\\"'</literal>, par exemple <!-- "" font-lock sanity :-) -->
- (deux antislashs sont nécessaire parce que l'antislash a
+ Month\\"'</literal>, par exemple. <!-- "" font-lock sanity :-) -->
+ (Deux antislashs sont nécessaire parce que l'antislash a
déjà une signification spéciale lors de l'utilisation de la syntaxe
d'échappement des chaînes) ;
</para>
@@ -5399,20 +5400,20 @@
<listitem>
<para>
Une date de semaine ISO (distinct de la date grégorienne) peut être
- spécifiée à <function>to_timestamp</function> et <function>to_date</function>
+ passée à <function>to_timestamp</function> et <function>to_date</function>
de deux façons :
<itemizedlist>
<listitem>
<para>
- Année, semaine et jour de la semaine... par exemple,
+ Année, semaine et jour de la semaine. Par exemple,
<literal>to_date('2006-42-4', 'IYYY-IW-ID')</literal> renvoie la date
- <literal>2006-10-19</literal>. Si vous omettez le jour de la semaine,
- le jour utilisé sera le lundi.
+ <literal>2006-10-19</literal>. En cas d'omission du jour de la semaine,
+ lundi est utilisé.
</para>
</listitem>
<listitem>
<para>
- Année et jour de l'année... par exemple,
+ Année et jour de l'année. Par exemple,
<literal>to_date('2006-291', 'IYYY-IDDD')</literal> renvoie aussi <literal>2006-10-19</literal>.
</para>
</listitem>
@@ -5420,12 +5421,12 @@
</para>
<para>
Tenter de construire une date en utilisant un mélange de semaine ISO et
- de champs de date grégoriens n'a pas de sens et pourrait faire que vous
- vous trouviez avec des résultats incohérents. Dans le contexte d'une année
- ISO, le concept d'un mois (month) ou du jour d'un mois (day of month) n'a
+ de champs de date grégoriens n'a pas de sens et peut amener des
+ résultats incohérents. Dans le contexte d'une année
+ ISO, les concepts de mois (month) et jour du mois (day of month) n'ont
pas de signification. Dans le contexte d'une année grégorienne, la semaine
- ISO n'a pas de signification. Les utilisateurs doivent faire attention
- à conserver séparés les spécifications de date grégoriennes et ISO.
+ ISO n'a pas de signification. Il est impératif de distinguer
+ les spécifications de dates grégorienne et ISO.
</para>
</listitem>
@@ -5433,8 +5434,8 @@
<para>
les valeurs en millisecondes (<literal>MS</literal>) et microsecondes
(<literal>US</literal>) dans une conversion de chaîne en champ
- de type <type>timestamp</type> sont utilisées comme partie de la
- fraction décimale des secondes. Par exemple,
+ de type <type>timestamp</type> sont utilisées comme partie décimale
+ des secondes. Par exemple,
<literal>to_timestamp('12:3', 'SS:MS')</literal> n'est pas 3
millisecondes mais 300 car la conversion le compte comme 12 + 0,3
secondes. Cela signifie que pour le format <literal>SS:MS</literal>, les
@@ -5442,14 +5443,14 @@
<literal>12:300</literal> indiquent le même nombre de millisecondes.
Pour obtenir trois millisecondes, il faut écrire
<literal>12:003</literal> que la conversion compte comme
- 12 + 0,003 = 12,003 secondes ;
+ 12 + 0,003 = 12,003 secondes.
</para>
<para>
Exemple plus complexe :
<literal>to_timestamp('15:12:02.020.001230', 'HH:MI:SS.MS.US')</literal>
représente 15 heures, 12 minutes et (2 secondes + 20 millisecondes +
- 1230 microsecondes =) 2,021230 secondes.
+ 1230 microsecondes =) 2,021230 secondes ;
</para>
</listitem>
@@ -5494,8 +5495,10 @@
<entry>valeur avec le nombre indiqué de chiffres</entry>
</row>
<row>
+ <!-- SAS 20080730 : leading zeros ? zéros de remplissage, de début de
+ chaîne ? -->
<entry><literal>0</literal></entry>
- <entry>valeur avec des zéros de remplissage avant</entry>
+ <entry>valeur avec des zéros de début de chaîne</entry>
</row>
<row>
<entry><literal>.</literal> (point)</entry>
@@ -5541,7 +5544,7 @@
</row>
<row>
<entry><literal>RN</literal></entry>
- <entry>numéro romain (entrée entre 1 et 3999)</entry>
+ <entry>numéro romain (saisie entre 1 et 3999)</entry>
</row>
<row>
<entry><literal>TH</literal> ou <literal>th</literal></entry>
@@ -5792,7 +5795,7 @@
<para>
Le <xref linkend="functions-datetime-table"/> affiche les fonctions disponibles
- pour le traitement des valeurs date et heure, les détails apparaissant
+ pour le traitement des valeurs date et heure. Les détails sont présentés
dans les sous-sections qui suivent. Le <xref
linkend="operators-datetime-table"/> illustre les comportements des
opérateurs arithmétiques basiques (<literal>+</literal>,
@@ -5810,7 +5813,7 @@
time zone</type> ou <type>timestamp without time zone</type>.
Ces variantes ne sont pas affichées séparément. De plus, les opérateurs
<literal>+</literal> et <literal>*</literal> sont commutatifs (par exemple,
- date + integer et integer + date) ; seule une possibilité est présentée
+ date + integer et integer + date) ; une seule possibilité est présentée
ici.
</para>
@@ -6198,7 +6201,7 @@
<row>
<entry><literal><function>localtimestamp</function></literal></entry>
<entry><type>timestamp</type></entry>
- <entry>Date et heure courante (début de la transaction) ; voir la <xref
+ <entry>Date et heure courantes (début de la transaction) ; voir la <xref
linkend="functions-datetime-current"/>
</entry>
<entry></entry>
@@ -6256,7 +6259,7 @@
<synopsis>( <replaceable>début1</replaceable>, <replaceable>fin1</replaceable> ) OVERLAPS ( <replaceable>début2</replaceable>, <replaceable>fin2</replaceable> )
( <replaceable>début1</replaceable>, <replaceable>longueur1</replaceable> ) OVERLAPS ( <replaceable>début2</replaceable>, <replaceable>longueur2</replaceable> )</synopsis>
Cette expression renvoie vrai (true) lorsque les deux périodes de temps
- (définies par leur point final) se chevauchent, et faux dans le cas
+ (définies par leurs extrémités) se chevauchent, et faux dans le cas
contraire. Les limites peuvent être indiquées comme des paires de
dates, d'heures ou de timestamps ; ou comme une date, une heure ou un
timestamp suivi d'un intervalle.
@@ -6272,10 +6275,10 @@
</lineannotation><computeroutput>false</computeroutput></screen>
<para>
- Lors de l'ajout ou de la soustraction d'une valeur de type
- <type>interval</type> avec une valeur
+ Lors de l'ajout (ou de la soustraction) d'une valeur de type
+ <type>interval</type> à une valeur
de type <type>timestamp with time zone</type>, le composant jours incrémente
- ou décremente la date du <type>timestamp with time zone</type> par le nombre
+ (ou décremente) la date du <type>timestamp with time zone</type> du nombre
de jours indiqués. Avec les modifications occasionnées par les changements
d'heure (avec un fuseau horaire de session qui reconnaît DST), cela
signifie qu'un <literal>interval '1 day'</literal> n'est pas forcément
@@ -6284,18 +6287,18 @@
<literal>timestamp with time zone '2005-04-02 12:00-07' + interval '1 day'
</literal> produit un <literal>timestamp with time zone '2005-04-03
12:00-06'</literal> alors qu'ajouter <literal>interval '24
- hours'</literal> au même <type>timestamp with time zone</type> initial
+ hours'</literal> au <type>timestamp with time zone</type> initial
produit un <literal>timestamp with time zone '2005-04-03
13:00-06'</literal> parce qu'il y a un changement d'heure le <literal>2005-04-03
02:00</literal> pour le fuseau horaire <literal>CST7CDT</literal>.
</para>
<para>
- Notez qu'il peut y avoir une ambiguïté dans le retour de
- <literal>months</literal> par <function>age</function> car les mois n'ont
+ Il peut y avoir une ambiguïté dans le nombre de
+ <literal>months</literal> retournés par <function>age</function> car les mois n'ont
pas tous le même nombre de jours. L'approche de
- <productname>PostgreSQL</productname> utilise le mois à partir de la date
- la plus ancienne entre les deux dates lors du calcul de mois partiels. Par
+ <productname>PostgreSQL</productname> utilise le mois de la date
+ la plus ancienne lors du calcul de mois partiels. Par
exemple, <literal>age('2004-06-01', '2004-04-30')</literal> utilise avril
pour ramener <literal>1 mon 1 day</literal>, alors qu'utiliser mai aurait
ramener <literal>1 mon 2 days</literal> car mai a 31 jours alors qu'avril
@@ -6456,7 +6459,7 @@
<listitem>
<para>
Le jour de la semaine du lundi (<literal>1</literal>) au dimanche
- (<literal>7</literal>)
+ (<literal>7</literal>).
</para>
<screen>
@@ -6464,7 +6467,7 @@
<lineannotation>Résultat : </lineannotation><computeroutput>7</computeroutput>
</screen>
<para>
- Ceci est identique à <literal>dow</literal> sauf pour le dimanche. Ceci
+ Ceci est identique à <literal>dow</literal> sauf pour le dimanche. Cela
correspond à la numérotation du jour de la semaine suivant le format
<acronym>ISO</acronym> 8601.
</para>
@@ -6489,8 +6492,8 @@
<para>
Chaque année <acronym>ISO</acronym> commence avec le lundi de la
- semaine contenant le 4 janvier, donc soit au début janvier, soit
- en fin décembre. L'année <acronym>ISO</acronym> peut être différente de
+ semaine contenant le 4 janvier, donc soit début janvier, soit
+ fin décembre. L'année <acronym>ISO</acronym> peut être différente de
l'année grégorienne. Voir le champ <literal>week</literal> pour plus
d'informations.
</para>
@@ -6595,12 +6598,15 @@
</listitem>
</varlistentry>
+ <!-- SAS leap second : seconde d'ajustement, ajoutée pour rattraper le
+ temps UTC -->
<varlistentry>
<term><literal>second</literal></term>
<listitem>
<para>
Le champs secondes, incluant la partie décimale (0 -
- 59<footnote><simpara>60 si les secondes « leap » sont implantées par
+ 59<footnote><simpara>60 si les secondes d'ajustement
+ (<foreignphrase>leap second</foreignphrase>) sont implantées par
le système d'exploitation.</simpara></footnote>).
</para>
@@ -6725,8 +6731,8 @@
<replaceable>source</replaceable> est une expression de type
<type>timestamp</type> ou <type>interval</type>.
(Les valeurs de type <type>date</type> et
- <type>time</type> sont converties automatiquement en
- respectivement <type>timestamp</type> ou
+ <type>time</type> sont converties automatiquement en,
+ respectivement, <type>timestamp</type> ou
<type>interval</type>).
<replaceable>champ</replaceable> indique la précision avec laquelle tronquer
la valeur en entrée. La valeur de retour est de type
@@ -6961,10 +6967,11 @@
</note>
<para>
- <productname>PostgreSQL</productname> fournit aussi des fonctions qui renvoie
+ <productname>PostgreSQL</productname> fournit aussi des fonctions qui
+ renvoient
l'heure de début de l'instruction en cours, voire l'heure de l'appel de la
- fonction. La liste complète des fonctions, ne faisant pas partie du standard
- SQL, est :
+ fonction. La liste complète des fonctions ne faisant pas partie du standard
+ SQL est :
<synopsis>now() ;
transaction_timestamp() ;
statement_timestamp() ;
@@ -6989,9 +6996,9 @@
fait, sa valeur change même à l'intérieur d'une commande SQL unique.
<function>timeofday()</function> est une fonction historique de
<productname>PostgreSQL</productname>. Comme
- <function>clock_timestamp()</function>, elle renvoie l'heure courante mais
- formatée en tant que chaîne <type>text</type> plutôt qu'en valeur de
- type <type>timestamp with time zone</type>.
+ <function>clock_timestamp()</function>, elle renvoie l'heure courante, mais
+ celle-ci est alors formatée comme une chaîne <type>text</type> et non comme
+ une valeur de type <type>timestamp with time zone</type>.
</para>
<para>
@@ -7001,7 +7008,7 @@
De ce fait, les trois instructions suivantes renvoient le même résultat :
<programlisting>SELECT CURRENT_TIMESTAMP;
SELECT now();
-SELECT TIMESTAMP 'now'; -- incorrect en utilisation avec DEFAULT</programlisting>
+SELECT TIMESTAMP 'now'; -- utilisation incorrecte avec DEFAULT</programlisting>
</para>
<tip>
@@ -7009,12 +7016,12 @@
La troisième forme ne doit pas être utilisée pour la spécification
de la clause <literal>DEFAULT</literal> à la création d'une table. Le système
convertirait <literal>now</literal> en valeur de type
- <type>timestamp</type> dès l'analyse de la constante. À chque fois que la
- valeur par défaut serait nécessaire, c'est l'heure de création de la
- table qui sera utilisée. Les deux premières formes ne sont pas
- évaluées avant l'utilisation de la valeur par défaut car ce sont
- des appels de fonctions. C'est donc bien le comportement attendu d'heure
- d'insertion comme valeur par défaut qui est obtenu.
+ <type>timestamp</type> dès l'analyse de la constante. À chaque fois que la
+ valeur par défaut est nécessaire, c'est l'heure de création de la
+ table qui est alors utilisée. Les deux premières formes ne sont pas
+ évaluées avant l'utilisation de la valeur par défaut, il s'agit
+ d'appels de fonctions. C'est donc bien le comportement attendu, l'heure
+ d'insertion comme valeur par défaut, qui est obtenu.
</para>
</tip>
</sect2>
@@ -7053,14 +7060,14 @@
La résolution réelle de l'intervalle est spécifique à la plateforme ;
0,01 seconde est une valeur habituelle. Le délai dure au minimum celui
précisé. Il peut toutefois être plus long du fait de certains facteurs
- tels la charge serveur.
+ tels que la charge serveur.
</para>
</note>
<warning>
<para>
Il convient de s'assurer que la session courante ne détient pas plus de verrous que
- nécessaire lors de l'appel à <function>pg_sleep</function>. Dans le cas
+ nécessaires lors de l'appel à <function>pg_sleep</function>. Dans le cas
contraire, d'autres sessions peuvent être amenées à attendre que le
processus de retard courant ne termine, ralentissant ainsi tout le système.
</para>
@@ -7099,19 +7106,19 @@
<tbody>
<row>
<entry><literal>enum_first(anyenum)</literal></entry>
- <entry>Renvoit la première valeur du type enum en entrée</entry>
+ <entry>Renvoie la première valeur du type enum en entrée</entry>
<entry><literal>enum_first(null::couleurs)</literal></entry>
<entry><literal>rouge</literal></entry>
</row>
<row>
<entry><literal>enum_last(anyenum)</literal></entry>
- <entry>Renvoit la dernière valeur du type enum en entrée</entry>
+ <entry>Renvoie la dernière valeur du type enum en entrée</entry>
<entry><literal>enum_last(null::couleurs)</literal></entry>
<entry><literal>violet</literal></entry>
</row>
<row>
<entry><literal>enum_range(anyenum)</literal></entry>
- <entry>Renvoit toutes les valeurs du type enum en entrée dans un tableau
+ <entry>Renvoie toutes les valeurs du type enum en entrée dans un tableau
trié</entry>
<entry><literal>enum_range(null::couleurs)</literal></entry>
<entry><literal>{rouge,orange,jaune,vert,bleu,violet}</literal></entry>
@@ -7119,9 +7126,9 @@
<row>
<entry morerows="2"><literal>enum_range(anyenum, anyenum)</literal></entry>
<entry morerows="2">
- Renvoit les éléments entre deux valeurs enum données dans un tableau
+ Renvoie les éléments entre deux valeurs enum données dans un tableau
trié. Les valeurs doivent être du même type enum. Si le premier paramètre
- est NULL, le résultat se terminera avec la dernière valeur du type enum.
+ est NULL, le résultat se termine avec la dernière valeur du type enum.
</entry>
<entry><literal>enum_range('orange'::couleurs, 'vert'::couleurs)</literal></entry>
<entry><literal>{orange,jaune,vert}</literal></entry>
@@ -7139,12 +7146,12 @@
</table>
<para>
- Notez qu'en dehors de la forme à deux arguments de
+ En dehors de la forme à deux arguments de
<function>enum_range</function>, ces fonctions ne tiennent pas compte de
la valeur qui leur est fournie ; elles ne s'attachent qu'au type de
- donnée déclaré. Soit NULL soit une valeur spécifique du type peut être
- passée avec le même résultat. Il est plus commun d'appliquer ces
- fonctions à la colonne d'une table ou à l'argument d'une fonction plutôt
+ donnée déclaré. NULL ou une valeur spécifique du type peut être
+ passée, le résultat est le même. Il est plus commun d'appliquer ces
+ fonctions à la colonne d'une table ou à l'argument d'une fonction
qu'à un nom de type en dur, comme le suggèrent les exemples.
</para>
</sect1>
@@ -7279,7 +7286,7 @@
</row>
<row>
<entry><literal>&<|</literal> </entry>
- <entry>Ne s'étend pas au-dessus ?</entry>
+ <entry>Ne s'étend pas au-dessus de ?</entry>
<entry><literal>box '((0,0),(1,1))' &<| box '((0,0),(2,2))'</literal></entry>
</row>
<row>
@@ -7511,7 +7518,7 @@
<table id="functions-geometry-conv-table">
- <title>Fonctions de conversion de type géométrique</title>
+ <title>Fonctions de conversion de types géométriques</title>
<tgroup cols="4">
<thead>
<row>
@@ -7947,7 +7954,7 @@
<para>
Le type <type>macaddr</type> supporte aussi les opérateurs relationnels
- standards (<literal>></literal>, <literal><=</literal>, etc.) de tri lexicographique.
+ standard (<literal>></literal>, <literal><=</literal>, etc.) de tri lexicographique.
</para>
</sect1>
@@ -7962,21 +7969,21 @@
<indexterm zone="datatype-textsearch">
<primary>recherche de texte</primary>
- <secondary>fonctions and opérateurs</secondary>
+ <secondary>fonctions et opérateurs</secondary>
</indexterm>
<para>
<xref linkend="textsearch-operators-table"/>,
<xref linkend="textsearch-functions-table"/> et
<xref linkend="textsearch-functions-debug-table"/>
- résume les fonctions et les opérateurs fournis par la recherche plein texte.
+ résume les fonctions et les opérateurs fournis pour la recherche plein texte.
Voir <xref linkend="textsearch"/> pour une explication détaillée sur la
fonctionnalité de recherche plein texte de
<productname>PostgreSQL</productname>.
</para>
<table id="textsearch-operators-table">
- <title>Opérateurs de la recherche plein texte</title>
+ <title>Opérateurs de recherche plein texte</title>
<tgroup cols="4">
<colspec colnum="1" colwidth="0.4*"/>
<colspec colnum="2" colwidth="1*"/>
@@ -8046,17 +8053,17 @@
<note>
<para>
Les opérateurs de confinement de <type>tsquery</type> considèrent seulement
- les lexemes listés dans les deux requêtes, ignorant les opérateurs de
+ les lexèmes listés dans les deux requêtes, ignorant les opérateurs de
combinaison.
</para>
</note>
<para>
- En plus des opérateurs montrés dans la table, les opérateurs de comparaison
+ En plus des opérateurs présentés dans la table, les opérateurs de comparaison
B-tree habituels (<literal>=</literal>, <literal><</literal>, etc) sont
définis pour les types <type>tsvector</type> et <type>tsquery</type>. Ils
ne sont pas très utiles dans le cadre de la recherche plein texte mais
- permettent la construction d'index UNIQUE sur des colonnes de ce type.
+ permettent la construction d'index d'unicité sur ces types de colonne.
</para>
<table id="textsearch-functions-table">
@@ -8117,7 +8124,7 @@
<row>
<entry><literal><function>numnode</function>(<type>tsquery</type>)</literal></entry>
<entry><type>integer</type></entry>
- <entry>nombre de lexemes et d'opérateurs dans <type>tsquery</type></entry>
+ <entry>nombre de lexèmes et d'opérateurs dans <type>tsquery</type></entry>
<entry><literal> numnode('(fat & rat) | cat'::tsquery)</literal></entry>
<entry><literal>5</literal></entry>
</row>
@@ -8173,14 +8180,14 @@
<row>
<entry><literal><function>tsvector_update_trigger</function>()</literal></entry>
<entry><type>trigger</type></entry>
- <entry>fonction trigger pour la mise à jour automatique de colonne <type>tsvector</type></entry>
+ <entry>fonction déclencheur pour la mise à jour automatique de colonne <type>tsvector</type></entry>
<entry><literal>CREATE TRIGGER ... tsvector_update_trigger(tsvcol, 'pg_catalog.swedish', title, body)</literal></entry>
<entry><literal></literal></entry>
</row>
<row>
<entry><literal><function>tsvector_update_trigger_column</function>()</literal></entry>
<entry><type>trigger</type></entry>
- <entry>fonction trigger pour la mise à jour automatique de colonne <type>tsvector</type></entry>
+ <entry>fonction déclencheur pour la mise à jour automatique de colonne <type>tsvector</type></entry>
<entry><literal>CREATE TRIGGER ... tsvector_update_trigger_column(tsvcol, configcol, title, body)</literal></entry>
<entry><literal></literal></entry>
<entry><literal></literal></entry>
@@ -8192,18 +8199,18 @@
<note>
<para>
Toutes les fonctions de recherche plein texte qui acceptent un argument
- <type>regconfig</type> optionel utiliseront la configuration spécifiée par
- <xref linkend="guc-default-text-search-config"/> lorsque cet argument est
- omis.
+ <type>regconfig</type> optionel utilisent la configuration indiqée par
+ <xref linkend="guc-default-text-search-config"/> en cas d'omission de cet
+ argument.
</para>
</note>
<para>
Les fonctions de <xref linkend="textsearch-functions-debug-table"/>
- sont listées séparément car elles ne sont pas utiles habituellement dans
- les opérations quotidiennes de recherche plein texte. Elles sont utiles
- pour le développement et le débogage de nouvelles configurations de
- recherche plein texte.
+ sont listées séparément, car elles ne font pas partie des fonctions
+ utilisées dans les opérations de recherche plein texte de tous les jours.
+ Elles sont utiles pour le développement et le débogage de nouvelles
+ configurations de recherche plein texte.
</para>
<table id="textsearch-functions-debug-table">
@@ -8250,7 +8257,7 @@
<row>
<entry><literal><function>ts_token_type</function>(<replaceable class="parameter">nom_analyseur</replaceable> <type>text</type>, OUT <replaceable class="parameter">id_jeton</replaceable> <type>integer</type>, OUT <replaceable class="parameter">alias</replaceable> <type>text</type>, OUT <replaceable class="parameter">description</replaceable> <type>text</type>)</literal></entry>
<entry><type>setof record</type></entry>
- <entry>obtient des types de jeton définis par un analyseur</entry>
+ <entry>obtient les types de jeton définis par l'analyseur</entry>
<entry><literal>ts_token_type('default')</literal></entry>
<entry><literal>(1,asciiword,"Word, all ASCII") ...</literal></entry>
</row>
@@ -8293,8 +8300,8 @@
<title>Produire un contenu XML</title>
<para>
- Un ensemble de fonction et expressions sont disponibles pour produire
- du contenu XML à partir de données SQL. De là, elles conviennent
+ Un ensemble de fonctions et expressions de type fonction est disponible
+ pour produire du contenu XML à partir de données SQL. En tant que telles, elles conviennent
particulièrement bien pour formater les résultats de requêtes en XML
à traiter dans les applications clientes.
</para>
@@ -8312,10 +8319,11 @@
<para>
La fonction <function>xmlcomment</function> crée une valeur XML contenant
- un commentaire XML avec, comme contenu, le texte spécifié. Le texte ne
- peut pas contenir <literal>--</literal> ou se terminer avec un
- <literal>-</literal> pour que la construction résultante soit un
- commentaire XML valide. Si l'argument vaut NULL, le résultat vaut NULL.
+ un commentaire XML avec, comme contenu, le texte indiqué. Le texte ne
+ peut pas contenir <literal>--</literal> ou se terminer par un
+ <literal>-</literal> de sorte que que la construction résultante
+ représente un commentaire XML valide. Si l'argument est NULL, le résultat
+ est NULL.
</para>
<para>
@@ -8345,7 +8353,7 @@
La fonction <function>xmlconcat</function> concatène une liste de valeurs
XML individuelles pour créer une valeur simple contenant un fragment de
contenu XML. Les valeurs NULL sont omises ; le résultat est NULL
- seulement s'il n'y a pas d'arguments différents de NULL.
+ seulement s'il n'y a pas d'arguments non NULL.
</para>
<para>
@@ -8360,17 +8368,18 @@
</para>
<para>
- Les déclarations XML, si elles sont présentes, sont combinées ainsi. Si
+ Les déclarations XML, si elles sont présentes, sont combinées come suit. Si
toutes les valeurs en argument ont la même déclaration de version XML,
cette version est utilisée dans le résultat. Sinon aucune version n'est
utilisée. Si toutes les valeurs en argument ont la valeur de déclaration
« standalone » à <quote>yes</quote>, alors cette valeur est utilisée dans
- le résultat. Si toutes les valeurs en argument ont la valeur de déclaration
- « standalone » à <quote>no</quote>, alors cette valeur est utilisée dans
- le résultat. Sinon le résultat n'aura aucune déclaration « standalone ».
- Si le résultat est déterminé pour réclamer une déclaration « standalone »
- mais aucune déclaration de version, une déclaration de version 1.0 sera
- utilisée car le standard XML réclame qu'une déclaration XML contienne
+ le résultat. Si toutes les valeurs en argument ont une valeur de déclaration
+ « standalone » et qu'au moins l'une d'entre elles est <quote>no</quote>, alors
+ cette valeur est utilisée dans
+ le résultat. Sinon le résultat n'a aucune déclaration « standalone ».
+ Si le résultat nécessite une déclaration « standalone »
+ sans déclaration de version, une déclaration de version 1.0 est
+ utilisée car le standard XML impose qu'une déclaration XML contienne
une déclaration de version. Les déclarations d'encodage sont ignorées et
supprimées dans tous les cas.
</para>
@@ -8427,8 +8436,8 @@
</para>
<para>
- Les noms de l'élément et de l'attribut qui ne sont pas des noms XML valides
- sont échappés pour remplacer les caractères indésirables par une
+ Les noms d'élément et d'attribut qui ne sont pas des noms XML valides
+ sont modifiés en remplaçant les caractères indésirables par une
séquence <literal>_x<replaceable>HHHH</replaceable>_</literal>, où
<replaceable>HHHH</replaceable> est le codage Unicode du caractère en
notation hexadécimal. Par exemple :
@@ -8442,10 +8451,10 @@
</para>
<para>
- Un nom explicit d'attribut n'a pas besoin d'être spécifié si la valeur
+ Un nom explicit d'attribut n'a pas besoin d'être indiqué si la valeur
de l'attribut est la référence d'une colonne, auquel cas le nom de la
- colonne sera utilisé comme nom de l'attribut par défaut. Dans tous les
- autres cas, l'attribut doit se voir donner un nom explicite. Donc, cet
+ colonne est utilisé comme nom de l'attribut par défaut. Dans tous les
+ autres cas, l'attribut doit avoir un nom explicite. Donc, cet
exemple est valide :
<screen>
CREATE TABLE test (a xml, b xml);
@@ -8459,7 +8468,7 @@
</para>
<para>
- Si le contenu de l'élément n'est pas précisé, il est formaté suivant le
+ Si le contenu de l'élément est précisé, il est formaté en fonction du
type de données. Si le contenu est lui-même de type <type>xml</type>, des
documents XML complexes peuvent être construits. Par exemple :
<screen><![CDATA[
@@ -8533,8 +8542,8 @@
</para>
<para>
- Notez que les arbres XML ne sont pas des documents XML valides s'ils sont
- constitués de plus d'un élément. Donc, il pourrait être utile d'emballer
+ Les arbres XML ne sont pas des documents XML valides s'ils sont
+ constitués de plus d'un élément. Il peut donc s'avérer utile d'emballer
les expressions <function>xmlforest</function> dans
<function>xmlelement</function>.
</para>
@@ -8584,7 +8593,7 @@
L'expression <function>xmlroot</function> modifie les propriétés du
n½ud racine d'une valeur XML. Si une version est indiquée, elle
remplace la valeur dans la déclaration de version. Si une valeur
- « standalone » est indiquée, elle remplace aussi la valeur dans la
+ « standalone » est indiquée, elle remplace la valeur dans la
déclaration « standalone ».
</para>
@@ -8629,7 +8638,7 @@
</indexterm>
<para>
- Pour traiter les valeurs du type <type>xml</type>, PostgreSQL propose la
+ Pour traiter les valeurs du type <type>xml</type>, PostgreSQL fournit la
fonction <function>xpath</function>, qui évalue les expressions XPath 1.0.
</para>
@@ -8646,10 +8655,11 @@
<para>
Le troisième argument de la fonction est un tableau de correspondances
- d'espace de nom. Ce tableau doit avoir deux dimensions dont la seconde
- a une longueur de 2 (en fait, c'est un tableau de tableaux à exactement
+ de <foreignphrase>namespace</foreignphrase>. Ce tableau doit avoir deux dimensions dont la seconde
+ a une longueur 2 (en fait, c'est un tableau de tableaux à exactement
deux éléments). Le premier élément de chaque entrée du tableau est le
- nom de l'espace de noms, le second étant l'URI de l'espace de noms.
+ nom du <foreignphrase>namespace</foreignphrase>, le second étant l'URI du
+ <foreignphrase>namespace</foreignphrase>.
</para>
<para>
@@ -8683,8 +8693,8 @@
</para>
<para>
- <function>table_to_xml</function> transforme le contenu de la table,
- passée en argument grâce au paramètre <parameter>tbl</parameter>.
+ <function>table_to_xml</function> transforme le contenu de la table
+ passée en argument (paramètre <parameter>tbl</parameter>).
<type>regclass</type> accepte des chaînes identifiant les tables en
utilisant la notation habituelle, incluant les qualifications possibles du
schéma et les guillemets doubles. <function>query_to_xml</function> exécute
@@ -8694,7 +8704,7 @@
partir du curseur indiqué par le paramètre
<parameter>cursor</parameter>. Cette variante est recommandée si la
transformation se fait sur de grosses tables car la valeur en résultat est
- construit en mémoire pour chaque fonction.
+ construite en mémoire pour chaque fonction.
</para>
<para>
@@ -8744,7 +8754,7 @@
rassembler plus tard dans un document. Les fonctions pour produire du
contenu XML discutées ci-dessus, en particulier
<function>xmlelement</function>, peuvent être utilisées pour modifier
- les résultats à votre convenance.
+ les résultats.
</para>
<para>
@@ -8754,20 +8764,20 @@
<para>
Le paramètre <parameter>nulls</parameter> détermine si les valeurs NULL
- doivent être inclus en sortie. À true, les valeurs NULL dans les colonnes
+ doivent être incluses en sortie. À true, les valeurs NULL dans les colonnes
sont représentées ainsi :
<screen><![CDATA[
<columnname xsi:nil="true"/>
]]></screen>
où <literal>xsi</literal> est le préfixe de l'espace de noms XML pour
l'instance XML Schema. Une déclaration appropriée d'un espace de noms
- sera ajoutée à la valeur du résultat. À false, les colonnes contenant
+ est ajoutée à la valeur du résultat. À false, les colonnes contenant
des valeurs NULL sont simplement omises de la sortie.
</para>
<para>
- Le paramètre <parameter>targetns</parameter> spécifie l'espace de noms
- désiré du résultat. Si aucun espace de nom particulier n'est demandé, une
+ Le paramètre <parameter>targetns</parameter> indique l'espace de noms
+ souhaité pour le résultat. Si aucun espace de nom particulier n'est demandé, une
chaîne vide doit être passée.
</para>
@@ -8786,7 +8796,8 @@
<para>
Les fonctions suivantes réalisent la transformation des données XML et du
XML Schema correspondant en un seul document (ou arbre), liés ensemble.
- Elles sont utiles quand les résultats sont voulus en groupe suffisant.
+ Elles sont utiles lorsque les résultats doivent être auto-contenus et
+ auto-descriptifs.
<synopsis>
table_to_xml_and_xmlschema(tbl regclass, nulls boolean, tableforest boolean, targetns text)
query_to_xml_and_xmlschema(query text, nulls boolean, tableforest boolean, targetns text)
@@ -8795,7 +8806,8 @@
<para>
De plus, les fonctions suivantes sont disponibles pour produire des
- transformations analogues de schémas entiers ou de base de données complète.
+ transformations analogues de schémas complets ou de bases de données
+ complètes.
<synopsis>
schema_to_xml(schema name, nulls boolean, tableforest boolean, targetns text)
schema_to_xmlschema(schema name, nulls boolean, tableforest boolean, targetns text)
@@ -8806,10 +8818,10 @@
database_to_xml_and_xmlschema(nulls boolean, tableforest boolean, targetns text)
</synopsis>
- Notez qu'elles peuvent potentiellement produire beaucoup de données, qui
+ Elles peuvent produire beaucoup de données, qui
sont construites en mémoire. Lors de transformations de gros schémas ou
de grosses bases, il peut être utile de considérer la transformation
- séparées de tables, parfois même via un curseur.
+ séparée des tables, parfois même via un curseur.
</para>
<para>
@@ -8915,8 +8927,9 @@
</sect1>
+<!-- SAS::ICI -->
<sect1 id="functions-sequence">
- <title>Fonctions de manipulation de séquence</title>
+ <title>Fonctions de manipulation de séquences</title>
<indexterm>
<primary>séquence</primary>
More information about the Trad
mailing list