Changeset 816

Show
Ignore:
Timestamp:
11/28/07 11:31:41 (1 year ago)
Author:
sas
Message:

Merge relecture 8.2 et relecture traduction des ajouts 8.3b3

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • traduc/trunk/manuel/func.xml

    r809 r816  
    1153811538      </indexterm> 
    1153911539 
    11540 <!-- ICI --> 
    1154111540      <para> 
    11542         Toutes ces fonctions réalisent la vérification 
    11543         de la visibilité pour un type d'objet de la base de données. Notez que 
    11544         <function>pg_table_is_visible</function> peut aussi être utilisé avec 
    11545         des vues, index et séquences&nbsp;; <function>pg_type_is_visible</function> 
    11546         peut aussi être utilisé avec les domaines. Pour les fonctions et les 
     11541       Chaque fonction vérifie la visibilité d'un type d'objet de la base de  
     11542       données. <function>pg_table_is_visible</function> peut aussi être utilisée avec 
     11543        des vues, index et séquences, <function>pg_type_is_visible</function> 
     11544        avec les domaines. Pour les fonctions et les 
    1154711545        opérateurs, un objet est visible dans le chemin de recherche si aucun 
    11548         objet du même nom <emphasis>et des mêmes types de données en 
    11549         argument</emphasis> n'arrive avant dans le chemin de recherche. Pour les 
    11550         classes d'opérateurs, le nom et la méthode d'accès à l'index associée 
    11551         sont considérés. 
     11546        objet de même nom <emphasis>et prenant des arguments de mêmes types 
     11547        de données</emphasis> n'est précédemment présent dans le chemin de recherche. Pour les 
     11548        classes d'opérateurs, on considère à la fois le nom et la méthode 
     11549        d'accès à l'index associée. 
    1155211550      </para> 
    1155311551 
    1155411552      <para> 
    11555         Toutes ces fonctions nécessitent que les OID des objets identifient 
    11556         l'objet à vérifier. Si vous voulez tester un objet par son nom, il 
     11553        Toutes ces fonctions nécessitent des OID pour identifier les objets 
     11554        à vérifier. Pour tester un objet par son nom, il 
    1155711555        est préférable d'utiliser les types d'alias d'OID (<type>regclass</type>, 
    11558         <type>regtype</type>, <type>regprocedure</type>, <type>regoperator</type>, 
    11559         <type>regconfig</type> ou <type>regdictionnary</type>), par 
    11560         exemple 
    11561 <programlisting>SELECT pg_type_is_visible('mon_schema.widget'::regtype);</programlisting> 
    11562         Notez qu'il n'y aurait aucun sens à tester un nom non qualifié de cette 
    11563         façon &mdash; si le nom peut être reconnu, il doit être visible. 
     11556        <type>regtype</type>, <type>regprocedure</type> ou 
     11557        <type>regoperator</type>). Par exemple 
     11558 <programlisting>SELECT pg_type_is_visible('mon_schema.widget'::regtype);</programlisting> 
     11559        Il n'est pas très utile de tester ainsi un nom non qualifié 
     11560        &mdash; si le nom peut être reconnu, c'est qu'il est visible. 
    1156411561      </para> 
    1156511562 
    …… 
    1160611603      <para> 
    1160711604        Le <xref linkend="functions-info-catalog-table"/> liste les fonctions qui 
    11608         extraient des informations à partir des catalogues système. 
     11605        extraient des informations des catalogues système. 
    1160911606      </para> 
    1161011607 
    1161111608      <table id="functions-info-catalog-table"> 
    11612         <title>Fonctions d'information sur le catalogue système</title> 
     11609        <title>Fonctions d'information du catalogue système</title> 
    1161311610          <tgroup cols="3"> 
    1161411611          <colspec colnum="1" colwidth="1.3*"/> 
    …… 
    1162411621              (<parameter>type_oid</parameter>, <parameter>typemod</parameter>)</literal></entry> 
    1162511622              <entry><type>text</type></entry> 
    11626               <entry>obtient le nom SQL d'un type de données</entry> 
     11623              <entry>récupère le nom SQL d'un type de données</entry> 
    1162711624            </row> 
    1162811625      <row> 
    1162911626       <entry><literal><function>pg_get_constraintdef</function>(<parameter>constraint_oid</parameter>)</literal></entry> 
    1163011627       <entry><type>text</type></entry> 
    11631        <entry>obtient la définition d'une contrainte</entry> 
     11628       <entry>récupère la définition d'une contrainte</entry> 
    1163211629      </row> 
    1163311630      <row> 
    1163411631       <entry><literal><function>pg_get_constraintdef</function>(<parameter>constraint_oid</parameter>, <parameter>pretty_bool</parameter>)</literal></entry> 
    1163511632       <entry><type>text</type></entry> 
    11636        <entry>obtient la définition d'une contrainte</entry> 
     11633       <entry>récupère la définition d'une contrainte</entry> 
    1163711634      </row> 
    1163811635      <row> 
    …… 
    1165111648       <entry><literal><function>pg_get_indexdef</function>(<parameter>index_oid</parameter>)</literal></entry> 
    1165211649       <entry><type>text</type></entry> 
    11653        <entry>obtient la commande <command>CREATE INDEX</command> pour l'index</entry> 
     11650       <entry>récupère la commande <command>CREATE INDEX</command> de l'index</entry> 
    1165411651      </row> 
    1165511652      <row> 
    1165611653       <entry><literal><function>pg_get_indexdef</function>(<parameter>index_oid</parameter>, <parameter>column_no</parameter>, <parameter>pretty_bool</parameter>)</literal></entry> 
    1165711654       <entry><type>text</type></entry> 
    11658        <entry>obtient la commande <command>CREATE INDEX</command> pour l'index, 
    11659         ou la définition d'un seul index d'une seule colonne d'un index quand 
     11655       <entry>récupère la commande <command>CREATE INDEX</command> pour l'index, 
     11656        ou la définition d'une seule colonne d'index quand 
    1166011657        <parameter>column_no</parameter> ne vaut pas zéro</entry> 
    1166111658      </row> 
    …… 
    1166311660       <entry><literal><function>pg_get_ruledef</function>(<parameter>rule_oid</parameter>)</literal></entry> 
    1166411661       <entry><type>text</type></entry> 
    11665        <entry>obtient la commande <command>CREATE RULE</command> pour une règle</entry> 
     11662       <entry>récupère la commande <command>CREATE RULE</command> pour une règle</entry> 
    1166611663      </row> 
    1166711664      <row> 
    1166811665       <entry><literal><function>pg_get_ruledef</function>(<parameter>rule_oid</parameter>, <parameter>pretty_bool</parameter>)</literal></entry> 
    1166911666       <entry><type>text</type></entry> 
    11670        <entry>obtient la commande <command>CREATE RULE</command> pour une règle</entry> 
     11667       <entry>récupère la commande <command>CREATE RULE</command> de la règle</entry> 
    1167111668      </row> 
    1167211669      <row> 
    1167311670       <entry><literal><function>pg_get_serial_sequence</function>(<parameter>table_name</parameter>, <parameter>column_name</parameter>)</literal></entry> 
    1167411671       <entry><type>text</type></entry> 
    11675        <entry>obtient le nom de la séquence qu'une colonne <type>serial</type> ou 
     11672       <entry>récupère le nom de la séquence qu'une colonne <type>serial</type> ou 
    1167611673        <type>bigserial</type> utilise</entry> 
    1167711674      </row> 
    …… 
    1167911676       <entry><function>pg_get_triggerdef</function>(<parameter>trigger_oid</parameter>)</entry> 
    1168011677       <entry><type>text</type></entry> 
    11681        <entry>obtient la commande <command>CREATE [ CONSTRAINT ] TRIGGER</command> 
     11678       <entry>récupère la commande <command>CREATE [ CONSTRAINT ] TRIGGER</command> 
    1168211679        du déclencheur</entry> 
    1168311680      </row> 
    …… 
    1168511682       <entry><literal><function>pg_get_userbyid</function>(<parameter>roleid</parameter>)</literal></entry> 
    1168611683       <entry><type>name</type></entry> 
    11687        <entry>obtient le nom du rôle ayant cet ID</entry> 
     11684       <entry>récupère le nom du rôle possédant cet ID</entry> 
    1168811685      </row> 
    1168911686      <row> 
    1169011687       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_name</parameter>)</literal></entry> 
    1169111688       <entry><type>text</type></entry> 
    11692        <entry>obtient la commande <command>SELECT</command> sous-jacente pour la 
     11689       <entry>récupère la commande <command>SELECT</command> sous-jacente à la 
    1169311690        vue (<emphasis>obsolète</emphasis>)</entry> 
    1169411691      </row> 
    …… 
    1169611693       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_name</parameter>, <parameter>pretty_bool</parameter>)</literal></entry> 
    1169711694       <entry><type>text</type></entry> 
    11698        <entry>obtient la commande <command>SELECT</command> sous-jacente pour la 
     11695       <entry>récupère la commande <command>SELECT</command> sous-jacente à la 
    1169911696        vue (<emphasis>obsolète</emphasis>)</entry> 
    1170011697      </row> 
    …… 
    1170211699       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_oid</parameter>)</literal></entry> 
    1170311700       <entry><type>text</type></entry> 
    11704        <entry>get underlying <command>SELECT</command> command for view</entry> 
     11701       <entry>récupère la commande <command>SELECT</command> sous-jacente à la 
     11702        vue</entry> 
    1170511703      </row> 
    1170611704      <row> 
    1170711705       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_oid</parameter>, <parameter>pretty_bool</parameter>)</literal></entry> 
    1170811706       <entry><type>text</type></entry> 
    11709        <entry>obtient la commande <command>SELECT</command> sous-jacente pour la 
     11707       <entry>récupère la commande <command>SELECT</command> sous-jacente à la 
    1171011708        vue</entry> 
    1171111709      </row> 
    …… 
    1171311711       <entry><literal><function>pg_tablespace_databases</function>(<parameter>tablespace_oid</parameter>)</literal></entry> 
    1171411712       <entry><type>setof oid</type></entry> 
    11715        <entry>obtient l'ensemble d'OID des bases qui ont des objets dans ce 
     11713       <entry>récupère l'ensemble des OID des bases qui possèdent des objets dans ce 
    1171611714        tablespace</entry> 
    1171711715      </row> 
    …… 
    1172011718   </table> 
    1172111719 
    11722       <para> 
    11723         <function>format_type</function> renvoie le nom SQL d'un type de données 
    11724        qui est identifié par son OID de type et peut-être par un modificateur 
    11725        de type. Passez NULL au modificateur de type si aucun modificateur 
    11726        spécifique n'est connu. 
    11727       </para> 
     11720  <para> 
     11721   <function>format_type</function> renvoie le nom SQL d'un type de données 
     11722   identifié par son OID de type et éventuellement un modificateur 
     11723   de type. On passe NULL pour le modificateur de type si aucun modificateur 
     11724   spécifique n'est connu. 
     11725  </para> 
    1172811726 
    1172911727  <para> 
    …… 
    1173111729   <function>pg_get_indexdef</function>, <function>pg_get_ruledef</function> 
    1173211730   et <function>pg_get_triggerdef</function> reconstruisent respectivement 
    11733    la commande de création pour une contrainte, un index, une règle ou un 
    11734    déclencheur. (Notez qu'il s'agit d'une reconstruction décompilée, pas 
     11731   la commande de création d'une contrainte, d'un index, d'une règle ou d'un 
     11732   déclencheur. (Il s'agit d'une reconstruction décompilée, pas 
    1173511733   du texte originale de la commande.) 
    1173611734   <function>pg_get_expr</function> décompile la forme interne d'une expression 
    …… 
    1173811736   pour examiner le contenu des catalogues système. 
    1173911737   <function>pg_get_viewdef</function> reconstruit la requête <command>SELECT</command> 
    11740    qui définit une vue. La plupart de ces fonctions viennent en deux versions, dont une 
    11741    qui, en option, peut <quote>afficher joliment</quote> le résultat. Ce format 
    11742    est plus lisible mais le format par défaut est plus facilement interprétable 
    11743    de la même façon avec les versions futures de 
    11744    <productname>PostgreSQL</productname>&nbsp;; éviter d'utiliser la jolie sortie 
    11745    pour les sauvegardes. Passer <literal>false</literal> pour le paramètre de 
    11746    la jolie sortie ramène le même résultat que la variante qui n'a pas ce 
    11747    paramètre 
     11738   qui définit une vue. La plupart de ces fonctions existent en deux versions, 
     11739   l'une d'elles permettant, optionnellement, d'<quote>afficher joliment</quote> 
     11740   le résultat. Ce format est plus lisible, mais il est plus probable que les 
     11741   futures versions de <productname>PostgreSQL</productname> sachent toujours 
     11742   interprêter le format par défaut de la même façon&nbsp;; la version 
     11743   <quote>jolie</quote> doit être évitée dans les sauvegardes. Passer 
     11744   <literal>false</literal> pour le paramètre de <quote>jolie</quote> sortie 
     11745   conduit au même résultat que la variante sans ce paramètre. 
    1174811746  </para> 
    1174911747 
    1175011748  <para> 
    1175111749   <function>pg_get_serial_sequence</function> renvoie le nom de la séquence 
    11752    associée avec une colonne ou NULL s'il n'existe aucune séquence associée 
    11753    à la colonne. Le premier argument en entrée est un nom de table avec le 
    11754    nom du schéma en option. Le second paramètre est un nom de colonne. Comme 
    11755    le premier paramètre peut potentiellement contenir le nom du schéma et de 
     11750   associée à une colonne ou NULL si aucune séquence n'est associée 
     11751   à la colonne. Le premier argument en entrée est un nom de table, 
     11752   éventuellement qualifié du schéma. Le second paramètre est un nom de colonne. Comme 
     11753   le premier paramètre peut contenir le nom du schéma et de 
    1175611754   la table, il n'est pas traité comme un identifiant entre guillemets 
    11757    doubles, signifiant qu'il est en minuscule par défaut alors que le second 
    11758    paramètre, étant un simple nom de colonne, est présenté avec des 
    11759    guillemets doubles et a sa casse préservé. La fonction renvoie une valeur 
    11760    formatée convenablement pour qu'elle soit fournie aux fonctions sur les 
     11755   doubles, ce qui signifie qu'il est converti en minuscules par défaut, alors que le second 
     11756   paramètre, étant un simple nom de colonne, est traité comme s'il était entre 
     11757   guillemets doubles et sa casse est préservée. La fonction renvoie une valeur 
     11758   convenablement formatée pour être traitée par fonctions de traitement des 
    1176111759   séquences (voir <xref linkend="functions-sequence"/>). Cette association 
    1176211760   peut être modifiée ou supprimée avec <command>ALTER SEQUENCE OWNED 
    11763    BY</command>. (La fonction devrait probablement avoir été appelée 
     11761   BY</command>. (La fonction aurait probablement dû s'appeler 
    1176411762   <function>pg_get_owned_sequence</function>&nbsp;; son nom reflète le fait 
    11765    qu'il est typiquement utilisé avec les colonnes <type>serial</type> et 
     11763   qu'elle est typiquement utilisée avec les colonnes <type>serial</type> et 
    1176611764   <type>bigserial</type>.) 
    1176711765  </para> 
    1176811766 
    1176911767  <para> 
    11770    <function>pg_get_userbyid</function> extrait un nom de rôle d'après son OID. 
     11768   <function>pg_get_userbyid</function> récupère le nom d'un rôle d'après son OID. 
    1177111769  </para> 
    1177211770 
    1177311771  <para> 
    11774    <function>pg_tablespace_databases</function> autorise l'examen d'un espace 
    11775    logique. Il renvoie l'ensemble des OID des bases qui ont des objets stockés 
    11776    dans le tablespace. Si la fonction renvoie une ligne, le tablespace 
     11772   <function>pg_tablespace_databases</function> autorise l'examen d'un 
     11773   <foreignphrase>tablespace</foreignphrase>. Il renvoie l'ensemble des OID 
     11774   des bases qui possèdent des objets stockés 
     11775   dans le <foreignphrase>tablespace</foreignphrase>. Si la fonction renvoie 
     11776   une ligne, le <foreignphrase>tablespace</foreignphrase> 
    1177711777   n'est pas vide et ne peut pas être supprimée. Pour afficher les objets 
    11778    spécifiques peuplant le tablespace, vous aurez besoin de connecter les 
    11779    bases identifiées par <function>pg_tablespace_databases</function> et 
    11780    d'exécuter des requêtes sur le catalogue <structname>pg_class</structname>. 
     11778   spécifiques peuplant le <foreignphrase>tablespace</foreignphrase>, il est 
     11779   nécessaire de se connecter aux bases identifiées par 
     11780   <function>pg_tablespace_databases</function> et de requêter le catalogue 
     11781   <structname>pg_class</structname>. 
    1178111782  </para> 
    1178211783 
    …… 
    1179911800 
    1180011801   <para> 
    11801     les fonctions affichées dans <xref linkend="functions-info-comment-table"/> 
     11802    Les fonctions affichées dans <xref linkend="functions-info-comment-table"/> 
    1180211803    extraient les commentaires stockées précédemment avec la commande <xref 
    1180311804    linkend="sql-comment" endterm="sql-comment-title"/>. Une valeur NULL est 
    11804     renvoyée si aucun commentaire ne se trouve correspondre aux paramètres 
     11805    renvoyée si aucun commentaire ne correspond aux paramètres 
    1180511806    donnés. 
    1180611807   </para> 
    …… 
    1182011821         <entry><literal><function>col_description</function>(<parameter>table_oid</parameter>,  <parameter>column_number</parameter>)</literal></entry> 
    1182111822         <entry><type>text</type></entry> 
    11822          <entry>obtient un commentaire pour la colonne d'une table</entry> 
     11823         <entry>récupère le commentaire d'une colonne de la table</entry> 
    1182311824        </row> 
    1182411825        <row> 
    …… 
    1182611827          (<parameter>object_oid</parameter>, <parameter>catalog_name</parameter>)</literal></entry> 
    1182711828          <entry><type>text</type></entry> 
    11828           <entry>récupère un commentaire à partir d'un objet de la base de données</entry> 
     11829          <entry>récupère le commentaire d'un objet de la base de données</entry> 
    1182911830        </row> 
    1183011831        <row> 
    1183111832          <entry><literal><function>obj_description</function>(<parameter>object_oid</parameter>)</literal></entry> 
    1183211833          <entry><type>text</type></entry> 
    11833           <entry>récupère un commentaire à partir d'un objet de la base de données 
    11834         (<emphasis>obsolète</emphasis>)</entry> 
     11834          <entry>récupère le commentaire d'un objet de la base de données 
     11835        (<emphasis>obsolète</emphasis>)</entry> 
    1183511836        </row> 
    1183611837        <row> 
    1183711838         <entry><literal><function>shobj_description</function>(<parameter>object_oid</parameter>, <parameter>catalog_name</parameter>)</literal></entry> 
    1183811839         <entry><type>text</type></entry> 
    11839          <entry>obtient un commentaire pour un objet partagé de la base</entry> 
     11840         <entry>récupère le commentaire d'un objet partagé de la base de 
     11841         données</entry> 
    1184011842        </row> 
    1184111843      </tbody> 
    …… 
    1184411846 
    1184511847   <para> 
    11846     <function>col_description</function> renvoie le commentaire de la colonne 
    11847     d'une table, la colonne étant précisée par l'OID de la table et son 
    11848     numéro de colonne. 
    11849     <function>obj_description</function> ne peut pas être utilisé pour les 
    11850     colonnes de table car les colonnes n'ont pas d'OID elles-mêmes. 
    11851    </para> 
    11852  
    11853       <para> 
    11854         La forme à deux paramètres de <function>obj_description</function> 
    11855        renvoie le commentaire d'un objet de la base de données, spécifié 
    11856        par son OID et le nom du catalogue système le contenant. Par exemple, 
    11857        <literal>obj_description(123456,'pg_class')</literal> récupérerait le 
    11858        commentaire pour une table d'OID 123456. La forme à un paramètre de 
    11859        <function>obj_description</function> requiert seulement l'OID de l'objet. 
    11860        Elle est maintenant obsolète car il n'existe aucune garantie que les 
    11861        OID soient uniques au travers des différents catalogues système&nbsp;; 
    11862        du coup, un mauvais commentaire pourrait être renvoyé. 
    11863       </para> 
    11864  
    11865       <para> 
    11866         <function>shobj_description</function> est utilisé comme 
    11867         <function>obj_description</function>, seulement il est utilisé pour 
    11868        récupérer les commentaires sur les objets partagés. Certains catalogues 
    11869        systèmes sont globaux à toutes les bases de données à l'intérieur de 
    11870        chaque cluster et leurs descriptions sont stockées globalement. 
    11871       </para> 
     11848    <function>col_description</function> renvoie le commentaire d'une colonne 
     11849    de table, la colonne étant précisée par l'OID de la table et son 
     11850    numéro de colonne. 
     11851    <function>obj_description</function> ne peut pas être utilisée pour les 
     11852    colonnes de table car les colonnes n'ont pas d'OID propres. 
     11853   </para> 
     11854 
     11855   <para> 
     11856     La forme à deux paramètres de <function>obj_description</function> 
     11857     renvoie le commentaire d'un objet de la base de données, précisé 
     11858     par son OID et le nom du catalogue système le contenant. Par exemple, 
     11859     <literal>obj_description(123456,'pg_class')</literal> récupère le 
     11860     commentaire pour la table d'OID 123456. La forme à un paramètre de 
     11861     <function>obj_description</function> ne requiert que l'OID de l'objet. 
     11862     Elle est maintenant obsolète car il n'existe aucune garantie que les 
     11863     OID soient uniques au travers des différents catalogues système&nbsp;; 
     11864     un mauvais commentaire peut alors être renvoyé. 
     11865   </para> 
     11866    
     11867   <para> 
     11868     <function>shobj_description</function> est utilisé comme 
     11869     <function>obj_description</function>, mais pour 
     11870     récupérer les commentaires des objets partagés. Certains catalogues 
     11871     systèmes sont globaux à toutes les bases de données à l'intérieur de 
     11872     chaque cluster et leurs descriptions sont stockées globalement. 
     11873   </para> 
    1187211874 
    1187311875   <indexterm> 
    …… 
    1189911901    exportent les informations de transaction du niveau interne au serveur au 
    1190011902    niveau utilisateur. L'usage principal de ces fonctions est de déterminer les 
    11901     transactions à commiter entre deux instantanés («&nbsp;snapshots&nbsp;»). 
     11903    transactions commitées entre deux instantanés («&nbsp;snapshots&nbsp;»). 
    1190211904   </para> 
    1190311905 
    …… 
    1194811950    donc tous les 4 milliards de transactions. Cependant, ces fonctions exportent  
    1194911951    au format 64 bits, étendu par un compteur <quote>epoch</quote>, de façon à éviter  
    11950     tout cycle sur la dutrée de vie de l'installation. Le type de données 
     11952    tout cycle sur la durée de vie de l'installation. Le type de données 
    1195111953    utilisé par ces fonctions, <type>txid_snapshot</type>, stocke l'information 
    1195211954    de visibilité des ID de transaction à un instant particulier. Ces composants sont décrits 
    …… 
    1197911981       <entry> 
    1198011982        Premier txid non encore assigné. Tous les txids qui suivent celui-ci ne sont 
    11981         pas encore démarré à ce moment de l'instantané, et donc invisibles. 
     11983        pas encore démarrés à ce moment de l'instantané, et donc invisibles. 
    1198211984       </entry> 
    1198311985      </row> 
    …… 
    1199011992        <literal>xmin &lt;= txid &lt; xmax</literal> et n'est pas dans la cette liste  
    1199111993        est déjà terminé à ce moment de l'instantané, et donc soit visible, soit mort,  
    11992         selon sont statut de validation. 
     11994        selon son statut de validation. 
    1199311995       </entry> 
    1199411996      </row> 
    …… 
    1200612008  </sect1> 
    1200712009 
     12010<!-- ICI --> 
    1200812011<sect1 id="functions-admin"> 
    1200912012  <title>Fonctions d'administration système</title>