Changeset 852

Show
Ignore:
Timestamp:
12/19/07 21:14:54 (1 year ago)
Author:
sas
Message:

Relecture propagée à la version 8.2

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

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

    r830 r852  
    98579857        <function>has_database_privilege</function> vérifie si l'utilisateur 
    98589858        possède un privilège particulier d'accès à une base de données. Ses 
    9859         arguments sont analogues à 
    9860         <function>has_table_privilege</function>. Les privilèges possibles sont 
    9861         <literal>CREATE</literal>, <literal>CONNECT</literal>, <literal>TEMPORARY</literal> ou 
     9859        arguments sont analogues à <function>has_table_privilege</function>. 
     9860        Les privilèges possibles sont <literal>CREATE</literal>, 
     9861        <literal>CONNECT</literal>, <literal>TEMPORARY</literal> ou 
    98629862        <literal>TEMP</literal> (équivalent à <literal>TEMPORARY</literal>). 
    98639863      </para> 
    …… 
    98779877        <function>has_language_privilege</function> vérifie si l'utilisateur 
    98789878        possède un privilège particulier d'accès à un langage procédural. Ses 
    9879         sont analogues à <function>has_table_privilege</function>. Le seul 
     9879        arguments sont analogues à <function>has_table_privilege</function>. Le seul 
    98809880        privilège possible est <literal>USAGE</literal>. 
    98819881      </para> 
    …… 
    1024210242   la table, il n'est pas traité comme un identifiant entre guillemets 
    1024310243   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 
     10244   paramètre, simple nom de colonne, est traité comme s'il était entre 
    1024510245   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 
     10246   convenablement formatée pour être traitée par les 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 
    …… 
    1035610356     <function>shobj_description</function> est utilisé comme 
    1035710357     <function>obj_description</function>, mais pour 
    10358      récupérer les commentaires des objets partagés. Certains catalogues 
     10358     les commentaires des objets partagés. Certains catalogues 
    1035910359     systèmes sont globaux à toutes les bases de données à l'intérieur de 
    1036010360     chaque cluster et leurs descriptions sont stockées globalement. 
    …… 
    1036210362</sect1> 
    1036310363 
    10364 <!-- ICI --> 
    1036510364<sect1 id="functions-admin"> 
    1036610365  <title>Fonctions d'administration système</title> 
    …… 
    1036810367  <para> 
    1036910368    Le <xref linkend="functions-admin-set-table"/> affiche les fonctions 
    10370     disponibles pour connaître ou modifier les paramètres de configuration 
     10369    disponibles pour consulter et modifier les paramètres de configuration 
    1037110370    en exécution. 
    1037210371  </para> 
    1037310372     
    1037410373    <table id="functions-admin-set-table"> 
    10375       <title>Fonctions de paramétrage de configuration</title> 
     10374      <title>Fonctions agissant sur les paramètres de configuration</title> 
    1037610375      <tgroup cols="3"> 
    1037710376        <colspec colnum="1" colwidth="1.3*"/> 
    …… 
    1039310392            </entry> 
    1039410393            <entry><type>text</type></entry> 
    10395             <entry>valeur actuelle du paramètre</entry> 
     10394            <entry>valeur courante du paramètre</entry> 
    1039610395          </row> 
    1039710396          <row> 
    …… 
    1040010399               (<parameter>nom_paramètre</parameter>, 
    1040110400               <parameter>nouvelle_valeur</parameter>, 
    10402                <parameter>est_locale</parameter>)</function></literal> 
     10401               <parameter>est_local</parameter>)</function></literal> 
    1040310402            </entry> 
    1040410403            <entry><type>text</type></entry> 
    …… 
    1042110420      <primary>configuration</primary> 
    1042210421      <secondary sortas="server">du serveur</secondary> 
    10423       <tertiary>functions</tertiary> 
     10422      <tertiary>fonctions</tertiary> 
    1042410423    </indexterm> 
    1042510424     
    …… 
    1042810427      courante du paramètre <parameter>nom_paramètre</parameter>. Elle 
    1042910428      correspond à la commande <acronym>SQL</acronym>  
    10430       <command>SHOW</command>. Un exemple&nbsp;: 
     10429      <command>SHOW</command>. Par exemple&nbsp;: 
    1043110430      <programlisting>SELECT current_setting('datestyle'); 
    1043210431 
    …… 
    1043810437     
    1043910438    <para> 
    10440       <function>set_config</function> configure le paramètre 
    10441       <parameter>nom_paramètre</parameter> avec 
     10439      <function>set_config</function> positionne le paramètre 
     10440      <parameter>nom_paramètre</parameter> à 
    1044210441      <parameter>nouvelle_valeur</parameter>.  Si  
    10443       <parameter>est_locale</parameter> vaut <literal>true</literal>, la 
    10444       nouvelle valeur s'appliquera seulement à la transaction en cours. Si 
    10445       vous voulez que la nouvelle valeur s'applique à la session en cours, 
    10446       utilisez <literal>false</literal> à la place. La fonction correspond à 
    10447       la commande SQL <command>SET</command>. Un exemple&nbsp;: 
     10442      <parameter>est_local</parameter> vaut <literal>true</literal>, la 
     10443      nouvelle valeur s'applique uniquement la transaction en cours. Si 
     10444      la nouvelle valeur doit s'appliquer à la session en cours, 
     10445      on utilise <literal>false</literal>. La fonction correspond à 
     10446      la commande SQL <command>SET</command>. Par exemple&nbsp;: 
    1044810447      <programlisting>SELECT set_config('log_statement_stats', 'off', false); 
    1044910448 
    …… 
    1047010469     
    1047110470    <para> 
    10472       Les fonctions montrées dans le <xref linkend="functions-admin-signal-table"/> 
     10471      Les fonctions présentées dans le <xref linkend="functions-admin-signal-table"/> 
    1047310472      envoient des signaux de contrôle aux autres processus serveur. 
    1047410473      L'utilisation de ces fonctions est restreinte aux superutilisateurs. 
    …… 
    1047610475       
    1047710476      <table id="functions-admin-signal-table"> 
    10478         <title>Fonctions d'envoi de signal aux serveurs</title> 
     10477        <title>Fonctions d'envoi de signal au serveur</title> 
    1047910478        <tgroup cols="3"> 
    1048010479          <colspec colnum="1" colwidth="1.3*"/> 
    …… 
    1049610495              </entry> 
    1049710496              <entry><type>boolean</type></entry> 
    10498               <entry>Annule la requête en cours du serveur</entry> 
     10497              <entry>Annule une requête en cours sur le serveur</entry> 
    1049910498            </row> 
    1050010499      <row> 
    …… 
    1050310502        </entry> 
    1050410503       <entry><type>boolean</type></entry> 
    10505        <entry>Cause le chargement des fichiers de configuration par les processus 
     10504       <entry>Impose le rechargement des fichiers de configuration par les processus 
    1050610505       serveur</entry> 
    1050710506      </row> 
    …… 
    1051110510        </entry> 
    1051210511       <entry><type>boolean</type></entry> 
    10513        <entry>Demande une rotation du journal des traces du serveur</entry> 
     10512       <entry>Impose une rotation du journal des traces du serveur</entry> 
    1051410513      </row> 
    1051510514          </tbody> 
    …… 
    1051810517       
    1051910518   <para> 
    10520     Chacune de ces fonctions renvoient <literal>true</literal> en cas de succès, 
     10519    Ces fonctions renvoient <literal>true</literal> en cas de succès, 
    1052110520    <literal>false</literal> en cas d'échec. 
    1052210521   </para> 
    …… 
    1052510524    <function>pg_cancel_backend</function> envoie un signal demandant l'annulation de 
    1052610525    la requête (<systemitem>SIGINT</systemitem>) à un processus serveur identifié 
    10527     par l'ID du processus. L'identifiant du processus d'un serveur actif 
    10528     peut se trouver à partir de la colonne <structfield>procpid</structfield> 
     10526    par l'ID du processus. L'identifiant du processus serveur actif 
     10527    peut être trouvé dans la colonne <structfield>procpid</structfield> 
    1052910528    dans la vue <structname>pg_stat_activity</structname> ou en listant les 
    1053010529    processus <command>postgres</command> sur le serveur avec 
    …… 
    1053410533   <para> 
    1053510534    <function>pg_reload_conf</function> envoie un signal <systemitem>SIGHUP</systemitem> 
    10536     au serveur impliquant un nouveau chargement 
    10537     des fichiers de configuration pour tous les processus serveur. 
     10535    au serveur, ce qui impose le rechargement 
     10536    des fichiers de configuration par tous les processus serveur. 
    1053810537   </para> 
    1053910538 
    1054010539   <para> 
    1054110540    <function>pg_rotate_logfile</function> signale au gestionnaire de journaux de trace 
    10542     de basculer immédiatement vers un nouveau fichier de sortie. Ceci fonctionne 
    10543     seulement quand <varname>redirect_stderr</varname> est utilisé pour les traces, 
    10544     sinon il n'y a pas de sous-processus de gestion des traces. 
     10541    de basculer immédiatement vers un nouveau fichier de sortie. Cela ne  
     10542    fonctionne que lorsque <varname>redirect_stderr</varname> est utilisé pour 
     10543    les traces, puisque dans le cas contraire,  
     10544    il n'y a pas de sous-processus de gestion des traces. 
    1054510545   </para> 
    1054610546 
    …… 
    1057110571     
    1057210572    <para> 
    10573       Les fonctions montrées dans le <xref 
    10574       linkend="functions-admin-backup-table"/> aident à l'exécution de 
    10575       sauvegardes à chaud. L'utilisation d'une des trois premières fonctions 
    10576       est restreinte aux superutilisateurs. 
     10573     Les fonctions présentées dans le 
     10574     <xref linkend="functions-admin-backup-table"/> aident à l'exécution de 
     10575     sauvegardes à chaud. L'utilisation des trois premières fonctions 
     10576     est réservée aux superutilisateurs. 
    1057710577    </para> 
    1057810578       
    …… 
    1059810598              </entry> 
    1059910599              <entry><type>text</type></entry> 
    10600               <entry>Début de la sauvegarde à chaud</entry> 
     10600              <entry>Préparation de la sauvegarde à chaud</entry> 
    1060110601            </row> 
    1060210602            <row> 
    …… 
    1060510605              </entry> 
    1060610606              <entry><type>text</type></entry> 
    10607               <entry>Fin de la sauvegarde à chaud</entry> 
     10607              <entry>Arrêt de la sauvegarde à chaud</entry> 
    1060810608            </row> 
    1060910609           <row> 
    1061010610             <entry><literal><function>pg_switch_xlog</function>()</literal></entry> 
    1061110611             <entry><type>text</type></entry> 
    10612              <entry>Force le passage à un nouveau journal de transactions</entry> 
     10612             <entry>Passage forcé à un nouveau journal de transactions</entry> 
    1061310613           </row> 
    1061410614           <row> 
    …… 
    1061710617             </entry> 
    1061810618             <entry><type>text</type></entry> 
    10619              <entry>Obtient l'emplacement d'écriture du journal de transactions 
    10620                en cours</entry> 
     10619             <entry>Récupération de l'emplacement d'écriture du journal de transactions 
     10620               courant</entry> 
    1062110621           </row> 
    1062210622           <row> 
    …… 
    1062510625            </entry> 
    1062610626            <entry><type>text</type></entry> 
    10627             <entry>Obtient l'emplacement d'insertion du journal de transactions 
    10628               en cours</entry> 
     10627            <entry>Récupération de l'emplacement d'insertion du journal de transactions 
     10628              courant</entry> 
    1062910629           </row> 
    1063010630           <row> 
    …… 
    1063310633            </entry> 
    1063410634            <entry><type>text</type>, <type>integer</type></entry> 
    10635             <entry>Convertit la chaîne de l'emplacement du journal de 
    10636               transactions en nom de fichier et le décalage décimal d'octets 
     10635            <entry>Conversion de la chaîne décrivant l'emplacement du journal de 
     10636              transactions en nom de fichier et décalage en octets 
    1063710637              dans le fichier</entry> 
    1063810638           </row> 
    …… 
    1064210642             </entry> 
    1064310643             <entry><type>text</type></entry> 
    10644              <entry>Convertit la chaîne de l'emplacement du journal de 
     10644             <entry>Conversion de la chaîne décrivant l'emplacement du journal de 
    1064510645               transactions en nom de fichier</entry> 
    1064610646           </row> 
    …… 
    1065010650 
    1065110651    <para> 
    10652       <function>pg_start_backup</function> accepte un seul paramètre qui est un 
    10653       label défini arbitrairement par l'utilisateur pour la sauvegarde 
    10654       (typiquement, cela sera le nom sous lequel le fichier de sauvegarde sera 
    10655       stocké). La fonction écrit un fichier label dans le répertoire de 
    10656       données du groupe, puis renvoie le décalage du journal de transactions de début de 
    10657       sauvegarde au format texte (l'utilisateur n'a pas besoin de faire 
    10658       attention à la valeur du résultat mais il est fourni au cas où il 
    10659       pourrait être utile). 
    10660 <programlisting>postgres=# select pg_start_backup('label_goes_here'); 
     10652      <function>pg_start_backup</function> accepte un paramètre unique,  
     10653      label utilisateur de la sauvegarde (typiquement, le nom 
     10654      du fichier d'enregistrement de la sauvegarde). La fonction écrit un 
     10655      fichier de label dans le répertoire de données du cluster et renvoie 
     10656      la position du début de la sauvegarde dans le journal de transactions 
     10657      au format texte. Ce résultat ne nécessite pas qu'on s'y intéresse, mais 
     10658      il est fourni dans cette éventualité. 
     10659<programlisting>postgres=# select pg_start_backup('le_label_ici'); 
    1066110660 pg_start_backup 
    1066210661----------------- 
    …… 
    1066610665 
    1066710666    <para> 
    10668       <function>pg_stop_backup</function> supprime le fichier label créé par 
     10667      <function>pg_stop_backup</function> supprime le fichier de label créé par 
    1066910668      <function>pg_start_backup</function> et crée, à la place, un fichier 
    10670       historique dans l'emplacement des archives des journaux de transactions. 
    10671       Ce fichier inclut le label donné à <function>pg_start_backup</function>, 
    10672       les emplacements de début et de fin des journaux de transactions pour la 
    10673       sauvegarde ainsi que les heures de début et de fin de la sauvegarde. La 
    10674       valeur en retour est l'emplacement du journal de transactions de fin (qui 
    10675       a de nouveau peu d'intérêt). Après avoir noté l'emplacement de fin, le 
    10676       point d'insertion du journal de transactions actuel est automatiquement 
     10669      d'historique dans l'aire de stockage des archives des journaux de transactions. 
     10670      Ce fichier contient le label passé à <function>pg_start_backup</function>, 
     10671      les emplacements de début et de fin des journaux de transactions 
     10672      correspondant à la sauvegarde et les heures de début et de fin de la sauvegarde. La 
     10673      valeur de retour est l'emplacement du journal de la transaction de fin de 
     10674      sauvegarde (de peu d'intérêt, là encore). Après notification de l'emplacement de fin, le 
     10675      point d'insertion courant du journal de transactions est automatiquement 
    1067710676      avancé au prochain journal de transactions, de façon à ce que le journal 
    10678       de transactions en fin de vie puisse être archivé immédiatement pour 
     10677      de transactions de fin de sauvegarde puisse être archivé immédiatement pour 
    1067910678      terminer la sauvegarde. 
    1068010679    </para> 
    1068110680 
     10681<!-- SAS 20071218 : Partie qui n'apparaît plus dans la doc PG83b4 
    1068210682    <para> 
    1068310683      Pour des détails sur le bon usage de ces fonctions, voir la 
    1068410684      <xref linkend="continuous-archiving"/>. 
    1068510685    </para> 
    10686  
    10687    <para> 
    10688     <function>pg_switch_xlog</function> déplace le prochain journal de 
    10689     transactions, permettant l'archivage du journal en cours (en supposant que 
    10690     vous utilisez l'archivage continu). Le résultat est l'emplacement de fin 
    10691     du journal de transaction à l'intérieur du journal de transaction tout 
    10692     juste terminé. S'il n'y a pas eu d'activité dans les journaux de 
    10693     transactions depuis le dernier changement des journaux de transactions, 
     10686--> 
     10687 
     10688   <para> 
     10689    <function>pg_switch_xlog</function> bascule sur le prochain journal de 
     10690    transactions, ce qui permet d'archiver le journal courant (en supposant que 
     10691    l'archivage continu soit utilisé). La fonction retourne l'emplacement de la 
     10692    transaction finale dans le journal ainsi terminé.  
     10693    S'il n'y a pas eu d'activité dans les journaux de 
     10694    transactions depuis le dernier changement de journal, 
    1069410695    <function>pg_switch_xlog</function> ne fait rien et renvoie l'emplacement 
    1069510696    de fin du journal de transactions précédent. 
    …… 
    1069710698 
    1069810699   <para> 
    10699     <function>pg_current_xlog_location</function> affiche l'emplacement d'écriture 
     10700    <function>pg_current_xlog_location</function> affiche la position d'écriture 
    1070010701    du journal de transactions en cours dans le même format que celui utilisé 
    1070110702    dans les fonctions ci-dessus. De façon similaire, 
    1070210703    <function>pg_current_xlog_insert_location</function> affiche le point 
    10703     d'insertion du journal de transactions courant. Le point d'insertion est la 
     10704    d'insertion dans le journal de transactions courant. Le point d'insertion est la 
    1070410705    fin <quote>logique</quote> du journal de transactions à tout instant alors 
    1070510706    que l'emplacement d'écriture est la fin de ce qui a déjà été écrit à partir 
    10706     des tampons internes du serveur. L'emplacement d'écriture est la fin de ce 
    10707     qui peut être examiné de l'extérieur du serveur et est habituellement 
    10708     ce que vous souhaitez si vous êtes intéressé dans l'archivage des journaux 
    10709     de transactions partiels. Le point d'insertion est rendu disponible 
    10710     principalement pour des raisons de débogage du serveur. Ce sont des 
    10711     opérations de lecture seule et ne nécessitent pas les droits du 
    10712     superutilisateur. 
    10713    </para> 
    10714  
    10715    <para> 
    10716     Vous pouvez utiliser <function>pg_xlogfile_name_offset</function> pour 
     10707    des tampons internes du serveur. La position d'écriture est la fin de ce 
     10708    qui peut être examiné extérieurement au serveur. C'est habituellement 
     10709    l'information nécessaire à qui souhaite archiver des journaux de 
     10710    transactions partiels. Le point d'insertion n'est donné principalement que  
     10711    pour des raisons de débogage du serveur. Il s'agit là d'opérations de 
     10712    lecture seule qui ne nécessitent pas de droits superutilisateur. 
     10713   </para> 
     10714 
     10715   <para> 
     10716    <function>pg_xlogfile_name_offset</function> peut être utilisée pour 
    1071710717    extraire le nom du journal de transactions correspondant et le décalage en octets 
    10718     à partir des résultats des fonctions ci-dessus. Par exemple&nbsp;: 
     10718    à partir du résultat de n'importe quelle fonction ci-dessus. Par exemple&nbsp;: 
    1071910719<programlisting>postgres=# select * from pg_xlogfile_name_offset(pg_stop_backup()); 
    1072010720        file_name         | file_offset  
    …… 
    1072210722 00000001000000000000000D |     4039624 
    1072310723(1 row)</programlisting> 
    10724     De façon similaire, <function>pg_xlogfile_name</function> extrait seulement 
    10725     le nom du journal de transactions. Quand l'emplacement du journal de 
    10726     transactions donné est exactement sur une limite du journal de transactions, 
    10727     les deux fonctions renvoient le nom du journal de transactions précédent. 
    10728     C'est généralement le comportement souhaité pour gérer le comportement de 
    10729     l'archivage des journaux de transactions car le fichier précédent est le dernier 
    10730     qui a besoin d'être archivé. 
    10731    </para> 
    10732  
    10733    <para> 
    10734     Les fonctions montrées dans le <xref linkend="functions-admin-dbsize"/> 
     10724    De façon similaire, <function>pg_xlogfile_name</function> n'extrait que 
     10725    le nom du journal de la transaction. Quand la position dans le journal de 
     10726    la transaction donnée est exactement sur une limite de journal, 
     10727    les deux fonctions renvoient le nom du journal précédent. 
     10728    C'est généralement le comportement souhaité pour gérer l'archivage 
     10729    des journaux, car le fichier précédent est le dernier à devoir être 
     10730    archivé. 
     10731   </para> 
     10732 
     10733    <para> 
     10734      Pour les détails sur le bon usage de ces fonctions, voir la 
     10735      <xref linkend="continuous-archiving"/>. 
     10736    </para> 
     10737 
     10738 
     10739   <para> 
     10740    Les fonctions présentées dans le <xref linkend="functions-admin-dbsize"/> 
    1073510741    calculent l'utilisation de l'espace disque par les objets de la base de 
    1073610742    données. 
    …… 
    1075710763 
    1075810764   <table id="functions-admin-dbsize"> 
    10759     <title>Fonctions de calcul de taille des objets de la base de 
     10765    <title>Fonctions de calcul de la taille des objets de la base de 
    1076010766      données</title> 
    1076110767    <tgroup cols="3"> 
    …… 
    1077710783           </entry> 
    1077810784       <entry><type>int</type></entry> 
    10779        <entry>Nombre d'octets utilisé pour stocker une valeur particulière 
    10780         (pouvant être compressée)</entry> 
     10785       <entry>Nombre d'octets utilisés pour stocker une valeur particulière 
     10786        (éventuellement compressée)</entry> 
    1078110787      </row> 
    1078210788      <row> 
    …… 
    1078510791        </entry> 
    1078610792       <entry><type>bigint</type></entry> 
    10787        <entry>Espace disque utilisé par la base de données dont l'OID est 
    10788         spécifié</entry> 
     10793       <entry>Espace disque utilisé par la base de données d'OID indiqué</entry> 
    1078910794      </row> 
    1079010795      <row> 
    …… 
    1079310798        </entry> 
    1079410799       <entry><type>bigint</type></entry> 
    10795        <entry>Espace disque utilisé par la base de données dont le nom 
    10796         est spécifié</entry> 
     10800       <entry>Espace disque utilisé par la base de données de nom indiqué</entry> 
    1079710801      </row> 
    1079810802      <row> 
    …… 
    1080110805        </entry> 
    1080210806       <entry><type>bigint</type></entry> 
    10803        <entry>Espace disque utilisé par la table ou l'index dont l'OID est 
    10804         spécifié</entry> 
     10807       <entry>Espace disque utilisé par la table ou l'index d'OID indiqué</entry> 
    1080510808      </row> 
    1080610809      <row> 
    …… 
    1080910812        </entry> 
    1081010813       <entry><type>bigint</type></entry> 
    10811        <entry>Espace disque utilisé par la table ou l'index dont le nom est 
    10812         spécifié. Ce dernier peut être qualifié avec un nom de schéma</entry> 
     10814       <entry>Espace disque utilisé par la table ou l'index de nom indiqué. 
     10815       Le nom de la table peut être qualifié par un nom de schéma.</entry> 
    1081310816      </row> 
    1081410817      <row> 
    …… 
    1081710820        </entry> 
    1081810821       <entry><type>text</type></entry> 
    10819        <entry>Convertit une taille en octets en un format lisible par un humain 
    10820         avec des unités de taille</entry> 
     10822       <entry>Convertit une taille en octets en format interprétable par 
     10823       l'utilisateur avec unités</entry> 
    1082110824      </row> 
    1082210825      <row> 
    …… 
    1082510828        </entry> 
    1082610829       <entry><type>bigint</type></entry> 
    10827        <entry>Espace disque utilisé par le tablespace dont l'OID est indiqué</entry> 
     10830       <entry>Espace disque utilisé par le 
     10831       <foreignphrase>tablespace</foreignphrase> d'OID indiqué</entry> 
    1082810832      </row> 
    1082910833      <row> 
    …… 
    1083210836        </entry> 
    1083310837       <entry><type>bigint</type></entry> 
    10834        <entry>Espace disque utilisé par le tablespace dont le nom est indiqué</entry> 
     10838       <entry>Espace disque utilisé par le 
     10839       <foreignphrase>tablespace</foreignphrase> de nom indiqué</entry> 
    1083510840      </row> 
    1083610841      <row> 
    …… 
    1083910844        </entry> 
    1084010845       <entry><type>bigint</type></entry> 
    10841        <entry>Espace disque occupé par la table dont l'OID est spécifié, en 
    10842        incluant les index et les données stockées par les tables TOAST</entry> 
     10846       <entry>Espace disque total occupé par la table d'OID indiqué, en 
     10847       incluant les index et les données TOASTées</entry> 
    1084310848      </row> 
    1084410849      <row> 
    …… 
    1084710852       </entry> 
    1084810853       <entry><type>bigint</type></entry> 
    10849        <entry>Espace disque total utilisé par la table dont le nom est 
    10850         spécifié, en incluant les index et les données stockées dans les tables 
    10851         TOAST. Le nom de la table peut être qualifié avec un nom de 
    10852         schéma</entry> 
     10854       <entry>Espace disque total utilisé par la table de nom indiqué, en 
     10855       incluant les index et les données TOASTées. Le nom de la table peut être 
     10856       qualifié par un nom de schéma</entry> 
    1085310857      </row> 
    1085410858     </tbody> 
    …… 
    1086310867   <para> 
    1086410868    <function>pg_database_size</function> et <function>pg_tablespace_size</function> acceptent 
    10865     l'OID ou le nom d'une base de données ou d'un tablespace, et renvoient 
    10866     l'espace disque total utilisé. 
     10869    l'OID ou le nom d'une base de données ou d'un 
     10870    <foreignphrase>tablespace</foreignphrase> et renvoient l'espace disque total utilisé. 
    1086710871   </para> 
    1086810872 
    1086910873   <para> 
    1087010874    <function>pg_relation_size</function> accepte l'OID ou le nom d'une table, d'un 
    10871     index ou d'une table toast, et renvoie la taille en octet. 
     10875    index ou d'une table toast et renvoie la taille en octets. 
    1087210876   </para> 
    1087310877 
    1087410878   <para> 
    1087510879    <function>pg_size_pretty</function> peut être utilisé pour formater le résultat 
    10876     d'une des autres fonctions d'une façon lisible par un être humain, 
    10877     c'est-à-dire en utilisant kB, MB, GB ou TB lorsque cela est approprié. 
     10880    d'une des autres fonctions de façon interprétable par l'utilisateur, 
     10881    en utilisant kB, MB, GB ou TB suivant le cas. 
    1087810882   </para> 
    1087910883 
    …… 
    1088510889 
    1088610890   <para> 
    10887     Les fonctions montrées dans le <xref 
    10888     linkend="functions-admin-genfile"/> fournissent un accès natif aux 
    10889     du serveur. Seuls les fichiers contenus dans le répertoire du groupe de 
    10890     la base de donénes et ceux du répertoire <varname>log_directory</varname> 
    10891     sont accessibles. Utilisez un chemin relatif pour les fichiers du 
    10892     répertoire du groupe et un chemin correspondant à la configuration du 
     10891    Les fonctions présentées dans le <xref 
     10892    linkend="functions-admin-genfile"/> fournissent un accès natif aux fichiers 
     10893    situés sur le serveur. Seuls les fichiers contenus dans le répertoire du 
     10894    cluster et ceux du répertoire <varname>log_directory</varname> 
     10895    sont accessibles. On utilise un chemin relatif pour les fichiers contenus 
     10896    dans le répertoire du cluster et un chemin correspondant à la configuration du 
    1089310897    paramètre <varname>log_directory</varname> pour les journaux de trace. 
    10894     L'utilisation de ces fonctions sont restreintes aux superutilisateurs. 
     10898    L'utilisation de ces fonctions est restreinte aux superutilisateurs. 
    1089510899   </para> 
    1089610900 
    …… 
    1092210926       </entry> 
    1092310927       <entry><type>text</type></entry> 
    10924        <entry>renvoie le contenu d'un fichier texte</entry> 
     10928       <entry>Renvoie le contenu d'un fichier texte</entry> 
    1092510929      </row> 
    1092610930      <row> 
    …… 
    1092910933       </entry> 
    1093010934       <entry><type>record</type></entry> 
    10931        <entry>renvoie des informations sur un fichier</entry> 
     10935       <entry>Renvoie les informations concernant un fichier</entry> 
    1093210936      </row> 
    1093310937     </tbody> 
    …… 
    1093910943   </indexterm> 
    1094010944   <para> 
    10941     <function>pg_ls_dir</function> renvoie tous les noms du répertoire spécifié sauf 
    10942     les entrées spéciales <quote><literal>.</literal></quote> et <quote><literal>..</literal></quote>. 
     10945    <function>pg_ls_dir</function> renvoie tous les noms contenus dans le 
     10946    répertoire indiqué, à l'exception des entrées spéciales 
     10947    <quote><literal>.</literal></quote> et <quote><literal>..</literal></quote>. 
    1094310948   </para> 
    1094410949 
    …… 
    1095910964   <para> 
    1096010965    <function>pg_stat_file</function> renvoie un enregistrement contenant la taille 
    10961     du fichier, la date et heure du dernier accès, la date et heure de la 
    10962     dernière modification, la date et heure du dernier changement de statut 
    10963     (plateformes Unix seulement), la date et heure de création (Windows 
     10966    du fichier, les date et heure de dernier accès, les date et heure de 
     10967    dernière modification, les date et heure de dernier changement de statut 
     10968    (plateformes Unix seulement), les date et heure de création (Windows 
    1096410969    seulement) et un booléen indiquant s'il s'agit d'un répertoire. Les 
    10965     usages typiques incluent&nbsp;: 
     10970    usages habituels incluent&nbsp;: 
    1096610971<programlisting>SELECT * FROM pg_stat_file('nomfichier'); 
    1096710972SELECT (pg_stat_file('nomfichier')).modification;</programlisting> 
    …… 
    1096910974 
    1097010975   <para> 
    10971     Les fonctions affichées dans <xref linkend="functions-advisory-locks"/> gèrent 
    10972     les verrous informatifs. Pour les détails sur le bon usage de ces fonctions, 
     10976    Les fonctions présentées dans <xref linkend="functions-advisory-locks"/> gèrent 
     10977    les verrous consultatifs. Pour les détails sur le bon usage de ces fonctions, 
    1097310978    voir <xref linkend="advisory-locks"/>. 
    1097410979   </para> 
    1097510980 
    1097610981   <table id="functions-advisory-locks"> 
    10977     <title>Fonctions des verrous informatifs</title> 
     10982    <title>Fonctions de verrous consultatifs</title> 
    1097810983    <tgroup cols="3"> 
    1097910984     <thead> 
    …… 
    1098810993       </entry> 
    1098910994       <entry><type>void</type></entry> 
    10990        <entry>Obtient un verrou informatif exclusif</entry> 
     10995       <entry>Obtient un verrou consultatif exclusif</entry> 
    1099110996      </row> 
    1099210997      <row> 
    …… 
    1099511000       </entry> 
    1099611001       <entry><type>void</type></entry> 
    10997        <entry>Obtient un verrou informatif exclusif</entry> 
     11002       <entry>Obtient un verrou consultatif exclusif</entry> 
    1099811003      </row> 
    1099911004 
    …… 
    1100311008       </entry> 
    1100411009       <entry><type>void</type></entry> 
    11005        <entry>Obtient un verrou informatif partagé</entry> 
     11010       <entry>Obtient un verrou consultatif partagé</entry> 
    1100611011      </row> 
    1100711012      <row> 
    …… 
    1101011015       </entry> 
    1101111016       <entry><type>void</type></entry> 
    11012        <entry>Obtient un verrou informatif partagé</entry> 
     11017       <entry>Obtient un verrou consultatif partagé</entry> 
    1101311018      </row> 
    1101411019 
    …… 
    1101811023       </entry> 
    1101911024       <entry><type>boolean</type></entry> 
    11020        <entry>Obtient un verrou informatif exclusif si disponible</entry> 
     11025       <entry>Obtient un verrou consultatif exclusif si disponible</entry> 
    1102111026      </row> 
    1102211027      <row> 
    …… 
    1102511030       </entry> 
    1102611031       <entry><type>boolean</type></entry> 
    11027        <entry>Obtient un verrou informatif exclusif si disponible</entry> 
     11032       <entry>Obtient un verrou consultatif exclusif si disponible</entry> 
    1102811033      </row> 
    1102911034 
    …… 
    1103311038       </entry> 
    1103411039       <entry><type>boolean</type></entry> 
    11035        <entry>Obtient un verrou informatif partagé si disponible</entry> 
     11040       <entry>Obtient un verrou consultatif partagé si disponible</entry> 
    1103611041      </row> 
    1103711042      <row> 
    …… 
    1104011045       </entry> 
    1104111046       <entry><type>boolean</type></entry> 
    11042        <entry>Obtient un verrou informatif partagé si disponible</entry> 
     11047       <entry>Obtient un verrou consultatif partagé si disponible</entry> 
    1104311048      </row> 
    1104411049 
    …… 
    1104811053       </entry> 
    1104911054       <entry><type>boolean</type></entry> 
    11050        <entry>Relâche un verrou informatif exclusif</entry> 
     11055       <entry>Relâche un verrou consultatif exclusif</entry> 
    1105111056      </row> 
    1105211057      <row> 
    …… 
    1105511060       </entry> 
    1105611061       <entry><type>boolean</type></entry> 
    11057        <entry>Relâche un verrou informatif exclusif</entry> 
     11062       <entry>Relâche un verrou consultatif exclusif</entry> 
    1105811063      </row> 
    1105911064 
    …… 
    1106311068       </entry> 
    1106411069       <entry><type>boolean</type></entry> 
    11065        <entry>Relâche un verrou informatif partagé</entry> 
     11070       <entry>Relâche un verrou consultatif partagé</entry> 
    1106611071      </row> 
    1106711072      <row> 
    …… 
    1107011075       </entry> 
    1107111076       <entry><type>boolean</type></entry> 
    11072        <entry>Relâche un verrou informatif partagé</entry> 
     11077       <entry>Relâche un verrou consultatif partagé</entry> 
    1107311078      </row> 
    1107411079 
    …… 
    1107811083       </entry> 
    1107911084       <entry><type>void</type></entry> 
    11080        <entry>Relâche tous les verrous informatifs détenus par la session en cours</entry> 
     11085       <entry>Relâche tous les verrous consultatifs détenus par la session en cours</entry> 
    1108111086      </row> 
    1108211087 
    …… 
    1108911094   </indexterm> 
    1109011095   <para> 
    11091     <function>pg_advisory_lock</function> verrouille une ressource définie par 
    11092     l'application qui peut être identifiée soit par une valeur de clé sur 64 
    11093     bits soit par deux valeurs de clé sur 32 bits (notez que les deux espaces 
     11096    <function>pg_advisory_lock</function> verrouille une ressource applicative 
     11097    qui peut être identifiée soit par une valeur de clé sur 64 
     11098    bits soit par deux valeurs de clé sur 32 bits (les deux espaces 
    1109411099    de clé ne se surchargent pas). Si une autre session détient déjà un verrou 
    11095     sur la même ressource, la fonction attendra jusqu'à ce que la ressource 
    11096     devienne disponible. Le verrou est exclusif. Les demandes de verrous 
    11097     s'empilent pour que, si une même ressource est verrouillée trois fois, 
     11100    sur la même ressource, la fonction attend que la ressource 
     11101    devienne disponible. Le verrou est exclusif. Les demandes de verrou 
     11102    s'empilent de sorte que, si une même ressource est verrouillée trois fois, 
    1109811103    elle doit être déverrouillée trois fois pour être disponible par les autres 
    1109911104    sessions. 
    …… 
    1110611111    <function>pg_advisory_lock_shared</function> fonctionne de façon identique 
    1110711112    à <function>pg_advisory_lock</function> sauf que le verrou peut être 
    11108     partagé avec d'autres sessions qui réclament des verrous partagés. Seuls 
    11109     les demandes de verrous exclusifs sont bloqués. 
     11113    partagé avec d'autres sessions qui réclament des verrous partagés. Seules 
     11114    les demandes de verrou exclusif sont bloquées. 
    1111011115   </para> 
    1111111116 
    …… 
    1111511120   <para> 
    1111611121    <function>pg_try_advisory_lock</function> est similaire à 
    11117     <function>pg_advisory_lock</function> sauf que la fonction n'attendra pas 
    11118     la disponibilité du verrou. Soit il obtiendra le verrou immédiatement et 
    11119     renverra true, soit il ne l'obtiendra pas et il renverra 
     11122    <function>pg_advisory_lock</function> sauf que la fonction n'attend pas 
     11123    la disponibilité du verrou. Si le verrou peut être obtenu immédiatement, 
     11124    et la fonction renvoie <literal>true</liteeral>, sinon, elle renvoie 
    1112011125    <literal>false</literal>. 
    1112111126   </para> 
    …… 
    1112611131   <para> 
    1112711132    <function>pg_try_advisory_lock_shared</function> fonctionne de la même façon 
    11128     que <function>pg_try_advisory_lock</function> sauf s'il tente d'acquérir 
     11133    que <function>pg_try_advisory_lock</function> sauf qu'elle tente d'acquérir 
    1112911134    un verrou partagé au lieu d'un verrou exclusif. 
    1113011135   </para> 
    …… 
    1113411139   </indexterm> 
    1113511140   <para> 
    11136     <function>pg_advisory_unlock</function> lâchera un verrou informatif 
    11137     exclusif précédemment acquis. Il renverra <literal>true</literal> si le 
     11141    <function>pg_advisory_unlock</function> relâche un verrou  
     11142    exclusif précédemment acquis. Elle retourne <literal>true</literal> si le 
    1113811143    verrou est relaché avec succès. Si le verrou n'était pas détenu, 
    11139     <literal>false</literal> sera renvoyé. De plus, un message d'avertissement 
    11140     SQL sera émis par le serveur. 
     11144    <literal>false</literal> est renvoyé et un message d'avertissement 
     11145    SQL est émis par le serveur. 
    1114111146   </para> 
    1114211147 
    …… 
    1114611151   <para> 
    1114711152    <function>pg_advisory_unlock_shared</function> fonctionne de la même façon 
    11148     que <function>pg_advisory_unlock</function> sauf pour relacher un verrou 
    11149     informatif partagé. 
     11153    que <function>pg_advisory_unlock</function> mais pour relâcher un verrou 
     11154    partagé. 
    1115011155   </para> 
    1115111156 
    …… 
    1115411159   </indexterm> 
    1115511160   <para> 
    11156     <function>pg_advisory_unlock_all</function> relachera tous les verrous 
    11157     informatifs détenus par la session courante. (Cette fonction est appelée 
     11161    <function>pg_advisory_unlock_all</function> relâche tous les verrous 
     11162    consultatifs détenus par la session courante. (Cette fonction est appelée 
    1115811163    implicitement à la fin de la session, même si le client se déconnecte 
    11159     d'une mauvaise façon.) 
     11164    brutalement.) 
    1116011165   </para> 
    1116111166 

  • traduc/trunk/manuel/func.xml

    r851 r852  
    1264712647   <para> 
    1264812648    Les fonctions présentées dans <xref linkend="functions-advisory-locks"/> gèrent 
    12649     les verrous informatifs. Pour les détails sur le bon usage de ces fonctions, 
     12649    les verrous consultatifs. Pour les détails sur le bon usage de ces fonctions, 
    1265012650    voir <xref linkend="advisory-locks"/>. 
    1265112651   </para> 
    …… 
    1266512665       </entry> 
    1266612666       <entry><type>void</type></entry> 
    12667        <entry>Obtient un verrou informatif exclusif</entry> 
     12667       <entry>Obtient un verrou consultatif exclusif</entry> 
    1266812668      </row> 
    1266912669      <row> 
    …… 
    1272512725       </entry> 
    1272612726       <entry><type>boolean</type></entry> 
    12727        <entry>Relâche un verrou informatif exclusif</entry> 
     12727       <entry>Relâche un verrou consultatif exclusif</entry> 
    1272812728      </row> 
    1272912729      <row> 
    …… 
    1275512755       </entry> 
    1275612756       <entry><type>void</type></entry> 
    12757        <entry>Relâche tous les verrous consultatif détenus par la session en cours</entry> 
     12757       <entry>Relâche tous les verrous consultatifs détenus par la session en cours</entry> 
    1275812758      </row> 
    1275912759 
    …… 
    1281412814    exclusif précédemment acquis. Elle retourne <literal>true</literal> si le 
    1281512815    verrou est relaché avec succès. Si le verrou n'était pas détenu, 
    12816     <literal>false</literal> est renvoyéi et un message d'avertissement 
     12816    <literal>false</literal> est renvoyé et un message d'avertissement 
    1281712817    SQL est émis par le serveur. 
    1281812818   </para> 
    …… 
    1283212832   <para> 
    1283312833    <function>pg_advisory_unlock_all</function> relâche tous les verrous 
    12834     détenus par la session courante. (Cette fonction est appelée 
     12834    consultatifs détenus par la session courante. (Cette fonction est appelée 
    1283512835    implicitement à la fin de la session, même si le client se déconnecte 
    1283612836    brutalement.)