Skip to content

Commit

Permalink
Merge vers la RC1.
Browse files Browse the repository at this point in the history
  • Loading branch information
@gleu
gleu committed Aug 27, 2010
1 parent 3ad6e9c commit 413a227
Show file tree
Hide file tree
Showing 56 changed files with 2,157 additions and 1,613 deletions.
204 changes: 116 additions & 88 deletions postgresql/backup.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
<listitem><para>l'archivage continu.</para></listitem>
</itemizedlist>
Chacune a ses avantages et ses inconvénients.
Elles sont toutes analysées, chacune leur tour.
Elles sont toutes analysées, chacune leur tour, dans les sections suivantes.
</para>

<sect1 id="backup-dump">
Expand Down Expand Up @@ -76,6 +76,16 @@
<xref linkend="client-authentication"/>).
</para>

<para>
An important advantage of <application>pg_dump</application> over the other backup
methods described later is that <application>pg_dump</application>'s output can
generally be re-loaded into newer versions of <productname>PostgreSQL</productname>,
whereas file-level backups and continuous archiving are both extremely
server-version-specific. <application>pg_dump</application> is also the only method
that will work when transferring a database to a different machine
architecture, such as going from a 32-bit to a 64-bit server.
</para>

<para>
Les sauvegardes créées par <application>pg_dump</application> sont
cohérentes, ce qui signifie que la sauvegarde représente une image de la
Expand Down Expand Up @@ -1487,18 +1497,87 @@ archive_command = 'local_backup_script.sh'
</para>

<para>
Pour les versions <emphasis>majeures</emphasis> de
<productname>PostgreSQL</productname>, le format de stockage interne est
sujet à modifications. Lors de la migration des données d'une version
majeure de <productname>PostgreSQL</productname> à une autre, vous devez
sauvegarder vos données et les restaurer sur le nouveau serveur. Ceci doit
se faire en utilisant <application>pg_dump</application>&nbsp;; une
sauvegarde au niveau système de fichiers ne fonctionnera pas. Il existe des
vérifications pour vous prémunir de l'utilisation d'un répertoire de
données avec une version incompatible de
<productname>PostgreSQL</productname>, donc aucun risque n'est encouru en
essayant de démarrer la mauvaise version du serveur sur un répertoire des
données.
For <emphasis>major</emphasis> releases of <productname>PostgreSQL</productname>, the
internal data storage format is subject to change, thus complicating
upgrades. The traditional method for moving data to a new major version
is to dump and reload the database. Other, less-well-tested possibilities
are available, as discussed below.
</para>

<para>
New major versions also typically introduce some user-visible
incompatibilities, so application programming changes may be required.
Cautious users will want to test their client applications on the new
version before switching over fully; therefore, it's often a good idea to
set up concurrent installations of old and new versions. When
testing a <productname>PostgreSQL</productname> major upgrade, consider the
following categories of possible changes:
</para>

<variablelist>

<varlistentry>
<term>Administration</term>
<listitem>
<para>
The capabilities available for administrators to monitor and control
the server often change and improve in each major release.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>SQL</term>
<listitem>
<para>
Typically this includes new SQL command capabilities and not changes
in behavior, unless specifically mentioned in the release notes.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Library API</term>
<listitem>
<para>
Typically libraries like <application>libpq</application> only add new
functionality, again unless mentioned in the release notes.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>System Catalogs</term>
<listitem>
<para>
System catalog changes usually only affect database management tools.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Server C-language API</term>
<listitem>
<para>
This involves changes in the backend function API, which is written
in the C programming language. Such changes affect code that
references backend functions deep inside the server.
</para>
</listitem>
</varlistentry>

</variablelist>

<sect2 id="migration-methods-pgdump">
<title>Migrating data via <application>pg_dump</application></title>

