← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/postgresql-9.1/oneiric-security

« back to all changes in this revision

Viewing changes to doc/src/sgml/postgres.sgml

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2011-05-11 10:41:53 UTC
  • Revision ID: james.westby@ubuntu.com-20110511104153-psbh2o58553fv1m0
Tags: upstream-9.1~beta1
Import upstream version 9.1~beta1

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/src/sgml/postgres.sgml
 
1
<!-- doc/src/sgml/postgres.sgml -->
 
2
 
 
3
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.2//EN" [
 
4
 
 
5
<!ENTITY % version SYSTEM "version.sgml">
 
6
%version;
 
7
<!ENTITY % filelist SYSTEM "filelist.sgml">
 
8
%filelist;
 
9
 
 
10
<!ENTITY reference  SYSTEM "reference.sgml">
 
11
 
 
12
]>
 
13
 
 
14
<book id="postgres">
 
15
 <title>PostgreSQL &version; Documentation</title>
 
16
 
 
17
 <bookinfo>
 
18
  <corpauthor>The PostgreSQL Global Development Group</corpauthor>
 
19
  <productname>PostgreSQL</productname>
 
20
  <productnumber>&version;</productnumber>
 
21
  &legal;
 
22
 </bookinfo>
 
23
 
 
24
 &intro;
 
25
 
 
26
 <part id="tutorial">
 
27
  <title>Tutorial</title>
 
28
 
 
29
  <partintro>
 
30
   <para>
 
31
    Welcome to the <productname>PostgreSQL</productname> Tutorial.  The
 
32
    following few chapters are intended to give a simple introduction
 
33
    to <productname>PostgreSQL</productname>, relational database
 
34
    concepts, and the SQL language to those who are new to any one of
 
35
    these aspects.  We only assume some general knowledge about how to
 
36
    use computers.  No particular Unix or programming experience is
 
37
    required.  This part is mainly intended to give you some hands-on
 
38
    experience with important aspects of the
 
39
    <productname>PostgreSQL</productname> system.  It makes no attempt
 
40
    to be a complete or thorough treatment of the topics it covers.
 
41
   </para>
 
42
 
 
43
   <para>
 
44
    After you have worked through this tutorial you might want to move
 
45
    on to reading <xref linkend="sql"> to gain a more formal knowledge
 
46
    of the SQL language, or <xref linkend="client-interfaces"> for
 
47
    information about developing applications for
 
48
    <productname>PostgreSQL</productname>.  Those who set up and
 
49
    manage their own server should also read <xref linkend="admin">.
 
50
   </para>
 
51
  </partintro>
 
52
 
 
53
  &start;
 
54
  &query;
 
55
  &advanced;
 
56
 
 
57
 </part>
 
58
 
 
59
 <part id="sql">
 
60
  <title>The SQL Language</title>
 
61
 
 
62
  <partintro>
 
63
   <para>
 
64
    This part describes the use of the <acronym>SQL</acronym> language
 
65
    in <productname>PostgreSQL</productname>.  We start with
 
66
    describing the general syntax of <acronym>SQL</acronym>, then
 
67
    explain how to create the structures to hold data, how to populate
 
68
    the database, and how to query it.  The middle part lists the
 
69
    available data types and functions for use in
 
70
    <acronym>SQL</acronym> commands.  The rest treats several
 
71
    aspects that are important for tuning a database for optimal
 
72
    performance.
 
73
   </para>
 
74
 
 
75
   <para>
 
76
    The information in this part is arranged so that a novice user can
 
77
    follow it start to end to gain a full understanding of the topics
 
78
    without having to refer forward too many times.  The chapters are
 
79
    intended to be self-contained, so that advanced users can read the
 
80
    chapters individually as they choose.  The information in this
 
81
    part is presented in a narrative fashion in topical units.
 
82
    Readers looking for a complete description of a particular command
 
83
    should see <xref linkend="reference">.
 
84
   </para>
 
85
 
 
86
   <para>
 
87
    Readers of this part should know how to connect to a
 
88
    <productname>PostgreSQL</> database and issue
 
89
    <acronym>SQL</acronym> commands.  Readers that are unfamiliar with
 
90
    these issues are encouraged to read <xref linkend="tutorial">
 
91
    first.  <acronym>SQL</acronym> commands are typically entered
 
92
    using the <productname>PostgreSQL</> interactive terminal
 
93
    <application>psql</application>, but other programs that have
 
94
    similar functionality can be used as well.
 
95
   </para>
 
96
  </partintro>
 
97
 
 
98
  &syntax;
 
99
  &ddl;
 
100
  &dml;
 
101
  &queries;
 
102
  &datatype;
 
103
  &func;
 
104
  &typeconv;
 
105
  &indices;
 
106
  &textsearch;
 
107
  &mvcc;
 
108
  &perform;
 
109
 
 
110
 </part>
 
111
 
 
112
 <part id="admin">
 
113
  <title>Server Administration</title>
 
114
 
 
115
  <partintro>
 
116
   <para>
 
117
    This part covers topics that are of interest to a
 
118
    <productname>PostgreSQL</> database administrator.  This includes
 
119
    installation of the software, set up and configuration of the
 
