forked from gleu/pgdocs_fr
/
contrib.xml
129 lines (117 loc) · 4.11 KB
/
contrib.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
<?xml version="1.0" encoding="UTF-8"?>
<!-- Dernière modification
le $Date$
par $Author$
révision $Revision$ -->
<appendix id="contrib">
<title>Modules supplémentaires fournis</title>
<para>
Cette annexe contient des informations concernant les modules disponibles
dans le répertoire <literal>contrib</literal> de la distribution
<productname>PostgreSQL</productname>. Ce sont des outils de portage,
des outils d'analyse, des fonctionnalités supplémentaires qui ne font pas
partie du système PostgreSQL de base, principalement parce qu'ils
s'adressent à une audience limitée ou sont trop expérimentaux pour faire
partie de la distribution de base. Cela ne concerne en rien leur utilité.
</para>
<para>
Lors de la construction à partir des sources de la distribution, ces modules
ne sont pas construits automatiquement. Il peuvent être construits et
installés en exécutant :
<screen>
<userinput>gmake</userinput>
<userinput>gmake install</userinput>
</screen>
dans le répertoire <literal>contrib</literal> d'un répertoire des sources
configuré ; ou pour ne construire et installer qu'un seul module
sélectionné, on exécute ces commandes dans le sous-répertoire du module. Beaucoup
de ces modules ont des tests de régression qui peuvent être exécutés
en lançant la commande :
<screen>
<userinput>gmake installcheck</userinput>
</screen>
une fois que le serveur <productname>PostgreSQL</productname> est démarré.
(<literal>gmake check</literal> n'est pas
supporté ; un serveur de bases de données opérationnel est nécessaire
pour réaliser ces tests, et le module doit avoir été construit et installé
pour être testé.)
</para>
<para>
Lorsqu'une version packagée de <productname>PostgreSQL</productname> est
utilisée, ces modules sont typiquement
disponibles dans un package séparé, comme par exemple
<literal>postgresql-contrib</literal>.
</para>
<para>
Beaucoup de ces modules fournissent de nouvelles fonctions, de nouveaux
opérateurs ou types utilisateurs. Pour pouvoir utiliser un de ces
modules, après avoir installé le code, il faut enregistrer les
nouveaux objets dans la base de données en exécutant les commandes SQL
contenus dans le fichier <literal>.sql</literal> fourni par le module.
Par exemple :
<programlisting>
psql -d nom_base -f <replaceable>SHAREDIR</replaceable>/contrib/<replaceable>module</replaceable>.sql
</programlisting>
Ici, <replaceable>SHAREDIR</replaceable> est le répertoire
<quote>share</quote> de l'installation (<literal>pg_config
--sharedir</literal> indique de quel répertoire il s'agit).
Dans la plupart de cas, le script doit être exécuté par un super-utilisateur
de la base de données.
</para>
<para>
Le fichier <literal>.sql</literal> doit être exécuté dans
chaque base de données où le module doit être disponible. Il peut également
être exécuté dans la base <literal>template1</literal> pour que le module
soit automatiquement copié dans toute nouvelle base de données créée.
</para>
<para>
La première commande du fichier <literal>.sql</literal> peut être modifiée
pour déterminer le schéma de la base où sont créés
les objets. Par défaut, ils sont placés dans <literal>public</literal>.
</para>
<para>
Après une mise à jour majeure de <productname>PostgreSQL</productname>,
le script d'installation doit être réexécuté, même si les objets du
module sont éventuellement créés par une sauvegarde de l'ancienne
installation. Cela assure que toute nouvelle fonction est
disponible et tout correction nécessaire appliquée.
</para>
&adminpack;
&auto-explain;
&btree-gin;
&btree-gist;
&chkpass;
&citext;
&cube;
&dblink;
&dict-int;
&dict-xsyn;
&earthdistance;
&fuzzystrmatch;
&hstore;
&intagg;
&intarray;
&isn;
&lo;
<ree;
&oid2name;
&pageinspect;
&pgbench;
&pgbuffercache;
&pgcrypto;
&pgfreespacemap;
&pgrowlocks;
&pgstandby;
&pgstatstatements;
&pgstattuple;
&pgtrgm;
&seg;
&contrib-spi;
&sslinfo;
&tablefunc;
&test-parser;
&tsearch2;
&uuid-ossp;
&vacuumlo;
&xml2;
</appendix>