<para>
To dump data from one major version of <productname>PostgreSQL</productname> and
reload it in another, you must use <application>pg_dump</application>; file system
level backup methods will not work. (There are checks in place that prevent
you from using a data directory with an incompatible version of
<productname>PostgreSQL</productname>, so no great harm can be done by
trying to start the wrong server version on a data directory.)
</para>

<para>
Expand Down Expand Up @@ -1526,19 +1605,6 @@ archive_command = 'local_backup_script.sh'
cela, perdues. Le <xref linkend="client-authentication"/> informe sur la
façon d'interdire l'accès.
</para>

<para>
Il est aussi possible d'utiliser des outils de réplication comme
<productname>Slony</productname> pour créer un serveur en attente avec la
nouvelle version de <productname>PostgreSQL</productname>. Ce serveur en
attente peut
se trouver sur le même ordinateur ou sur un autre. Une fois qu'il est
synchronisé avec le serveur maître (utilisant l'ancienne version de
<productname>PostgreSQL</productname>), le maître et le serveur en attente
peuvent être basculés pour que l'esclave devienne le maître.
L'ancien serveur peut alors être arrêté. Ce basculement intervient en
quelques secondes dans le cadre d'une mise à jour.
</para>

<para>
Si n'est pas souhaité, ou pas possible, de lancer les deux serveurs en
Expand Down Expand Up @@ -1584,71 +1650,33 @@ psql -f sauvegarde.sql postgres</programlisting>
</para>
</note>

<para>
En pratique, vous voudrez probablement tester vos applications clientes
sur la nouvelle version avant de basculer complètement. C'est une raison
supplémentaire pour faire cohabiter des installations d'anciennes et nouvelles
versions. Quand vous testez une mise à jour majeure de
<productname>PostgreSQL</productname>, prenez en compte les catégories
suivantes de changements potentiels&nbsp;:
</para>

<variablelist>

<varlistentry>
<term>Administration</term>
<listitem>
<para>
Les fonctionnalités de surveillance et de contrôle du serveur changent
et s'améliorent souvent à l'occasion d'une version majeure.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>SQL</term>
<listitem>
<para>
De façon générale, elle inclut de nouvelles fonctionnalités et commandes SQL,
et non des changements de comportements, sauf notification contraire dans les
notes de version.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>API des bibliothèques</term>
<listitem>
<para>
Habituellement, les bibliothèques telles que <application>libpq</application>
ne font qu'ajouter des fonctionnalités, sauf notification contraire dans les
notes de version.
</para>
</listitem>
</varlistentry>
</sect2>

<varlistentry>
<term>Catalogues systèmes</term>
<listitem>
<para>
Les changements concernant le catalogue système n'affectent habituellement que
les outils de gestion de base de données.
</para>
</listitem>
</varlistentry>
<sect2 id="migration-methods-other">
<title>Other data migration methods</title>

<varlistentry>
<term>API serveur pour le langage C</term>
<listitem>
<para>
Cela implique des changements dans les API des fonctions du serveur, qui est
écrit dans le langage de programmation C. Des changements de ce type touche du
code qui utilise des fonctions profondément internes au serveur.
</para>
</listitem>
</varlistentry>
<para>
The <filename>contrib</filename> program
<link linkend="pgupgrade"><application>pg_upgrade</application></link>
allows an installation to be migrated in-place from one major
<productname>PostgreSQL</productname> version to the next. Keep in mind that this
method does not provide any scope for running old and new versions
concurrently. Also, <application>pg_upgrade</application> is much less
battle-tested than <application>pg_dump</application>, so having an
up-to-date backup is strongly recommended in case something goes wrong.
</para>

</variablelist>
<para>
It is also possible to use certain replication methods, such as
<productname>Slony</productname>, to create a standby server with the updated version of
<productname>PostgreSQL</productname>. The standby can be on the same computer or
a different computer. Once it has synced up with the master server
(running the older version of <productname>PostgreSQL</productname>), you can
switch masters and make the standby the master and shut down the older
database instance. Such a switch-over results in only several seconds
of downtime for an upgrade.
</para>