120
    server, management of users and databases, and maintenance tasks.
 
121
    Anyone who runs a <productname>PostgreSQL</> server, even for
 
122
    personal use, but especially in production, should be familiar
 
123
    with the topics covered in this part.
 
124
   </para>
 
125
 
 
126
   <para>
 
127
    The information in this part is arranged approximately in the
 
128
    order in which a new user should read it.  But the chapters are
 
129
    self-contained and can be read individually as desired.  The
 
130
    information in this part is presented in a narrative fashion in
 
131
    topical units.  Readers looking for a complete description of a
 
132
    particular command should see <xref linkend="reference">.
 
133
   </para>
 
134
 
 
135
   <para>
 
136
    The first few chapters are written so they can be understood
 
137
    without prerequisite knowledge, so new users who need to set
 
138
    up their own server can begin their exploration with this part.
 
139
    The rest of this part is about tuning and management; that material
 
140
    assumes that the reader is familiar with the general use of
 
141
    the <productname>PostgreSQL</> database system.  Readers are
 
142
    encouraged to look at <xref linkend="tutorial"> and <xref
 
143
    linkend="sql"> for additional information.
 
144
   </para>
 
145
  </partintro>
 
146
 
 
147
  &installation;
 
148
  &installw;
 
149
  &runtime;
 
150
  &config;
 
151
  &client-auth;
 
152
  &user-manag;
 
153
  &manage-ag;
 
154
  &charset;
 
155
  &maintenance;
 
156
  &backup;
 
157
  &high-availability;
 
158
  &recovery-config;
 
159
  &monitoring;
 
160
  &diskusage;
 
161
  &wal;
 
162
  &regress;
 
163
 
 
164
 </part>
 
165
 
 
166
 <part id="client-interfaces">
 
167
  <title>Client Interfaces</title>
 
168
 
 
169
  <partintro>
 
170
   <para>
 
171
    This part describes the client programming interfaces distributed
 
172
    with <productname>PostgreSQL</>.  Each of these chapters can be
 
173
    read independently.  Note that there are many other programming
 
174
    interfaces for client programs that are distributed separately and
 
175
    contain their own documentation (<xref linkend="external-projects">
 
176
    lists some of the more popular ones).  Readers of this part should be
 
177
    familiar with using <acronym>SQL</acronym> commands to manipulate
 
178
    and query the database (see <xref linkend="sql">) and of course
 
179
    with the programming language that the interface uses.
 
180
   </para>
 
181
  </partintro>
 
182
 
 
183
  &libpq;
 
184
  &lobj;
 
185
  &ecpg;
 
186
  &infoschema;
 
187
 
 
188
 </part>
 
189
 
 
190
 <part id="server-programming">
 
191
  <title>Server Programming</title>
 
192
 
 
193
  <partintro>
 
194
   <para>
 
195
    This part is about extending the server functionality with
 
196
    user-defined functions, data types, triggers, etc.  These are
 
197
    advanced topics which should probably be approached only after all
 
198
    the other user documentation about <productname>PostgreSQL</> has
 
199
    been understood.  Later chapters in this part describe the server-side
 
200
    programming languages available in the
 
201
    <productname>PostgreSQL</productname> distribution as well as
 
202
    general issues concerning server-side programming languages.  It
 
203
    is essential to read at least the earlier sections of <xref
 
204
    linkend="extend"> (covering functions) before diving into the
 
205
    material about server-side programming languages.
 
206
   </para>
 
207
  </partintro>
 
208
 
 
209
  &extend;
 
210
  &trigger;
 
211
  &rules;
 
212
 
 
213
  &xplang;
 
214
  &plsql;
 
215
  &pltcl;
 
216
  &plperl;
 
217
  &plpython;
 
218
 
 
219
  &spi;
 
220
 
 
221
 </part>
 
222
 
 
223
 &reference;
 
224
 
 
225
 <part id="internals">
 
226
  <title>Internals</title>
 
227
 
 
228
  <partintro>
 
229
   <para>
 
230
    This part contains assorted information that might be of use to
 
231
    <productname>PostgreSQL</> developers.
 
232
   </para>
 
233
  </partintro>
 
234
 
 
235
  &arch-dev;
 
236
  &catalogs;
 
237
  &protocol;
 
238
  &sources;
 
239
  &nls;
 
240
  &plhandler;
 
241
  &fdwhandler;
 
242
  &geqo;
 
243
  &indexam;
 
244
  &gist;
 
245
  &gin;
 
246
  &storage;
 
247
  &bki;
 
248
  &planstats;
 
249
 
 
250
 </part>
 
251
 
 
252
 <part id="appendixes">
 
253
  <title>Appendixes</title>
 
254
 
 
255
  &errcodes;
 
256
  &datetime;
 
257
  &keywords;
 
258
  &features;
 
259
  &release;
 
260
  &contrib;
 
261
  &external-projects;
 
262
  &sourcerepo;
 
263
  &docguide;
 
264
  &acronyms;
 
265
 
 
266
 </part>
 
267
 
 
268
 &biblio;
 
269
 <![%include-index;[&bookindex;]]>
 
270
 
 
271
</book>