Changeset 743

Show
Ignore:
Timestamp:
10/10/07 18:45:44 (1 year ago)
Author:
kryskool
Message:

Traduction de la partie Large Object + correction erreur reporter en 8.2
refs #188

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • traduc/trunk/manuel/lobj.xml

    r735 r743  
    4242    fonctionnalité des objets larges. Un avantage restant des objets larges est 
    4343    qu'il autorise les valeurs de plus de 2 Go en taille alors que les 
    44     champs <acronym>TOAST</acronym> peuvent être d'au plus 1&nbsp;Go. De plus, 
     44    champs <acronym>TOAST</acronym> peuvent être d'au plus 1&nbsp;Go. Néanmoins, 
    4545    les objets larges peuvent être modifiés au hasard en utilisant une API de 
    4646    lecture/écriture qui est plus efficace que la réalisation de telles 
    …… 
    5454 
    5555   <para> 
    56     L'implémentation des objets larges coupe les objets larges en 
    57     <quote>morceaux</quote> (<foreignphrase>chunks</foreignphrase>) et stocke  
    58     les morceaux dans les lignes de la base de données. Un index B-tree 
    59     garantit des recherches rapides pour le bon numéro du morceau lors d'accès 
     56    L'implémentation des objets larges, les coupe en 
     57    <quote>morceaux</quote> (<foreignphrase>chunks</foreignphrase>) stockés  
     58    dans les lignes de la base de données. Un index B-tree 
     59    garantit des recherches rapides sur le numéro du morceau lors d'accès 
    6060    aléatoires en lecture et écriture. 
    6161   </para> 
    …… 
    6767   <para> 
    6868    Cette section décrit les possibilités que les bibliothèques d'interfaces 
    69     client de <productname>PostgreSQL</productname> fournissent pour accéder 
     69    clientes de <productname>PostgreSQL</productname> fournissent pour accéder 
    7070    aux objets larges. Toutes les manipulations d'objets larges utilisant ces 
    7171    fonctions <emphasis>doivent</emphasis> prendre place dans un bloc de 
    …… 
    7878 
    7979   <para> 
    80     Les applications clients utilisant l'interface des objets larges dans 
     80    Les applications clientes utilisant l'interface des objets larges dans 
    8181    <application>libpq</application> doivent inclure le fichier d'en-tête 
    8282    <filename>libpq/libpq-fs.h</filename> et établir un lien avec la 
    …… 
    9292</synopsis> 
    9393     <indexterm><primary>lo_creat</primary></indexterm> 
    94      crée un nouvel objet large. La valeur de retour est l'OID assigné au 
     94     crée un nouvel objet large. La valeur de retour est un OID assigné au 
    9595     nouvel objet large ou <symbol>InvalidOid</symbol> (zéro) en cas d'erreur. 
    9696 
    …… 
    202202     significative entre ces modes et <symbol>INV_READ</symbol> seul&nbsp;: avec 
    203203     <symbol>INV_READ</symbol>, vous ne pouvez pas écrire sur le descripteur et la 
    204      donnée lue à partir de ce dernier reflètera le contenu de l'objet large 
     204     donnée lue à partir de ce dernier, reflètera le contenu de l'objet large 
    205205     au moment où <function>lo_open</function> a été exécuté dans la transaction active, 
    206      quelque soient les possibles écritures par cette transaction ou par 
     206     quelques soient les possibles écritures par cette transaction ou par 
    207207     d'autres. Lire à partir d'un descripteur ouvert avec 
    208208     <symbol>INV_WRITE</symbol> renvoie des données reflétant toutes les 
    …… 
    257257<para> 
    258258     Pour modifier l'emplacement courant de lecture ou écriture associé au 
    259      descripteur d'un objet large, appelez 
     259     descripteur d'un objet large, on utilise 
    260260<synopsis>int lo_lseek(PGconn *conn, int fd, int offset, int whence); 
    261261</synopsis> 
    …… 
    280280<synopsis>int lo_tell(PGconn *conn, int fd); 
    281281</synopsis> 
    282      <indexterm><primary>lo_tell</primary></indexterm> S'il y a une erreur, le code de retour 
     282     <indexterm><primary>lo_tell</primary></indexterm> En cas d'erreur, le code de retour 
    283283     est négatif. 
    284284</para> 
    …… 
    286286 
    287287<sect2> 
    288 <title>Truncating a Large Object</title> 
    289  
    290 <para> 
    291      To truncate a large object to a given length, call 
     288<title>Tronquer un Objet Large</title> 
     289 
     290<para> 
     291     Pour tronquer un objet large avec une longueur donnée, on utilise 
    292292<synopsis> 
    293293int lo_truncate(PGcon *conn, int fd, size_t len); 
    294294</synopsis> 
    295      <indexterm><primary>lo_truncate</primary></indexterm> truncates the large object 
    296          descriptor <parameter>fd</parameter> to length <parameter>len</parameter>.  The 
    297      <parameter>fd</parameter> argument must have been returned by a 
    298          previous <function>lo_open</function>.  If <parameter>len</parameter> is 
    299      greater than the current large object length, the large object 
    300      is extended with null bytes ('\0'). 
    301 </para> 
    302  
    303 <para> 
    304      The file offset is not changed. 
    305 </para> 
    306  
    307 <para> 
    308      On success <function>lo_truncate</function> returns 
    309      zero. On error, the return value is negative. 
    310 </para> 
    311  
    312 <para> 
    313      <function>lo_truncate</function> is new as of <productname>PostgreSQL</productname> 
    314      8.3; if this function is run against an older server version, it will 
    315      fail and return a negative value. 
     295     <indexterm><primary>lo_truncate</primary></indexterm> tronque l'objet large 
     296     décrit par <parameter>fd</parameter> avec la longueur <parameter>len</parameter>.  l'argument 
     297     <parameter>fd</parameter> doit avoir été renvoyé par un appel précédent à 
     298     <function>lo_open</function>.  Si le paramètre <parameter>len</parameter> est 
     299     plus grand que la taille de l'objet courant, l'objet sera completé 
     300     avec des octets de valeur null ('\0'). 
     301</para> 
     302 
     303<para> 
     304     Le décalage reste inchangé. 
     305</para> 
     306 
     307<para> 
     308     En cas de succès <function>lo_truncate</function> retourne  
     309     zero. En cas d'erreur, la valeur de retour est négative. 
     310</para> 
     311 
     312<para> 
     313     <function>lo_truncate</function> est une nouveauté de <productname>PostgreSQL</productname> 
     314     8.3; si cette fonction est également exécuté sur un version plus ancienne du serveur,  
     315     elle échouera et retournera une valeur négative. 
    316316</para> 
    317317</sect2> 
    …… 
    326326     <indexterm><primary>lo_close</primary></indexterm> où <parameter>fd</parameter> est un  
    327327     descripteur d'objet large renvoyé par <function>lo_open</function>. En 
    328      cas de succès, <function>lo_close</function> renvoie zéro. Renvoie 1 en 
    329      cas de succès, -1 en cas d'échec. 
     328     cas de succès, <function>lo_close</function> renvoie zéro. Une valeur negative en cas d'échec. 
    330329</para> 
    331330 
    …… 
    340339 
    341340    <para> 
    342      Pour supprimer un objet large de la base de données, appelez 
     341     Pour supprimer un objet large de la base de données, on utilise 
    343342<synopsis>int lo_unlink(PGconn *conn, Oid lobjId); 
    344343</synopsis> 
    345344     <indexterm><primary>lo_unlink</primary></indexterm> L'argument 
    346345     <parameter>lobjId</parameter> spécifie l'OID de l'objet large à supprimer. 
    347      Dans le cas d'une erreur, le code de retour est négatif. 
     346     En cas d'erreur, le code de retour est négatif. 
    348347    </para> 
    349348   </sect2> 
    …… 
    391390client. Ces deux fonctions lisent et écrivent des fichiers dans le système de 
    392391fichiers du serveur en utilisant les droits du propriétaire du serveur de base 
    393 de données. Du coup, leur utilisation est restreinte aux superutilisateurs. Au 
    394 contraire des fonctions côté serveur, les fonctions d'import et d'export côté 
     392de données. Du coup, leur utilisation est restreinte aux superutilisateurs PostgreSQL.  
     393Au contraire des fonctions côté serveur, les fonctions d'import et d'export côté 
    395394client lisent et écrivent des fichiers dans le système de fichiers du client en 
    396395utilisant les droits du programme client. Les fonctions côté client peuvent être 
    397 utilisées par tout utilisateur <productname>PostgreSQL</productname>. 
     396utilisées par tout utilisateurs <productname>PostgreSQL</productname>. 
    398397</para> 
    399398</sect1>