</sect2>
</sect1>
</chapter>
8 changes: 4 additions & 4 deletions postgresql/btree-gin.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

<para>
<filename>btree_gin</filename> fournit des échantillons de classes d'opérateurs
GIN qui codent un comportement équivalent à un B-Tree pour les types
GIN qui codent un comportement équivalent à un B-tree pour les types
<type>int2</type>, <type>int4</type>, <type>int8</type>, <type>float4</type>,
<type>float8</type>, <type>timestamp with time zone</type>,
<type>timestamp without time zone</type>, <type>time with time zone</type>,
Expand All @@ -21,12 +21,12 @@

<para>
En général, ces classes d'opérateurs ne sont pas plus rapides que
les méthodes standard d'indexation btree équivalentes, et il leur manque
une fonctionnalité majeure du code btree standard&nbsp;: la capacité à forcer
les méthodes standard d'indexation B-tree équivalentes, et il leur manque
une fonctionnalité majeure du code B-tree standard&nbsp;: la capacité à forcer
l'unicité. Toutefois, elles sont utiles pour tester GIN et comme base pour
développer d'autres classes d'opérateurs GIN. Par ailleurs, pour des requêtes
qui testent à la fois une colonnne indexable via GIN et une colonne indexable
par btree, il peut être plus efficace de créer un index GIN multicolonne
par B-tree, il peut être plus efficace de créer un index GIN multicolonne
qui utilise une de ces classes d'opérateurs que de créer deux index séparés
qui devront être combinés via une opération de bitmap ET.
</para>
Expand Down
8 changes: 4 additions & 4 deletions postgresql/btree-gist.xml
View file
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
<?xml version="1.0" encoding="ISO-8859-15"?>
<sect1 id="btree-gist">
<sect1 id="B-tree-gist">
<title>btree_gist</title>

<indexterm zone="btree-gist">
<indexterm zone="B-tree-gist">
<primary>btree_gist</primary>
</indexterm>

<para>
<filename>btree_gist</filename> fournit des exemples de classes d'opérateur
GiST qui codent un comportement équivalent à celui du B-Tree pour les
GiST qui codent un comportement équivalent à celui du B-tree pour les
types de données
<type>int2</type>, <type>int4</type>, <type>int8</type>, <type>float4</type>,
<type>float8</type>, <type>numeric</type>, <type>timestamp with time
Expand All @@ -23,7 +23,7 @@

<para>
En règle général, ces classes d'opérateur ne dépassent pas en
performance les méthodes d'indexage standard équivalentes du B-Tree. Il
performance les méthodes d'indexage standard équivalentes du B-tree. Il
leur manque une fonctionnalité majeure&nbsp;: la possibilité d'assurer
l'unicité. Néanmoins, elles sont utiles pour des tests de GiST et comme
base pour le développement d'autres classes d'opérateur GiST.
Expand Down
22 changes: 17 additions & 5 deletions postgresql/catalogs.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -477,7 +477,7 @@
<entry><type>bool</type></entry>
<entry></entry>
<entry>La méthode d'accès supporte-t-elle les recherches
IS NULL/NOT NULL&nbsp;?</entry>
<literal>IS NULL</literal>/<literal>NOT NULL</literal>&nbsp;?</entry>
</row>

<row>
Expand Down Expand Up @@ -1530,6 +1530,16 @@ lourd ! -->
</entry>
</row>

<row>
<entry><structfield>reloftype</structfield></entry>
<entry><type>oid</type></entry>
<entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry>
<entry>
For typed tables, the OID of the underlying composite type,
zero for all other relations
</entry>
</row>

