Changeset 1116

Show
Ignore:
Timestamp:
08/07/08 14:40:34 (4 months ago)
Author:
sas
Message:

Relu !
close #180

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • traduc/trunk/postgresql/func.xml

    r1115 r1116  
    89288928 
    89298929 
    8930 <!-- SAS::ICI --> 
    89318930 <sect1 id="functions-sequence"> 
    89328931  <title>Fonctions de manipulation de séquences</title> 
    …… 
    89588957   Les fonctions de séquence, listées dans le <xref 
    89598958   linkend="functions-sequence-table"/>, fournissent des méthodes simples, et 
    8960    sûres en environnement multi-utilisateurs, d'obtention de valeurs successive de séquence 
    8961    à partir d'objets séquence. 
     8959   sûres en environnement multi-utilisateurs, d'obtention de valeurs 
     8960   successives à partir d'objets séquence. 
    89628961  </para> 
    89638962 
    …… 
    90119010 
    90129011  <para> 
    9013    La séquence à traiter lors de l'appel à une fonction de traitement de séquences est 
     9012   La séquence à traiter par l'appel d'une fonction de traitement de séquences est 
    90149013   identifiée par un argument <type>regclass</type>, qui n'est autre que l'OID de la 
    90159014   séquence dans le catalogue système <structname>pg_class</structname>. Il 
    90169015   n'est toutefois pas nécessaire de se préoccuper de la recherche de cet OID car 
    90179016   le convertisseur de saisie du type de données <type>regclass</type> s'en 
    9018    charge. Il suffit d'écrire le nom de la séquence entre guillemets simples de 
     9017   charge. Il suffit d'écrire le nom de la séquence entre guillemets simples, de 
    90199018   façon à le faire ressembler à un libellé. Pour obtenir une 
    90209019   compatibilité avec la gestion des noms <acronym>SQL</acronym> ordinaires, 
    …… 
    90369035   <para> 
    90379036    Avant la version 8.1 de <productname>PostgreSQL</productname>, les arguments des 
    9038     fonctions de triatement de séquence étaient du type <type>text</type>, et non <type>regclass</type>. 
     9037    fonctions de traitement de séquences étaient du type <type>text</type>, et non <type>regclass</type>. 
    90399038    De ce fait, les conversions précédemment décrites d'une chaîne de caractères 
    90409039    en valeur OID se produisaient à chaque appel. Pour des raisons de compatibilité,  
    9041     cette fonctionnalité existe toujours. En revanche, en interne, un transtypage implicite 
     9040    cette fonctionnalité existe toujours. Mais, en interne, un transtypage implicite 
    90429041    est effectué entre <type>text</type> et <type>regclass</type> avant l'appel de la fonction. 
    90439042   </para> 
    90449043 
    90459044   <para> 
    9046     Lorsque l'argument d'une fonction de traitement de séquence est écrit comme une simple chaîne 
     9045    Lorsque l'argument d'une fonction de traitement de séquences est écrit comme une simple chaîne 
    90479046    de caractères, il devient une constante de type <type>regclass</type>. 
    90489047    Puisqu'il ne s'agit que d'un OID, il permet de suivre  
    …… 
    90559054    que <type>regclass</type>&nbsp;: 
    90569055<programlisting>nextval('foo'::text)      <lineannotation><literal>foo</literal> est recherché à l'exécution</lineannotation></programlisting> 
    9057     Le lien faible est le seul comportement accesiible dans les versions de <productname>PostgreSQL</productname> 
     9056    Le lien faible est le seul comportement accessible dans les versions de <productname>PostgreSQL</productname> 
    90589057    antérieures à 8.1. Il peut donc être nécessaire de le conserver pour maintenir la sémantique d'anciennes 
    90599058    applications. 
    …… 
    90619060 
    90629061   <para> 
    9063     L'argument d'une fonction de traitement de séquence peut être une expression ou une constante. 
    9064     S'il s'agit d'une expression textuelle, le transtypage implicite implique 
    9065     une recherche lors à l'exécution. 
     9062    L'argument d'une fonction de traitement de séquences peut être une expression ou une constante. 
     9063    S'il s'agit d'une expression textuelle, le transtypage implicite impose 
     9064    une recherche à l'exécution. 
    90669065   <!-- run-time lookup --> 
    90679066   </para> 
    …… 
    91239122        séquence à la valeur précisée et initialise le champ 
    91249123        <literal>is_called</literal> à <literal>true</literal>, signifiant que 
    9125         le prochain <function>nextval</function> avancera la séquence avant de 
     9124        le prochain <function>nextval</function> avance la séquence avant de 
    91269125        renvoyer une valeur. La valeur renvoyée par <function>currval</function> 
    91279126        est aussi configuré à la valeur indiquée. Dans la forme à trois paramètres, 
    …… 
    91339132        et l'incrémentation de la séquence commence avec le 
    91349133        <function>nextval</function> suivant. De plus, la valeur indiquée par 
    9135         <function>currval</function> n'est pas modifiée dans ce cas (ceci est 
    9136         une modification du comportement des versions antérieures à la 8.3). 
     9134        <function>currval</function> n'est pas modifiée dans ce cas. (Il s'agit 
     9135        d'une modification du comportement des versions antérieures à la 8.3.) 
    91379136        Par exemple, 
    91389137 
    91399138<screen>SELECT setval('foo', 42);           <lineannotation>Le <function>nextval</function> suivant retourne 43</lineannotation> 
    9140 SELECT setval('foo', 42, true);     <lineannotation>Identique à ci-dessus</lineannotation> 
     9139SELECT setval('foo', 42, true);     <lineannotation>Comme ci-dessus</lineannotation> 
    91419140SELECT setval('foo', 42, false);    <lineannotation>Le <function>nextval</function> suivant retourne 42</lineannotation></screen> 
    91429141 
    …… 
    91529151   Si un objet séquence a été créé avec les paramètres par défaut, les 
    91539152   appels à <function>nextval</function> sur celui-ci renvoient des valeurs 
    9154    successives débutant à 1. D'autres comportements peuvent être obtenus en 
     9153   successives à partir de 1. D'autres comportements peuvent être obtenus en 
    91559154   utilisant des paramètres spéciaux de la commande <xref 
    91569155   linkend="sql-createsequence" endterm="sql-createsequence-title"/>&nbsp;; voir 
    …… 
    91639162    nombres de la même séquence, une opération <function>nextval</function> 
    91649163    n'est jamais annulée&nbsp;; c'est-à-dire qu'une fois la valeur 
    9165     récupérée, elle est considérée utilisée, même si la transaction qui exécuta 
    9166     le <function>nextval</function> avorte par la suite. Ceci signifie que les transactions 
    9167     annulées pourraient laisser des <quote>trous</quote> inutilisés dans la 
     9164    récupérée, elle est considérée utilisée, même si la transaction qui exécute 
     9165    <function>nextval</function> avorte par la suite. Cela signifie que les transactions 
     9166    annulées peuvent laisser des <quote>trous</quote> inutilisés dans la 
    91689167    séquence des valeurs assignées. Les opérations <function>setval</function> 
    91699168    ne sont jamais annulées non plus. 
    …… 
    92689267 
    92699268   L'<replaceable>expression</replaceable> est calculée et comparée à toutes 
    9270    les spécifications de <replaceable>valeur</replaceable> des clauses 
     9269   les indications de <replaceable>valeur</replaceable> des clauses 
    92719270   <token>WHEN</token> jusqu'à en trouver une égale. Si aucune ne correspond, le 
    92729271   <replaceable>résultat</replaceable> de la clause 
    9273    <token>ELSE</token> (ou une valeur NULL) est renvoyée. Ceci est similaire 
    9274    à l'instruction <function>switch</function> en C. 
     9272   <token>ELSE</token> (ou une valeur NULL) est renvoyé(e). C'est similaire 
     9273   à l'instruction <function>switch</function> du langage C. 
    92759274  </para> 
    92769275 
    …… 
    93189317 
    93199318  <para> 
    9320    La fonction <function>COALESCE</function> renvoie le premier de ces 
     9319   La fonction <function>COALESCE</function> renvoie le premier de ses 
    93219320   arguments qui n'est pas nul. Une valeur NULL n'est renvoyée que si tous 
    93229321   les arguments sont nuls. Cette fonction est souvent utile pour substituer une 
    …… 
    93409339 
    93419340  <indexterm> 
    9342    <primary>NULLif</primary> 
     9341   <primary>NULLIF</primary> 
    93439342  </indexterm> 
    93449343 
    …… 
    95159514    </table> 
    95169515 
    9517 <!-- row-major doit-il être conservé, sans traduction ? --> 
     9516<!-- SAS 20080806 : row-major doit-il être conservé, sans traduction ?  
     9517     Non. Traduit pas premier index, ou lignes, un tableau à deux dimensions 
     9518     est une matrice [ligne][colonne] --> 
    95189519  <para> 
    9519    Les comparaisons comparent les contenus des tableaux élément par 
     9520   Les comparaisons de tableaux comparent les contenus des tableaux élément par 
    95209521   élément, en utilisant la fonction de comparaison par défaut du B-Tree pour 
    95219522   le type de données de l'élément. Dans les tableaux multi-dimensionnels, 
    9522    les éléments sont visités dans l'ordre <quote>row-major</quote> 
    9523    (le dernier indice varie le plus rapidement). 
     9523   les éléments sont visités dans l'ordre des colonnes (<quote>row-major 
     9524   order</quote>, le dernier indice varie le plus rapidement). 
    95249525   Si le contenu de deux tableaux est identique mais que les dimensions sont 
    95259526   différentes, la première différence dans l'information de dimension 
    …… 
    96799680<!-- Fonctions d'agrégat multi-usage --> 
    96809681  <table id="functions-aggregate-table"> 
    9681    <title>Fonctions d'agrégat à but général</title> 
     9682   <title>Fonctions d'agrégat générales</title> 
    96829683 
    96839684   <tgroup cols="4"> 
    …… 
    1010410105                      sum(<replaceable class="parameter">Y</replaceable>) / 
    1010510106                      <replaceable class="parameter">N</replaceable></literal>  
    10106                       (<quote>somme des produits</quote> des indépeendantes 
     10107                      (<quote>somme des produits</quote> de la variable indépendante 
    1010710108                      multipliée par la variable dépendante)</entry> 
    1010810109     </row> 
    …… 
    1030610307  <para> 
    1030710308   La sous-requête peut faire référence à des variables de la requête 
    10308    englobante qui agiront comme des constantes à chaque évaluation de la 
     10309   englobante qui agissent comme des constantes à chaque évaluation de la 
    1030910310   sous-requête. 
    1031010311  </para> 
    …… 
    1031610317   est de ce fait fortement déconseillé d'écrire 
    1031710318   une sous-requête qui présente des effets de bord (tels que l'appel de fonctions de 
    10318    séquence)&nbsp;; il est extrèmement difficile de prédire si celui-ci va 
    10319    intervenir. 
     10319   séquence)&nbsp;; il est extrèmement difficile de prédire si ceux-ci se 
     10320   produisent. 
    1032010321  </para> 
    1032110322 
    …… 
    1040210403   Le côté droit est une sous-requête entre parenthèses, qui doit 
    1040310404   retourner exactement une colonne. L'expression de gauche est évalué et 
    10404    comparée à cauqe ligne de résultat de la sous-requête. 
     10405   comparée à chaque ligne de résultat de la sous-requête. 
    1040510406   Le résultat de <token>NOT IN</token> n'est <quote>true</quote> que si des 
    1040610407   lignes différentes de la sous-requête sont trouvées (ce qui inclut le cas 
    …… 
    1042810429   de lignes, comme décrit dans la <xref linkend="sql-syntax-row-constructors"/>. 
    1042910430   Le côté droit est une sous-requête entre parenthèses qui doit renvoyer 
    10430    exactement autant colonnes qu'il y a d'expressions dans la ligne de gauche.  
     10431   exactement autant de colonnes qu'il y a d'expressions dans la ligne de gauche.  
    1043110432   Les expressions de gauche sont évaluées et comparée ligne à ligne au 
    1043210433   résultat de la sous-requête. Le résultat de <token>NOT IN</token> 
    …… 
    1044010441   Comme d'habitude, les valeurs nulles des lignes sont combinées en accord 
    1044110442   avec les règles normales des expressions bouléennes SQL. Deux lignes sont 
    10442    considérées égales si tous leurs membres correspondant sont non-nuls et 
    10443    égaux&nbsp;; les lignes sont différentes si les membres correspondant sont 
     10443   considérées égales si tous leurs membres correspondants sont non-nuls et 
     10444   égaux&nbsp;; les lignes sont différentes si les membres correspondants sont 
    1044410445   non-nuls et différents&nbsp;; dans tous les autres cas, le résultat de cette 
    1044510446   comparaison de ligne est inconnu (nul). Si tous les résultats par ligne sont 
    …… 
    1045910460   qu'une seule colonne. L'expression du côté gauche est évaluée et comparée à 
    1046010461   chaque ligne du résultat de la sous-requête à l'aide de 
    10461    l'<replaceable>opérateur</replaceable> indiqué, ce qui doit aboutir à une 
     10462   l'<replaceable>opérateur</replaceable> indiqué, ce qui doit aboutir à un 
    1046210463   résultat booléen. Le résultat de <token>ANY</token> est vrai 
    1046310464   (<quote>true</quote>) si l'un des résultats est vrai. Le résultat est faux 
    …… 
    1050010501   chaque ligne de la sous-requête (ce qui inclut le cas spécial de la sous-requête 
    1050110502   ne retournant aucune ligne). Le résultat est NULL si la comparaison ne renvoie 
    10502    true pour aucune ligne, et renvoie NULL pour au moins une 
    10503    ligne. 
     10503   true pour aucune ligne, et renvoie NULL pour au moins une ligne. 
    1050410504  </para> 
    1050510505 
    …… 
    1052410524   lignes renvoient true (ce qui inclut le cas spécial de la sous-requête ne 
    1052510525   retournant aucune ligne). Le résultat est faux (<quote>false</quote>) si un résultat 
    10526    faux est découvert. Le résultat est NULL si la comparaison ne renvoie pas 
    10527    false pour toutes les lignes, et si elle renvoie NULL pour au moins une ligne. 
     10526   faux est découvert. Le résultat est NULL si la comparaison ne renvoie  
     10527   false pour aucune ligne, mais NULL pour au moins une ligne. 
    1052810528  </para> 
    1052910529 
    …… 
    1054410544   Le côté droit est une sous-requête entre 
    1054510545   parenthèses qui doit renvoyer exactement le même nombre de colonnes qu'il y a 
    10546    d'expressions dans la ligne de gauche. Les expressions du côté gauche sont 
     10546   d'expressions dans la colonne de gauche. Les expressions du côté gauche sont 
    1054710547   évaluées et comparées ligne à ligne au résultat de la 
    1054810548   sous-requête à l'aide de l'<replaceable>opérateur</replaceable> donné. 
    …… 
    1055310553   une ligne quelconque de la sous-requête. 
    1055410554   Le résultat est NULL si la comparaison ne renvoie false pour aucune ligne 
    10555    de la sous-requête, et si elle renvoie NULL pour au moins une ligne. 
     10555   de la sous-requête, mais NULL pour au moins une ligne. 
    1055610556  </para> 
    1055710557 
    …… 
    1066010660  <para> 
    1066110661   Si l'expression du côté gauche renvoie NULL, ou s'il n'y a pas 
    10662    de valeurs du côté droit égales et qu'au moins une expression du côté 
     10662   de valeur égale du côté droit et qu'au moins une expression du côté 
    1066310663   droit renvoie NULL, le résultat de la construction 
    1066410664   <token>IN</token> est NULL et non pas faux. Ceci est en accord avec les 
    …… 
    1076810768   <title>Comparaison de lignes entières</title> 
    1076910769 
    10770 <!-- Etrangement, à ce niveau-là, le fichier de traduction contient déjà 300 
    10771 lignes de plus que la VO... --> 
    1077210770<synopsis><replaceable>constructeur_ligne</replaceable> opérateur <replaceable>constructeur_ligne</replaceable></synopsis> 
    1077310771 
    …… 
    1086110859  </indexterm> 
    1086210860 
    10863 <!-- Joli contresens :-)  
    10864      et générer N'est PAS français --> 
    1086510861  <para> 
    1086610862    Cette section décrit des fonctions qui peuvent renvoyer plus d'une 
    1086710863    ligne. Actuellement, les seules fonctions dans cette classe sont les 
    10868     les fonctions de génération de séries, détaillées dans le <xref 
     10864    fonctions de génération de séries, détaillées dans le <xref 
    1086910865    linkend="functions-srf-series"/>. 
    1087010866  </para> 
    …… 
    1142911425       
    1143011426   <para> 
    11431    <function>has_table_privilege</function> vérifie si l'utilisateur possède 
     11427    <function>has_table_privilege</function> vérifie si l'utilisateur possède 
    1143211428    un privilège particulier d'accès à une table. L'utilisateur peut être 
    1143311429    indiqué par son nom ou son OID (<literal>pg_authid.oid</literal>). Si 
    …… 
    1143511431    peut être indiquée par son nom ou par son OID. (Il existe donc six 
    1143611432    versions de <function>has_table_privilege</function> qui se distinguent 
    11437     par le nombre et le types de leurs arguments.) Lors de l'indication par 
     11433    par le nombre et le type de leurs arguments.) Lors de l'indication par 
    1143811434    nom, il est possible de préciser le schéma. Les privilèges possibles, 
    1143911435    indiqués sous la forme d'une chaîne de caractères, sont&nbsp;: 
    …… 
    1147711473        de recherche courant. Une table est dite visible si son schéma 
    1147811474        contenant est dans le chemin de recherche et qu'aucune table de même 
    11479         nom n'apparaît avant dans le chemin de recherche. C'est équivalent 
     11475        nom ne la précède dans le chemin de recherche. C'est équivalent 
    1148011476        au fait que la table peut être référencée par son nom sans qualification 
    1148111477        explicite de schéma. Par exemple, pour lister les noms de toutes les 
    …… 
    1160711603        de données</emphasis> n'est précédemment présent dans le chemin de recherche. Pour les 
    1160811604        classes d'opérateurs, on considère à la fois le nom et la méthode 
    11609         d'accès à l'index associée. 
     11605        d'accès à l'index associé. 
    1161011606      </para> 
    1161111607 
    …… 
    1169611692       <entry><literal><function>pg_get_expr</function>(<parameter>expr_text</parameter>, <parameter>relation_oid</parameter>)</literal></entry> 
    1169711693       <entry><type>text</type></entry> 
    11698        <entry>décompile la forme interne d'une expression, en supposant que tous 
    11699         les Vars font référence à la relation indiquée par le second paramètre</entry> 
     11694       <entry>décompile la forme interne d'une expression, en supposant que 
     11695       toutes les variables qu'elle contient font référence à la relation indiquée par le second paramètre</entry> 
    1170011696      </row> 
    1170111697      <row> 
    1170211698       <entry><literal><function>pg_get_expr</function>(<parameter>expr_text</parameter>, <parameter>relation_oid</parameter>, <parameter>pretty_bool</parameter>)</literal></entry> 
    1170311699       <entry><type>text</type></entry> 
    11704        <entry>décompile la forme interne d'une expression, en supposant que tous 
    11705         les Vars font référence à la relation indiquée par le second paramètre</entry> 
     11700       <entry>décompile la forme interne d'une expression, en supposant que 
     11701       toutes les variables qu'elle contient font référence à la relation indiquée par le second paramètre</entry> 
    1170611702      </row> 
    1170711703      <row> 
    …… 
    1179811794   qui définit une vue. La plupart de ces fonctions existent en deux versions, 
    1179911795   l'une d'elles permettant, optionnellement, d'<quote>afficher joliment</quote> 
    11800    le résultat. Ce format est plus lisible, mais il est plus probable que les 
    11801    futures versions de <productname>PostgreSQL</productname> sachent toujours 
    11802    interprêter le format par défaut de la même façon&nbsp;; la version 
     11796   le résultat. Ce format est plus lisible, mais il est probable que les 
     11797   futures versions de <productname>PostgreSQL</productname> continuent 
     11798   d'interprêter le format par défaut actuel de la même façon&nbsp;; la version 
    1180311799   <quote>jolie</quote> doit être évitée dans les sauvegardes. Passer 
    1180411800   <literal>false</literal> pour le paramètre de <quote>jolie</quote> sortie 
    …… 
    1214712143      <parameter>nouvelle_valeur</parameter>.  Si  
    1214812144      <parameter>est_local</parameter> vaut <literal>true</literal>, la 
    12149       nouvelle valeur s'applique uniquement la transaction en cours. Si 
     12145      nouvelle valeur s'applique uniquement à la transaction en cours. Si 
    1215012146      la nouvelle valeur doit s'appliquer à la session en cours, 
    1215112147      on utilise <literal>false</literal>. La fonction correspond à 
    …… 
    1238312379    </para> 
    1238412380 
    12385 <!-- SAS 20071218 : Partie qui n'apparaît plus dans la doc PG83b4 
    12386     <para> 
    12387       Pour des détails sur le bon usage de ces fonctions, voir la 
    12388       <xref linkend="continuous-archiving"/>. 
    12389     </para> 
    12390 --> 
    12391  
    1239212381   <para> 
    1239312382    <function>pg_switch_xlog</function> bascule sur le prochain journal de 
    …… 
    1282612815    <function>pg_advisory_lock</function> sauf que la fonction n'attend pas 
    1282712816    la disponibilité du verrou. Si le verrou peut être obtenu immédiatement, 
    12828     et la fonction renvoie <literal>true</literal>, sinon, elle renvoie 
     12817    la fonction renvoie <literal>true</literal>, sinon, elle renvoie 
    1282912818    <literal>false</literal>. 
    1283012819   </para>