Changeset 814

Show
Ignore:
Timestamp:
11/28/07 09:24:33 (1 year ago)
Author:
sas
Message:

Relecture "Fonction d'information système"

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • traduc/branches/bv82x/manuel/func.xml

    r801 r814  
    1001910019      </indexterm> 
    1002010020 
    10021 <!-- ICI --> 
    1002210021      <para> 
    1002310022        <function>pg_conversion_is_visible</function>, 
    …… 
    1002610025        <function>pg_opclass_is_visible</function>, 
    1002710026        <function>pg_table_is_visible</function> et 
    10028         <function>pg_type_is_visible</function> réalisent la vérification 
    10029         de la visibilité pour les conversions, fonctions, opérateurs, classes 
    10030         d'opérateur, tables et types. Notez que 
     10027        <function>pg_type_is_visible</function> permettent de vérifier  
     10028        la visibilité des conversions, fonctions, opérateurs, classes 
     10029        d'opérateur, tables et types.  
    1003110030        <function>pg_table_is_visible</function> peut aussi être utilisé avec 
    10032         des vues, index et séquences&nbsp;; <function>pg_type_is_visible</function> 
    10033         peut aussi être utilisé avec les domaines. Pour les fonctions et les 
     10031        les vues, index et séquences, <function>pg_type_is_visible</function> 
     10032        avec les domaines. Pour les fonctions et les 
    1003410033        opérateurs, un objet est visible dans le chemin de recherche si aucun 
    10035         objet du même nom <emphasis>et des mêmes types de données en 
    10036         argument</emphasis> n'arrive avant dans le chemin de recherche. Pour les 
    10037         classes d'opérateurs, le nom et la méthode d'accès à l'index associée 
    10038         sont considérés. 
     10034        objet de même nom <emphasis>et prenant des arguments de mêmes types 
     10035        de données</emphasis> n'est précédemment présent dans le chemin de recherche. Pour les 
     10036        classes d'opérateurs, on considère à la fois le nom et la méthode 
     10037        d'accès à l'index associée. 
    1003910038      </para> 
    1004010039 
    1004110040      <para> 
    10042         Toutes ces fonctions nécessitent que les OID des objets identifient 
    10043         l'objet à vérifier. Si vous voulez tester un objet par son nom, il 
     10041        Toutes ces fonctions nécessitent des OID pour identifier les objets 
     10042        à vérifier. Pour tester un objet par son nom, il 
    1004410043        est préférable d'utiliser les types d'alias d'OID (<type>regclass</type>, 
    10045         <type>regtype</type>, <type>regprocedure</type> ou <type>regoperator</type>), par 
    10046         exemple 
     10044        <type>regtype</type>, <type>regprocedure</type> ou 
     10045        <type>regoperator</type>). Par exemple 
    1004710046<programlisting>SELECT pg_type_is_visible('mon_schema.widget'::regtype);</programlisting> 
    10048         Notez qu'il n'y aurait aucun sens à tester un nom non qualifié de cette 
    10049         façon &mdash; si le nom peut être reconnu, il doit être visible. 
     10047        Il n'est pas très utile de tester ainsi un nom non qualifié 
     10048        &mdash; si le nom peut être reconnu, c'est qu'il est visible. 
    1005010049      </para> 
    1005110050 
    …… 
    1009210091      <para> 
    1009310092        Le <xref linkend="functions-info-catalog-table"/> liste les fonctions qui 
    10094         extraient des informations à partir des catalogues système. 
     10093        extraient des informations des catalogues système. 
    1009510094      </para> 
    1009610095 
    1009710096      <table id="functions-info-catalog-table"> 
    10098         <title>Fonctions d'information sur le catalogue système</title> 
     10097        <title>Fonctions d'information du catalogue système</title> 
    1009910098          <tgroup cols="3"> 
    1010010099          <colspec colnum="1" colwidth="1.3*"/> 
    …… 
    1011010109              (<parameter>type_oid</parameter>, <parameter>typemod</parameter>)</literal></entry> 
    1011110110              <entry><type>text</type></entry> 
    10112               <entry>obtient le nom SQL d'un type de données</entry> 
     10111              <entry>récupère le nom SQL d'un type de données</entry> 
    1011310112            </row> 
    1011410113      <row> 
    1011510114       <entry><literal><function>pg_get_constraintdef</function>(<parameter>constraint_oid</parameter>)</literal></entry> 
    1011610115       <entry><type>text</type></entry> 
    10117        <entry>obtient la définition d'une contrainte</entry> 
     10116       <entry>récupère la définition d'une contrainte</entry> 
    1011810117      </row> 
    1011910118      <row> 
    1012010119       <entry><literal><function>pg_get_constraintdef</function>(<parameter>constraint_oid</parameter>, <parameter>pretty_bool</parameter>)</literal></entry> 
    1012110120       <entry><type>text</type></entry> 
    10122        <entry>obtient la définition d'une contrainte</entry> 
     10121       <entry>récupère la définition d'une contrainte</entry> 
    1012310122      </row> 
    1012410123      <row> 
    …… 
    1013710136       <entry><literal><function>pg_get_indexdef</function>(<parameter>index_oid</parameter>)</literal></entry> 
    1013810137       <entry><type>text</type></entry> 
    10139        <entry>obtient la commande <command>CREATE INDEX</command> pour l'index</entry> 
     10138       <entry>récupère la commande <command>CREATE INDEX</command> de l'index</entry> 
    1014010139      </row> 
    1014110140      <row> 
    1014210141       <entry><literal><function>pg_get_indexdef</function>(<parameter>index_oid</parameter>, <parameter>column_no</parameter>, <parameter>pretty_bool</parameter>)</literal></entry> 
    1014310142       <entry><type>text</type></entry> 
    10144        <entry>obtient la commande <command>CREATE INDEX</command> pour l'index, 
    10145         ou la définition d'un seul index d'une seule colonne d'un index quand 
     10143       <entry>récupère la commande <command>CREATE INDEX</command> pour l'index, 
     10144        ou la définition d'une seule colonne d'index quand 
    1014610145        <parameter>column_no</parameter> ne vaut pas zéro</entry> 
    1014710146      </row> 
    …… 
    1014910148       <entry><literal><function>pg_get_ruledef</function>(<parameter>rule_oid</parameter>)</literal></entry> 
    1015010149       <entry><type>text</type></entry> 
    10151        <entry>obtient la commande <command>CREATE RULE</command> pour une règle</entry> 
     10150       <entry>récupère la commande <command>CREATE RULE</command> pour une règle</entry> 
    1015210151      </row> 
    1015310152      <row> 
    1015410153       <entry><literal><function>pg_get_ruledef</function>(<parameter>rule_oid</parameter>, <parameter>pretty_bool</parameter>)</literal></entry> 
    1015510154       <entry><type>text</type></entry> 
    10156        <entry>obtient la commande <command>CREATE RULE</command> pour une règle</entry> 
     10155       <entry>récupère la commande <command>CREATE RULE</command> de la règle</entry> 
    1015710156      </row> 
    1015810157      <row> 
    1015910158       <entry><literal><function>pg_get_serial_sequence</function>(<parameter>table_name</parameter>, <parameter>column_name</parameter>)</literal></entry> 
    1016010159       <entry><type>text</type></entry> 
    10161        <entry>obtient le nom de la séquence qu'une colonne <type>serial</type> ou 
     10160       <entry>récupère le nom de la séquence qu'une colonne <type>serial</type> ou 
    1016210161        <type>bigserial</type> utilise</entry> 
    1016310162      </row> 
    …… 
    1016510164       <entry><function>pg_get_triggerdef</function>(<parameter>trigger_oid</parameter>)</entry> 
    1016610165       <entry><type>text</type></entry> 
    10167        <entry>obtient la commande <command>CREATE [ CONSTRAINT ] TRIGGER</command> 
     10166       <entry>récupère la commande <command>CREATE [ CONSTRAINT ] TRIGGER</command> 
    1016810167        du déclencheur</entry> 
    1016910168      </row> 
    …… 
    1017110170       <entry><literal><function>pg_get_userbyid</function>(<parameter>roleid</parameter>)</literal></entry> 
    1017210171       <entry><type>name</type></entry> 
    10173        <entry>obtient le nom du rôle ayant cet ID</entry> 
     10172       <entry>récupère le nom du rôle possédant cet ID</entry> 
    1017410173      </row> 
    1017510174      <row> 
    1017610175       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_name</parameter>)</literal></entry> 
    1017710176       <entry><type>text</type></entry> 
    10178        <entry>obtient la commande <command>SELECT</command> sous-jacente pour la 
     10177       <entry>récupère la commande <command>SELECT</command> sous-jacente à la 
    1017910178        vue (<emphasis>obsolète</emphasis>)</entry> 
    1018010179      </row> 
    …… 
    1018210181       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_name</parameter>, <parameter>pretty_bool</parameter>)</literal></entry> 
    1018310182       <entry><type>text</type></entry> 
    10184        <entry>obtient la commande <command>SELECT</command> sous-jacente pour la 
     10183       <entry>récupère la commande <command>SELECT</command> sous-jacente à la 
    1018510184        vue (<emphasis>obsolète</emphasis>)</entry> 
    1018610185      </row> 
    …… 
    1018810187       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_oid</parameter>)</literal></entry> 
    1018910188       <entry><type>text</type></entry> 
    10190        <entry>get underlying <command>SELECT</command> command for view</entry> 
     10189       <entry>récupère la commande <command>SELECT</command> sous-jacente à la 
     10190        vue</entry> 
    1019110191      </row> 
    1019210192      <row> 
    1019310193       <entry><literal><function>pg_get_viewdef</function>(<parameter>view_oid</parameter>, <parameter>pretty_bool</parameter>)</literal></entry> 
    1019410194       <entry><type>text</type></entry> 
    10195        <entry>obtient la commande <command>SELECT</command> sous-jacente pour la 
     10195       <entry>récupère la commande <command>SELECT</command> sous-jacente à la 
    1019610196        vue</entry> 
    1019710197      </row> 
    …… 
    1019910199       <entry><literal><function>pg_tablespace_databases</function>(<parameter>tablespace_oid</parameter>)</literal></entry> 
    1020010200       <entry><type>setof oid</type></entry> 
    10201        <entry>obtient l'ensemble d'OID des bases qui ont des objets dans ce 
     10201       <entry>récupère l'ensemble des OID des bases qui possèdent des objets dans ce 
    1020210202        tablespace</entry> 
    1020310203      </row> 
    …… 
    1020610206   </table> 
    1020710207 
    10208       <para> 
    10209         <function>format_type</function> renvoie le nom SQL d'un type de données 
    10210        qui est identifié par son OID de type et peut-être par un modificateur 
    10211        de type. Passez NULL au modificateur de type si aucun modificateur 
    10212        spécifique n'est connu. 
    10213       </para> 
     10208  <para> 
     10209   <function>format_type</function> renvoie le nom SQL d'un type de données 
     10210   identifié par son OID de type et éventuellement un modificateur 
     10211   de type. On passe NULL pour le modificateur de type si aucun modificateur 
     10212   spécifique n'est connu. 
     10213  </para> 
    1021410214 
    1021510215  <para> 
    …… 
    1021710217   <function>pg_get_indexdef</function>, <function>pg_get_ruledef</function> 
    1021810218   et <function>pg_get_triggerdef</function> reconstruisent respectivement 
    10219    la commande de création pour une contrainte, un index, une règle ou un 
    10220    déclencheur. (Notez qu'il s'agit d'une reconstruction décompilée, pas 
     10219   la commande de création d'une contrainte, d'un index, d'une règle ou d'un 
     10220   déclencheur. (Il s'agit d'une reconstruction décompilée, pas 
    1022110221   du texte originale de la commande.) 
    1022210222   <function>pg_get_expr</function> décompile la forme interne d'une expression 
    …… 
    1022410224   pour examiner le contenu des catalogues système. 
    1022510225   <function>pg_get_viewdef</function> reconstruit la requête <command>SELECT</command> 
    10226    qui définit une vue. La plupart de ces fonctions viennent en deux versions, dont une 
    10227    qui, en option, peut <quote>afficher joliment</quote> le résultat. Ce format 
    10228    est plus lisible mais le format par défaut est plus facilement interprétable 
    10229    de la même façon avec les versions futures de 
    10230    <productname>PostgreSQL</productname>&nbsp;; éviter d'utiliser la jolie sortie 
    10231    pour les sauvegardes. Passer <literal>false</literal> pour le paramètre de 
    10232    la jolie sortie ramène le même résultat que la variante qui n'a pas ce 
    10233    paramètre 
     10226   qui définit une vue. La plupart de ces fonctions existent en deux versions, 
     10227   l'une d'elles permettant, optionnellement, d'<quote>afficher joliment</quote> 
     10228   le résultat. Ce format est plus lisible, mais il est plus probable que les 
     10229   futures versions de <productname>PostgreSQL</productname> sachent toujours 
     10230   interprêter le format par défaut de la même façon&nbsp;; la version 
     10231   <quote>jolie</quote> doit être évitée dans les sauvegardes. Passer 
     10232   <literal>false</literal> pour le paramètre de <quote>jolie</quote> sortie 
     10233   conduit au même résultat que la variante sans ce paramètre. 
    1023410234  </para> 
    1023510235 
    1023610236  <para> 
    1023710237   <function>pg_get_serial_sequence</function> renvoie le nom de la séquence 
    10238    associée avec une colonne ou NULL s'il n'existe aucune séquence associée 
    10239    à la colonne. Le premier argument en entrée est un nom de table avec le 
    10240    nom du schéma en option. Le second paramètre est un nom de colonne. Comme 
    10241    le premier paramètre peut potentiellement contenir le nom du schéma et de 
     10238   associée à une colonne ou NULL si aucune séquence n'est associée 
     10239   à la colonne. Le premier argument en entrée est un nom de table, 
     10240   éventuellement qualifié du schéma. Le second paramètre est un nom de colonne. Comme 
     10241   le premier paramètre peut contenir le nom du schéma et de 
    1024210242   la table, il n'est pas traité comme un identifiant entre guillemets 
    10243    doubles, signifiant qu'il est en minuscule par défaut alors que le second 
    10244    paramètre, étant un simple nom de colonne, est présenté avec des 
    10245    guillemets doubles et a sa casse préservé. La fonction renvoie une valeur 
    10246    formatée convenablement pour qu'elle soit fournie aux fonctions sur les 
     10243   doubles, ce qui signifie qu'il est converti en minuscules par défaut, alors que le second 
     10244   paramètre, étant un simple nom de colonne, est traité comme s'il était entre 
     10245   guillemets doubles et sa casse est préservée. La fonction renvoie une valeur 
     10246   convenablement formatée pour être traitée par fonctions de traitement des 
    1024710247   séquences (voir <xref linkend="functions-sequence"/>). Cette association 
    1024810248   peut être modifiée ou supprimée avec <command>ALTER SEQUENCE OWNED 
    10249    BY</command>. (La fonction devrait probablement avoir été appelée 
     10249   BY</command>. (La fonction aurait probablement dû s'appeler 
    1025010250   <function>pg_get_owned_sequence</function>&nbsp;; son nom reflète le fait 
    10251    qu'il est typiquement utilisé avec les colonnes <type>serial</type> et 
     10251   qu'elle est typiquement utilisée avec les colonnes <type>serial</type> et 
    1025210252   <type>bigserial</type>.) 
    1025310253  </para> 
    1025410254 
    1025510255  <para> 
    10256    <function>pg_get_userbyid</function> extrait un nom de rôle d'après son OID. 
     10256   <function>pg_get_userbyid</function> récupère le nom d'un rôle d'après son OID. 
    1025710257  </para> 
    1025810258 
    1025910259  <para> 
    10260    <function>pg_tablespace_databases</function> autorise l'examen d'un espace 
    10261    logique. Il renvoie l'ensemble des OID des bases qui ont des objets stockés 
    10262    dans le tablespace. Si la fonction renvoie une ligne, le tablespace 
     10260   <function>pg_tablespace_databases</function> autorise l'examen d'un 
     10261   <foreignphrase>tablespace</foreignphrase>. Il renvoie l'ensemble des OID 
     10262   des bases qui possèdent des objets stockés 
     10263   dans le <foreignphrase>tablespace</foreignphrase>. Si la fonction renvoie 
     10264   une ligne, le <foreignphrase>tablespace</foreignphrase> 
    1026310265   n'est pas vide et ne peut pas être supprimée. Pour afficher les objets 
    10264    spécifiques peuplant le tablespace, vous aurez besoin de connecter les 
    10265    bases identifiées par <function>pg_tablespace_databases</function> et 
    10266    d'exécuter des requêtes sur le catalogue <structname>pg_class</structname>. 
     10266   spécifiques peuplant le <foreignphrase>tablespace</foreignphrase>, il est 
     10267   nécessaire de se connecter aux bases identifiées par 
     10268   <function>pg_tablespace_databases</function> et de requêter le catalogue 
     10269   <structname>pg_class</structname>. 
    1026710270  </para> 
    1026810271 
    …… 
    1028510288 
    1028610289   <para> 
    10287     les fonctions affichées dans <xref linkend="functions-info-comment-table"/> 
     10290    Les fonctions affichées dans <xref linkend="functions-info-comment-table"/> 
    1028810291    extraient les commentaires stockées précédemment avec la commande <xref 
    1028910292    linkend="sql-comment" endterm="sql-comment-title"/>. Une valeur NULL est 
    10290     renvoyée si aucun commentaire ne se trouve correspondre aux paramètres 
     10293    renvoyée si aucun commentaire ne correspond aux paramètres 
    1029110294    donnés. 
    1029210295   </para> 
    …… 
    1030610309         <entry><literal><function>col_description</function>(<parameter>table_oid</parameter>,  <parameter>column_number</parameter>)</literal></entry> 
    1030710310         <entry><type>text</type></entry> 
    10308          <entry>obtient un commentaire pour la colonne d'une table</entry> 
     10311         <entry>récupère le commentaire d'une colonne de la table</entry> 
    1030910312        </row> 
    1031010313        <row> 
    …… 
    1031210315          (<parameter>object_oid</parameter>, <parameter>catalog_name</parameter>)</literal></entry> 
    1031310316          <entry><type>text</type></entry> 
    10314           <entry>récupère un commentaire à partir d'un objet de la base de données</entry> 
     10317          <entry>récupère le commentaire d'un objet de la base de données</entry> 
    1031510318        </row> 
    1031610319        <row> 
    1031710320          <entry><literal><function>obj_description</function>(<parameter>object_oid</parameter>)</literal></entry> 
    1031810321          <entry><type>text</type></entry> 
    10319           <entry>récupère un commentaire à partir d'un objet de la base de données 
     10322          <entry>récupère le commentaire d'un objet de la base de données 
    1032010323          (<emphasis>obsolète</emphasis>)</entry> 
    1032110324        </row> 
    …… 
    1032310326         <entry><literal><function>shobj_description</function>(<parameter>object_oid</parameter>, <parameter>catalog_name</parameter>)</literal></entry> 
    1032410327         <entry><type>text</type></entry> 
    10325          <entry>obtient un commentaire pour un objet partagé de la base</entry> 
     10328         <entry>récupère le commentaire d'un objet partagé de la base de 
     10329         données</entry> 
    1032610330        </row> 
    1032710331      </tbody> 
    …… 
    1033010334 
    1033110335   <para> 
    10332     <function>col_description</function> renvoie le commentaire de la colonne 
    10333     d'une table, la colonne étant précisée par l'OID de la table et son 
     10336    <function>col_description</function> renvoie le commentaire d'une colonne 
     10337    de table, la colonne étant précisée par l'OID de la table et son 
    1033410338    numéro de colonne. 
    1033510339    <function>obj_description</function> ne peut pas être utilisé pour les 
    10336     colonnes de table car les colonnes n'ont pas d'OID elles-mêmes. 
    10337    </para> 
    10338  
    10339       <para> 
    10340         La forme à deux paramètres de <function>obj_description</function> 
    10341        renvoie le commentaire d'un objet de la base de données, spécifié 
    10342        par son OID et le nom du catalogue système le contenant. Par exemple, 
    10343        <literal>obj_description(123456,'pg_class')</literal> récupérerait le 
    10344        commentaire pour une table d'OID 123456. La forme à un paramètre de 
    10345        <function>obj_description</function> requiert seulement l'OID de l'objet. 
    10346        Elle est maintenant obsolète car il n'existe aucune garantie que les 
    10347        OID soient uniques au travers des différents catalogues système&nbsp;; 
    10348        du coup, un mauvais commentaire pourrait être renvoyé. 
    10349       </para> 
    10350  
    10351       <para> 
    10352         <function>shobj_description</function> est utilisé comme 
    10353         <function>obj_description</function>, seulement il est utilisé pour 
    10354        récupérer les commentaires sur les objets partagés. Certains catalogues 
    10355        systèmes sont globaux à toutes les bases de données à l'intérieur de 
    10356        chaque cluster et leurs descriptions sont stockées globalement. 
    10357       </para> 
     10340    colonnes de table car les colonnes n'ont pas d'OID propres. 
     10341   </para> 
     10342 
     10343   <para> 
     10344     La forme à deux paramètres de <function>obj_description</function> 
     10345     renvoie le commentaire d'un objet de la base de données, précisé 
     10346     par son OID et le nom du catalogue système le contenant. Par exemple, 
     10347     <literal>obj_description(123456,'pg_class')</literal> récupère le 
     10348     commentaire pour la table d'OID 123456. La forme à un paramètre de 
     10349     <function>obj_description</function> ne requiert que l'OID de l'objet. 
     10350     Elle est maintenant obsolète car il n'existe aucune garantie que les 
     10351     OID soient uniques au travers des différents catalogues système&nbsp;; 
     10352     un mauvais commentaire peut alors être renvoyé. 
     10353   </para> 
     10354    
     10355   <para> 
     10356     <function>shobj_description</function> est utilisé comme 
     10357     <function>obj_description</function>, mais pour 
     10358     récupérer les commentaires des objets partagés. Certains catalogues 
     10359     systèmes sont globaux à toutes les bases de données à l'intérieur de 
     10360     chaque cluster et leurs descriptions sont stockées globalement. 
     10361   </para> 
    1035810362</sect1> 
    1035910363 
     10364<!-- ICI --> 
    1036010365<sect1 id="functions-admin"> 
    1036110366  <title>Fonctions d'administration système</title>