<row>
<entry><structfield>relowner</structfield></entry>
<entry><type>oid</type></entry>
Expand Down Expand Up @@ -2997,7 +3007,8 @@ lourd ! -->
Si vrai, les requêtes ne doivent pas utiliser l'index tant que le
<structfield>xmin</structfield> de cette ligne de
<structname>pg_index</structname> est en-dessous de leur horizon
d'événements TransactionXmin, car la table peut contenir des chaînes
d'événements <symbol>TransactionXmin</symbol>, car la table peut
contenir des chaînes
HOT cassées avec des lignes incompatibles qu'elles peuvent voir.
</entry>
</row>
Expand Down Expand Up @@ -3293,7 +3304,7 @@ lourd ! -->
pouvait être utilisé pour obtenir les OID (et le contenu) de tous les
«&nbsp;Large Objects&nbsp;» du système. Ce n'est plus le cas&nbsp;;
utilisez <link
linkend="catalog-pg-largeobject-metadata">pg_largeobject_metadata</link>
linkend="catalog-pg-largeobject-metadata"><structname>pg_largeobject_metadata</structname></link>
pour obtenir une liste des OID des «&nbsp;Large Objects&nbsp;».
</para>

Expand Down Expand Up @@ -3365,7 +3376,7 @@ lourd ! -->
Le catalogue <structname>pg_largeobject_metadata</structname> contient des
méta-données associées aux «&nbsp;Larges Objects&nbsp;». Les données des
«&nbsp;Larges Objects&nbsp;» sont réellement stockées dans <link
linkend="catalog-pg-largeobject">pg_largeobject</link>.
linkend="catalog-pg-largeobject"><structname>pg_largeobject</structname></link>.
</para>

<table>
Expand Down Expand Up @@ -5796,7 +5807,8 @@ lourd ! -->
<entry><structfield>typanalyze</structfield></entry>
<entry><type>regproc</type></entry>
<entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry>
<entry>Fonction ANALYZE personnalisée ou 0 pour utiliser la fonction standard</entry>
<entry>Fonction <command>ANALYZE</command> personnalisée ou 0 pour
utiliser la fonction standard</entry>
</row>

<row>
Expand Down
6 changes: 3 additions & 3 deletions postgresql/chkpass.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -30,8 +30,8 @@
la sauvegarde et la restauration des mots de passe sans les chiffrer de
nouveau. Pour obtenir le mot de passe (chiffré) sans le symbole deux-points,
on utilise la fonction <function>raw()</function>. Ceci permet d'utiliser
le type avec d'autres
choses comme, par exemple, le module Auth_PostgreSQL d'Apache.
le type avec d'autres choses comme, par exemple, le module
<literal>Auth_PostgreSQL</literal> d'Apache.
</para>

<para>
Expand All @@ -42,7 +42,7 @@
</para>

<para>
Le type de données n'est pas indexable.
Le type de données <type>chkpass</type> n'est pas indexable.
<!--
I haven't worried about making this type indexable. I doubt that anyone
would ever need to sort a file in order of encrypted password.
Expand Down
5 changes: 3 additions & 2 deletions postgresql/citext.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,8 @@

L'ordre <command>SELECT</command> va renvoyer un enregistrement, bien que
la colonne <structfield>nick</structfield> ait été positionnée à
<quote>larry</quote> et que la requête soit pour <quote>Larry</quote>.
<literal>larry</literal> et que la requête soit pour
<literal>Larry</literal>.
</para>
</sect2>

Expand Down Expand Up @@ -194,7 +195,7 @@
<listitem>
<para>
<type>citext</type> n'est pas aussi performant que <type>text</type> parce que
les fonctions opérateurs et les fonctions de comparaison btree
les fonctions opérateurs et les fonctions de comparaison B-tree
doivent faire des copies des données et les convertir en minuscules pour les
comparaisons. C'est cependant légèrement plus efficace qu'utiliser
<function>lower</function> pour obtenir des comparaisons insensibles à la casse.
Expand Down

0 comments on commit 413a227

Please sign in to comment.