Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
P
Postgres FD Implementation
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Analytics
Analytics
CI / CD
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Abuhujair Javed
Postgres FD Implementation
Commits
0f763503
Commit
0f763503
authored
Oct 23, 2006
by
Peter Eisentraut
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Spellchecking and such
parent
033cb9d3
Changes
35
Expand all
Hide whitespace changes
Inline
Side-by-side
Showing
35 changed files
with
231 additions
and
228 deletions
+231
-228
doc/src/sgml/backup.sgml
doc/src/sgml/backup.sgml
+4
-4
doc/src/sgml/catalogs.sgml
doc/src/sgml/catalogs.sgml
+14
-14
doc/src/sgml/client-auth.sgml
doc/src/sgml/client-auth.sgml
+3
-3
doc/src/sgml/config.sgml
doc/src/sgml/config.sgml
+10
-10
doc/src/sgml/cvs.sgml
doc/src/sgml/cvs.sgml
+9
-9
doc/src/sgml/datatype.sgml
doc/src/sgml/datatype.sgml
+4
-4
doc/src/sgml/ddl.sgml
doc/src/sgml/ddl.sgml
+5
-5
doc/src/sgml/docguide.sgml
doc/src/sgml/docguide.sgml
+2
-2
doc/src/sgml/ecpg.sgml
doc/src/sgml/ecpg.sgml
+54
-54
doc/src/sgml/func.sgml
doc/src/sgml/func.sgml
+30
-30
doc/src/sgml/gist.sgml
doc/src/sgml/gist.sgml
+2
-2
doc/src/sgml/history.sgml
doc/src/sgml/history.sgml
+3
-3
doc/src/sgml/indices.sgml
doc/src/sgml/indices.sgml
+3
-3
doc/src/sgml/information_schema.sgml
doc/src/sgml/information_schema.sgml
+2
-2
doc/src/sgml/libpq.sgml
doc/src/sgml/libpq.sgml
+7
-6
doc/src/sgml/lobj.sgml
doc/src/sgml/lobj.sgml
+7
-7
doc/src/sgml/maintenance.sgml
doc/src/sgml/maintenance.sgml
+4
-3
doc/src/sgml/plperl.sgml
doc/src/sgml/plperl.sgml
+3
-3
doc/src/sgml/plpgsql.sgml
doc/src/sgml/plpgsql.sgml
+5
-5
doc/src/sgml/plpython.sgml
doc/src/sgml/plpython.sgml
+2
-2
doc/src/sgml/queries.sgml
doc/src/sgml/queries.sgml
+2
-2
doc/src/sgml/ref/alter_table.sgml
doc/src/sgml/ref/alter_table.sgml
+2
-2
doc/src/sgml/ref/comment.sgml
doc/src/sgml/ref/comment.sgml
+2
-2
doc/src/sgml/ref/create_trigger.sgml
doc/src/sgml/ref/create_trigger.sgml
+2
-2
doc/src/sgml/ref/drop_type.sgml
doc/src/sgml/ref/drop_type.sgml
+2
-2
doc/src/sgml/ref/insert.sgml
doc/src/sgml/ref/insert.sgml
+2
-2
doc/src/sgml/ref/pg_config-ref.sgml
doc/src/sgml/ref/pg_config-ref.sgml
+8
-8
doc/src/sgml/ref/pg_dump.sgml
doc/src/sgml/ref/pg_dump.sgml
+2
-2
doc/src/sgml/ref/psql-ref.sgml
doc/src/sgml/ref/psql-ref.sgml
+2
-2
doc/src/sgml/ref/values.sgml
doc/src/sgml/ref/values.sgml
+3
-3
doc/src/sgml/release.sgml
doc/src/sgml/release.sgml
+22
-21
doc/src/sgml/sources.sgml
doc/src/sgml/sources.sgml
+2
-2
doc/src/sgml/spi.sgml
doc/src/sgml/spi.sgml
+2
-2
doc/src/sgml/wal.sgml
doc/src/sgml/wal.sgml
+3
-3
doc/src/sgml/xindex.sgml
doc/src/sgml/xindex.sgml
+2
-2
No files found.
doc/src/sgml/backup.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/backup.sgml,v 2.9
0 2006/10/12 19:38:08 neilc
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/backup.sgml,v 2.9
1 2006/10/23 18:10:30 petere
Exp $ -->
<chapter id="backup">
<title>Backup and Restore</title>
...
...
@@ -977,7 +977,7 @@ restore_command = 'cp /mnt/server/archivedir/%f %p'
If recovery fails for an external reason, such as a system crash or
the WAL archive has become inaccessible, then the recovery can be
simply restarted and it will restart almost from where it failed.
Restartable recovery works by writing a restartpoint record to the control
Restartable recovery works by writing a restart
-
point record to the control
file at the first safely usable checkpoint record found after
<varname>checkpoint_timeout</> seconds.
</para>
...
...
@@ -1188,7 +1188,7 @@ restore_command = 'copy /mnt/server/archivedir/%f "%p"' # Windows
<para>
If we take a backup of the server files whilst a recovery is in progress,
we will be able to restart the recovery from the last restartpoint.
we will be able to restart the recovery from the last restart
point.
That backup now has many of the changes from previous WAL archive files,
so this version is now an updated version of the original base backup.
If we need to recover, it will be faster to recover from the
...
...
@@ -1595,7 +1595,7 @@ if (!triggered)
<para>
An external program can call <function>pg_xlogfile_name_offset()</>
to find out the filename and the exact byte offset within it of
to find out the file
name and the exact byte offset within it of
the latest WAL pointer. If the external program regularly polls
the server it can find out how far forward the pointer has
moved. It can then access the WAL file directly and copy those
...
...
doc/src/sgml/catalogs.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/catalogs.sgml,v 2.13
4 2006/09/22 23:20:13 tgl
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/catalogs.sgml,v 2.13
5 2006/10/23 18:10:30 petere
Exp $ -->
<!--
Documentation of the system catalogs, directed toward PostgreSQL developers
-->
...
...
@@ -405,7 +405,7 @@
<entry><structfield>amclusterable</structfield></entry>
<entry><type>bool</type></entry>
<entry></entry>
<entry>Can an index of this type be
CLUSTER
ed on?</entry>
<entry>Can an index of this type be
cluster
ed on?</entry>
</row>
<row>
...
...
@@ -496,7 +496,7 @@
<entry><structfield>amoptions</structfield></entry>
<entry><type>regproc</type></entry>
<entry><literal><link linkend="catalog-pg-proc"><structname>pg_proc</structname></link>.oid</literal></entry>
<entry>Function to parse and validate
reloptions
for an index</entry>
<entry>Function to parse and validate
<structfield>reloptions</>
for an index</entry>
</row>
</tbody>
...
...
@@ -1209,7 +1209,7 @@
<entry><structfield>vac_scale_factor</structfield></entry>
<entry><type>float4</type></entry>
<entry></entry>
<entry>Multiplier for
reltuples
to add to
<entry>Multiplier for
<structfield>reltuples</>
to add to
<structfield>vac_base_thresh</></entry>
</row>
...
...
@@ -1224,7 +1224,7 @@
<entry><structfield>anl_scale_factor</structfield></entry>
<entry><type>float4</type></entry>
<entry></entry>
<entry>Multiplier for
reltuples
to add to
<entry>Multiplier for
<structfield>reltuples</>
to add to
<structfield>anl_base_thresh</></entry>
</row>
...
...
@@ -2043,7 +2043,7 @@
operation. All rows inserted or deleted by transaction IDs before this one
have been marked as known good or deleted. This
is used to determine when commit-log space can be recycled.
If
InvalidTransactionId
, then the minimum is unknown and can be
If
<symbol>InvalidTransactionId</symbol>
, then the minimum is unknown and can be
determined by scanning <structname>pg_class</>.<structfield>relvacuumxid</>.
</entry>
</row>
...
...
@@ -2058,7 +2058,7 @@
relabeled with a permanent (<quote>frozen</>) transaction ID in this
database. This is useful to check whether a database must be
vacuumed soon to avoid transaction ID wrap-around problems.
If
InvalidTransactionId
, then the minimum is unknown and can be
If
<symbol>InvalidTransactionId</symbol>
, then the minimum is unknown and can be
determined by scanning <structname>pg_class</>.<structfield>relminxid</>.
</entry>
</row>
...
...
@@ -3353,7 +3353,7 @@
<entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry>
<entry>
An array with the data types of the function arguments. This includes
only input arguments (including
INOUT
arguments), and thus represents
only input arguments (including
<literal>INOUT</literal>
arguments), and thus represents
the call signature of the function.
</entry>
</row>
...
...
@@ -3364,7 +3364,7 @@
<entry><literal><link linkend="catalog-pg-type"><structname>pg_type</structname></link>.oid</literal></entry>
<entry>
An array with the data types of the function arguments. This includes
all arguments (including
OUT and INOUT
arguments); however, if all the
all arguments (including
<literal>OUT</literal> and <literal>INOUT</literal>
arguments); however, if all the
arguments are IN arguments, this field will be null.
Note that subscripting is 1-based, whereas for historical reasons
<structfield>proargtypes</> is subscripted from 0.
...
...
@@ -3377,10 +3377,10 @@
<entry></entry>
<entry>
An array with the modes of the function arguments, encoded as
<literal>i</literal> for
IN
arguments,
<literal>o</literal> for
OUT
arguments,
<literal>b</literal> for
INOUT
arguments.
If all the arguments are
IN
arguments, this field will be null.
<literal>i</literal> for
<literal>IN</>
arguments,
<literal>o</literal> for
<literal>OUT</>
arguments,
<literal>b</literal> for
<literal>INOUT</>
arguments.
If all the arguments are
<literal>IN</literal>
arguments, this field will be null.
Note that subscripts correspond to positions of
<structfield>proallargtypes</> not <structfield>proargtypes</>.
</entry>
...
...
@@ -5031,7 +5031,7 @@
<para>
Advisory locks can be acquired on keys consisting of either a single
bigint value or two integer values. A bigint
key is displayed with its
<type>bigint</type> value or two integer values. A <type>bigint</type>
key is displayed with its
high-order half in the <structfield>classid</> column, its low-order half
in the <structfield>objid</> column, and <structfield>objsubid</> equal
to 1. Integer keys are displayed with the first key in the
...
...
doc/src/sgml/client-auth.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/client-auth.sgml,v 1.9
3 2006/09/16 00:30:11 momjian
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/client-auth.sgml,v 1.9
4 2006/10/23 18:10:30 petere
Exp $ -->
<chapter id="client-authentication">
<title>Client Authentication</title>
...
...
@@ -947,9 +947,9 @@ ldap://ldap.example.net/dc=example,dc=net;EXAMPLE\
</para>
<para>
The server will bind to the distinguished name specified as
<replaceable>base dn</> using the username supplied by the client.
<replaceable>base dn</> using the user
name supplied by the client.
If <replaceable>prefix</> and <replaceable>suffix</> is
specified, it will be prepended and appended to the username
specified, it will be prepended and appended to the user
name
before the bind. Typically, the prefix parameter is used to specify
<replaceable>cn=</>, or <replaceable>DOMAIN\</> in an Active
Directory environment.
...
...
doc/src/sgml/config.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/config.sgml,v 1.9
1 2006/10/19 22:55:25 tgl
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/config.sgml,v 1.9
2 2006/10/23 18:10:30 petere
Exp $ -->
<chapter Id="runtime-config">
<title>Server Configuration</title>
...
...
@@ -75,7 +75,7 @@ shared_buffers = 128MB
<programlisting>
include 'filename'
</programlisting>
If the filename is not an absolute path, it is taken as relative to
If the file
name is not an absolute path, it is taken as relative to
the directory containing the referencing configuration file.
Inclusions can be nested.
</para>
...
...
@@ -206,7 +206,7 @@ SET ENABLE_SEQSCAN TO OFF;
<para>
Specifies the main server configuration file
(customarily called <filename>postgresql.conf</>).
This parameter can only be set on the
postgres
command line.
This parameter can only be set on the
<command>postgres</command>
command line.
</para>
</listitem>
</varlistentry>
...
...
@@ -265,7 +265,7 @@ SET ENABLE_SEQSCAN TO OFF;
<para>
If you wish to keep the configuration files elsewhere than the
data directory, the
postgres
<option>-D</option>
data directory, the
<command>postgres</command>
<option>-D</option>
command-line option or <envar>PGDATA</envar> environment variable
must point to the directory containing the configuration files,
and the <varname>data_directory</> parameter must be set in
...
...
@@ -1422,8 +1422,8 @@ SET ENABLE_SEQSCAN TO OFF;
or power failure. The risks are similar to turning off
<varname>fsync</>, though smaller. It may be safe to turn off
this parameter if you have hardware (such as a battery-backed disk
controller) or file
system software (e.g., Reiser4)
that reduces
the risk of partial page writes to an acceptably low level.
controller) or file
-system software
that reduces
the risk of partial page writes to an acceptably low level
(e.g., ReiserFS 4)
.
</para>
<para>
...
...
@@ -3901,10 +3901,10 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
<listitem>
<para>
This controls whether the array input parser recognizes
unquoted <literal>NULL</> as specifying a
NULL
array element.
unquoted <literal>NULL</> as specifying a
null
array element.
By default, this is <literal>on</>, allowing array values containing
NULL
s to be entered. However, <productname>PostgreSQL</> versions
before 8.2 did not support
NULL
s in arrays, and therefore would
null value
s to be entered. However, <productname>PostgreSQL</> versions
before 8.2 did not support
null value
s in arrays, and therefore would
treat <literal>NULL</> as specifying a normal array element with
the string value <quote>NULL</>. For backwards compatibility with
applications that require the old behavior, this variable can be
...
...
@@ -3912,7 +3912,7 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
</para>
<para>
Note that it is possible to create array values containing
NULL
s
Note that it is possible to create array values containing
null value
s
even when this variable is <literal>off</>.
</para>
</listitem>
...
...
doc/src/sgml/cvs.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/cvs.sgml,v 1.3
7 2006/03/10 19:10:47 momjian
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/cvs.sgml,v 1.3
8 2006/10/23 18:10:30 petere
Exp $ -->
<appendix id="cvs">
<appendixinfo>
...
...
@@ -91,7 +91,7 @@ cvs -z3 -d :pserver:anoncvs@anoncvs.postgresql.org:/projects/cvsroot co -P pgsql
<para>
If you have a fast link to the Internet, you may not need
<option>-z3</option>, which instructs
<productname>CVS</productname> to use
gzip
compression for transferred data. But
<productname>CVS</productname> to use
<command>gzip</command>
compression for transferred data. But
on a modem-speed link, it's a very substantial win.
</para>
</note>
...
...
@@ -131,8 +131,8 @@ cvs -z3
update -d -P
</programlisting>
This supplies the <option>-z3</option> option to all
cvs
commands, and the
<option>-d</option> and <option>-P</option> options to
cvs update
. Then you just have
This supplies the <option>-z3</option> option to all
<command>cvs</>
commands, and the
<option>-d</option> and <option>-P</option> options to
<command>cvs update</>
. Then you just have
to say
<programlisting>
cvs update
...
...
@@ -206,7 +206,7 @@ cvs checkout -r REL6_4 tc
<para>
When you tag more than one file with the same tag you can think
about the tag as <quote>a curve drawn through a matrix of filename vs.
about the tag as <quote>a curve drawn through a matrix of file
name vs.
revision number</quote>. Say we have 5 files with the following revisions:
<programlisting>
...
...
@@ -304,7 +304,7 @@ cvs commit
A major advantage to using
<productname>CVSup</productname> is that it can reliably
replicate the <emphasis>entire</emphasis> CVS repository on your local system,
allowing fast local access to
cvs
operations such as <option>log</option>
allowing fast local access to
<command>cvs</>
operations such as <option>log</option>
and <option>diff</option>. Other advantages include fast synchronization to
the <productname>PostgreSQL</productname> server due to an efficient
streaming transfer protocol which only sends the changes since the last update.
...
...
@@ -445,7 +445,7 @@ CVSROOT/loginfo*
</para>
<para>
The following is a suggested <productname>CVSup</productname> config file from
The following is a suggested <productname>CVSup</productname> config
uration
file from
the <productname>PostgreSQL</>
<ulink url="ftp://ftp.postgresql.org/pub/CVSup/README.cvsup">
ftp site</ulink>
...
...
@@ -570,7 +570,7 @@ mv cvsup.1 ../doc/man/man1/
<step>
<para>
If there is a directory structure in the tar file, then unpack
the tar file within
/usr/local/src
and move the binaries into
the tar file within
<filename>/usr/local/src</filename>
and move the binaries into
the appropriate location as above.
</para>
</step>
...
...
@@ -645,7 +645,7 @@ $ which cvsup
<step>
<para>
Install the Modula-3
rpm
s:
Install the Modula-3
RPM
s:
<programlisting>
# rpm -Uvh pm3*.rpm
...
...
doc/src/sgml/datatype.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.1
79 2006/10/18 16:43:13 tgl
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.1
80 2006/10/23 18:10:30 petere
Exp $ -->
<chapter id="datatype">
<title id="datatype-title">Data Types</title>
...
...
@@ -3362,7 +3362,7 @@ SELECT * FROM pg_attribute
</indexterm>
<para>
<acronym>XML</> (
eX
tensible Markup Language) support is not one
<acronym>XML</> (
Ex
tensible Markup Language) support is not one
capability, but a variety of features supported by a database
system. These capabilities include storage, import/export,
validation, indexing, efficiency of modification, searching,
...
...
@@ -3429,7 +3429,7 @@ SELECT * FROM pg_attribute
indexes to index specific <acronym>XML</> fields. To index the
full contents of <acronym>XML</> documents, the full-text indexing
tool <filename>/contrib/tsearch2</> can be used. Of course,
t
search2 indexes have no <acronym>XML</> awareness so additional
T
search2 indexes have no <acronym>XML</> awareness so additional
<filename>/contrib/xml2</> checks should be added to queries.
</para>
</listitem>
...
...
@@ -3466,7 +3466,7 @@ SELECT * FROM pg_attribute
<listitem>
<para>
<filename>/contrib/xml2</> supports <acronym>XSLT</> (
XML
<filename>/contrib/xml2</> supports <acronym>XSLT</> (
Extensible
Stylesheet Language Transformation).
</para>
</listitem>
...
...
doc/src/sgml/ddl.sgml
View file @
0f763503
<
!-- $PostgreSQL: pgsql/doc/src/sgml/ddl.sgml,v 1.6
6 2006/10/22 03:03:40 tgl
Exp $ -->
<
!-- $PostgreSQL: pgsql/doc/src/sgml/ddl.sgml,v 1.6
7 2006/10/23 18:10:30 petere
Exp $ -->
<
chapter
id
=
"ddl"
>
<
title
>
Data
Definition
</
title
>
...
...
@@ -2586,7 +2586,7 @@ UNION ALL SELECT * FROM measurement_y2006m01;
However
,
the
need
to
recreate
the
view
adds
an
extra
step
to
adding
and
dropping
individual
partitions
of
the
dataset
.
individual
partitions
of
the
data
set
.
</
para
>
</
sect2
>
...
...
@@ -2778,7 +2778,7 @@ EXPLAIN SELECT count(*) FROM measurement WHERE logdate >= DATE '2006-01-01';
Constraint exclusion only works when the query'
s
<
literal
>
WHERE
</>
clause
contains
constants
.
A
parameterized
query
will
not
be
optimized
,
since
the
planner
cannot
know
what
partitions
the
parameter
value
might
select
at
runtime
.
For
the
same
reason
,
parameter
value
might
select
at
run
time
.
For
the
same
reason
,
<
quote
>
stable
</>
functions
such
as
<
function
>
CURRENT_DATE
</
function
>
must
be
avoided
.
</
para
>
...
...
@@ -2786,7 +2786,7 @@ EXPLAIN SELECT count(*) FROM measurement WHERE logdate >= DATE '2006-01-01';
<
listitem
>
<
para
>
Avoid
cross
-
datatype
comparisons
in
the
<
literal
>
CHECK
</>
Avoid
cross
-
data
type
comparisons
in
the
<
literal
>
CHECK
</>
constraints
,
as
the
planner
will
currently
fail
to
prove
such
conditions
false
.
For
example
,
the
following
constraint
will
work
if
<
varname
>
x
</
varname
>
is
an
<
type
>
integer
</
type
>
...
...
@@ -2802,7 +2802,7 @@ CHECK ( x = 1::bigint )
The
problem
is
not
limited
to
the
<
type
>
bigint
</
type
>
data
type
&
mdash
;
it
can
occur
whenever
the
default
data
type
of
the
constant
does
not
match
the
data
type
of
the
column
to
which
it
is
being
compared
.
Cross
-
datatype
comparisons
in
the
supplied
is
being
compared
.
Cross
-
data
type
comparisons
in
the
supplied
queries
are
usually
OK
,
just
not
in
the
<
literal
>
CHECK
</>
conditions
.
</
para
>
</
listitem
>
...
...
doc/src/sgml/docguide.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/docguide.sgml,v 1.5
8 2006/10/23 14:13:43
petere Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/docguide.sgml,v 1.5
9 2006/10/23 18:10:30
petere Exp $ -->
<appendix id="docguide">
<title>Documentation</title>
...
...
@@ -290,7 +290,7 @@ make install
<envar>SGML_CATALOG_FILES</envar> to point to the file
whenever you use <application>jade</application> later on.
(This method is also an option if OpenJade is already
installed and you want to install the rest of the toolchain
installed and you want to install the rest of the tool
chain
locally.)
</para>
</step>
...
...
doc/src/sgml/ecpg.sgml
View file @
0f763503
This diff is collapsed.
Click to expand it.
doc/src/sgml/func.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.34
3 2006/10/01 18:54:31 tgl
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.34
4 2006/10/23 18:10:31 petere
Exp $ -->
<chapter id="functions">
<title>Functions and Operators</title>
...
...
@@ -7686,7 +7686,7 @@ SELECT NULLIF(value, '(none)') ...
<para>
Array comparisons compare the array contents element-by-element,
using the default
bt
ree comparison function for the element data type.
using the default
B-T
ree comparison function for the element data type.
In multidimensional arrays the elements are visited in row-major order
(last subscript varies most rapidly).
If the contents of two arrays are equal but the dimensionality is
...
...
@@ -9003,8 +9003,8 @@ AND
<literal>></> or
<literal>>=</>,
or has semantics similar to one of these. (To be specific, an operator
can be a row comparison operator if it is a member of a
bt
ree operator
class, or is the negator of the <literal>=</> member of a
bt
ree operator
can be a row comparison operator if it is a member of a
B-T
ree operator
class, or is the negator of the <literal>=</> member of a
B-T
ree operator
class.)
</para>
...
...
@@ -10251,35 +10251,35 @@ SELECT set_config('log_statement_stats', 'off', false);
<literal><function>pg_switch_xlog</function>()</literal>
</entry>
<entry><type>text</type></entry>
<entry>Force switch to a new
x
log file</entry>
<entry>Force switch to a new
transaction
log file</entry>
</row>
<row>
<entry>
<literal><function>pg_current_xlog_location</function>()</literal>
</entry>
<entry><type>text</type></entry>
<entry>Get current
x
log write location</entry>
<entry>Get current
transaction
log write location</entry>
</row>
<row>
<entry>
<literal><function>pg_current_xlog_insert_location</function>()</literal>
</entry>
<entry><type>text</type></entry>
<entry>Get current
x
log insert location</entry>
<entry>Get current
transaction
log insert location</entry>
</row>
<row>
<entry>
<literal><function>pg_xlogfile_name_offset</function>(<parameter>location</> <type>text</>)</literal>
</entry>
<entry><type>text</>, <type>integer</></entry>
<entry>Convert
xlog location string to file
name and decimal byte offset within file</entry>
<entry>Convert
transaction log location string to file
name and decimal byte offset within file</entry>
</row>
<row>
<entry>
<literal><function>pg_xlogfile_name</function>(<parameter>location</> <type>text</>)</literal>
</entry>
<entry><type>text</type></entry>
<entry>Convert
xlog location string to file
name</entry>
<entry>Convert
transaction log location string to file
name</entry>
</row>
</tbody>
</tgroup>
...
...
@@ -10290,7 +10290,7 @@ SELECT set_config('log_statement_stats', 'off', false);
arbitrary user-defined label for the backup. (Typically this would be
the name under which the backup dump file will be stored.) The function
writes a backup label file into the database cluster's data directory,
and then returns the backup's starting
x
log location as text. The user
and then returns the backup's starting
transaction
log location as text. The user
need not pay any attention to this result value, but it is provided in
case it is of use.
<programlisting>
...
...
@@ -10305,33 +10305,33 @@ postgres=# select pg_start_backup('label_goes_here');
<para>
<function>pg_stop_backup</> removes the label file created by
<function>pg_start_backup</>, and instead creates a backup history file in
the
x
log archive area. The history file includes the label given to
<function>pg_start_backup</>, the starting and ending
x
log locations for
the
transaction
log archive area. The history file includes the label given to
<function>pg_start_backup</>, the starting and ending
transaction
log locations for
the backup, and the starting and ending times of the backup. The return
value is the backup's ending
x
log location (which again may be of little
interest). After noting the ending location, the current
x
log insertion
point is automatically advanced to the next
x
log file, so that the
ending
x
log file can be archived immediately to complete the backup.
value is the backup's ending
transaction
log location (which again may be of little
interest). After noting the ending location, the current
transaction
log insertion
point is automatically advanced to the next
transaction
log file, so that the
ending
transaction
log file can be archived immediately to complete the backup.
</para>
<para>
<function>pg_switch_xlog</> moves to the next
x
log file, allowing the
<function>pg_switch_xlog</> moves to the next
transaction
log file, allowing the
current file to be archived (assuming you are using continuous archiving).
The result is the ending
xlog location within the just-completed x
log file.
If there has been no
xlog activity since the last x
log switch,
The result is the ending
transaction log location within the just-completed transaction
log file.
If there has been no
transaction log activity since the last transaction
log switch,
<function>pg_switch_xlog</> does nothing and returns the end location
of the previous
x
log file.
of the previous
transaction
log file.
</para>
<para>
<function>pg_current_xlog_location</> displays the current
x
log write
<function>pg_current_xlog_location</> displays the current
transaction
log write
location in the same format used by the above functions. Similarly
<function>pg_current_xlog_insert_location</> displays the current
x
log
insertion point. The insertion point is the <quote>logical</> end of
x
log
<function>pg_current_xlog_insert_location</> displays the current
transaction
log
insertion point. The insertion point is the <quote>logical</> end of
transaction
log
at any instant, while the write location is the end of what has actually
been written out from the server's internal buffers. The write location
is the end of what can be examined from outside the server, and is usually
what you want if you are interested in archiving partially-complete
x
log
what you want if you are interested in archiving partially-complete
transaction
log
files. The insertion point is made available primarily for server
debugging purposes. These are both read-only operations and do not
require superuser permissions.
...
...
@@ -10339,7 +10339,7 @@ postgres=# select pg_start_backup('label_goes_here');
<para>
You can use <function>pg_xlogfile_name_offset</> to extract the
corresponding
xlog file
name and byte offset from the results of any of the
corresponding
transaction log file
name and byte offset from the results of any of the
above functions. For example:
<programlisting>
postgres=# select * from pg_xlogfile_name_offset(pg_stop_backup());
...
...
@@ -10348,10 +10348,10 @@ postgres=# select * from pg_xlogfile_name_offset(pg_stop_backup());
00000001000000000000000D | 4039624
(1 row)
</programlisting>
Similarly, <function>pg_xlogfile_name</> extracts just the
xlog file
name.
When the given
xlog location is exactly at an x
log file boundary, both
these functions return the name of the preceding
x
log file.
This is usually the desired behavior for managing
x
log archiving
Similarly, <function>pg_xlogfile_name</> extracts just the
transaction log file
name.
When the given
transction log location is exactly at an transaction
log file boundary, both
these functions return the name of the preceding
transaction
log file.
This is usually the desired behavior for managing
transaction
log archiving
behavior, since the preceding file is the last one that currently
needs to be archived.
</para>
...
...
@@ -10574,7 +10574,7 @@ postgres=# select * from pg_xlogfile_name_offset(pg_stop_backup());
<function>pg_stat_file</> returns a record containing the file
size, last accessed time stamp, last modified time stamp,
last file status change time stamp (Unix platforms only),
file creation timestamp (Windows only), and a <type>boolean</type>
file creation time
stamp (Windows only), and a <type>boolean</type>
indicating if it is a directory. Typical usages include:
<programlisting>
SELECT * FROM pg_stat_file('filename');
...
...
doc/src/sgml/gist.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/gist.sgml,v 1.2
6 2006/03/10 19:10:48 momjian
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/gist.sgml,v 1.2
7 2006/10/23 18:10:31 petere
Exp $ -->
<chapter id="GiST">
<title>GiST Indexes</title>
...
...
@@ -199,7 +199,7 @@
<varlistentry>
<term>cube</term>
<listitem>
<para>Indexing for multi
-
dimensional cubes</para>
<para>Indexing for multidimensional cubes</para>
</listitem>
</varlistentry>
...
...
doc/src/sgml/history.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/history.sgml,v 1.2
8 2006/03/10 19:10:48 momjian
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/history.sgml,v 1.2
9 2006/10/23 18:10:31 petere
Exp $ -->
<sect1 id="history">
<title>A Brief History of <productname>PostgreSQL</productname></title>
...
...
@@ -31,7 +31,7 @@
Office (<acronym>ARO</acronym>), the National Science Foundation
(<acronym>NSF</acronym>), and ESL, Inc. The implementation of
<productname>POSTGRES</productname> began in 1986. The initial
concepts for the system were presented in <xref linkend="STON86">
concepts for the system were presented in <xref linkend="STON86">
,
and the definition of the initial data model appeared in <xref
linkend="ROWE87">. The design of the rule system at that time was
described in <xref linkend="STON87a">. The rationale and
...
...
@@ -47,7 +47,7 @@
<xref linkend="STON90a">, was released to a few external users in
June 1989. In response to a critique of the first rule system
(<xref linkend="STON89">), the rule system was redesigned (<xref
linkend="STON90b">) and Version 2 was released in June 1990 with
linkend="STON90b">)
,
and Version 2 was released in June 1990 with
the new rule system. Version 3 appeared in 1991 and added support
for multiple storage managers, an improved query executor, and a
rewritten rule system. For the most part, subsequent releases
...
...
doc/src/sgml/indices.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/indices.sgml,v 1.6
4 2006/09/18 12:11:36 teodor
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/indices.sgml,v 1.6
5 2006/10/23 18:10:31 petere
Exp $ -->
<chapter id="indexes">
<title id="indexes-title">Indexes</title>
...
...
@@ -254,7 +254,7 @@ CREATE INDEX <replaceable>name</replaceable> ON <replaceable>table</replaceable>
indexing strategy.
As an example, the standard distribution of
<productname>PostgreSQL</productname> includes GIN operator classes
for one-dimen
t
ional arrays, which support indexed
for one-dimen
s
ional arrays, which support indexed
queries using these operators:
<simplelist>
...
...
@@ -267,7 +267,7 @@ CREATE INDEX <replaceable>name</replaceable> ON <replaceable>table</replaceable>
(See <xref linkend="functions-array"> for the meaning of
these operators.)
Other GIN operator classes are available in the <literal>contrib</>
tsearch2 and intarray
modules. For more information see <xref linkend="GIN">.
<literal>tsearch2</literal> and <literal>intarray</literal>
modules. For more information see <xref linkend="GIN">.
</para>
</sect1>
...
...
doc/src/sgml/information_schema.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/information_schema.sgml,v 1.2
8 2006/10/03 01:03:53 momjian
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/information_schema.sgml,v 1.2
9 2006/10/23 18:10:31 petere
Exp $ -->
<chapter id="information-schema">
<title>The Information Schema</title>
...
...
@@ -2313,7 +2313,7 @@ ORDER BY c.ordinal_position;
<entry>
<literal>IN</literal> for input parameter,
<literal>OUT</literal> for output parameter,
and <literal>INOUT</literal> for input/ouput parameter.
and <literal>INOUT</literal> for input/ou
t
put parameter.
</entry>
</row>
...
...
doc/src/sgml/libpq.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/libpq.sgml,v 1.21
8 2006/10/21 18:25:01 momjian
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/libpq.sgml,v 1.21
9 2006/10/23 18:10:31 petere
Exp $ -->
<chapter id="libpq">
<title><application>libpq</application> - C Library</title>
...
...
@@ -3805,8 +3805,9 @@ It is good practice not to send the original cleartext password in such a
command, because it might be exposed in command logs, activity displays,
and so on. Instead, use this function to convert the password to encrypted
form before it is sent. The arguments are the cleartext password, and the SQL
name of the user it is for. The return value is a malloc'd string, or NULL if
out-of-memory. The caller may assume the string doesn't contain any special
name of the user it is for. The return value is a string allocated by
<function>malloc</function>, or <symbol>NULL</symbol> if out of memory.
The caller may assume the string doesn't contain any special
characters that would require escaping. Use <function>PQfreemem</> to free
the result when done with it.
</para>
...
...
@@ -4232,7 +4233,7 @@ current connection parameters will be used. (Therefore, put more-specific
entries first when you are using wildcards.)
If an entry needs to contain <literal>:</literal> or
<literal>\</literal>, escape this character with <literal>\</literal>.
A hostname of <literal>localhost</> matches both TCP (hostname
A host
name of <literal>localhost</> matches both TCP (hostname
<literal>localhost</>) and Unix domain socket (<literal>pghost</> empty or the
default socket directory) connections coming from the local machine.
</para>
...
...
@@ -4380,7 +4381,7 @@ ldap://ldap.mycompany.com/dc=mycompany,dc=com?uniqueMember?one?(cn=mydatabase)
fail if the server does not present a certificate; therefore, to
use this feature the server must also have a <filename>root.crt</> file.
Certificate Revocation List (CRL) entries are also checked if the file
<filename>~/.postgresql/root.crl</filename> exists (
%APPDATA%\postgresql\root.crl
<filename>~/.postgresql/root.crl</filename> exists (
<filename>%APPDATA%\postgresql\root.crl</filename>
on Microsoft Windows).
</para>
...
...
@@ -4430,7 +4431,7 @@ int PQisthreadsafe();
</para>
<para>
Returns 1 if the <application>libpq</application> is thead-safe and
Returns 1 if the <application>libpq</application> is th
r
ead-safe and
0 if it is not.
</para>
</listitem>
...
...
doc/src/sgml/lobj.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/lobj.sgml,v 1.4
1 2006/09/16 00:30:14 momjian
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/lobj.sgml,v 1.4
2 2006/10/23 18:10:31 petere
Exp $ -->
<chapter id="largeObjects">
<title id="largeObjects-title">Large Objects</title>
...
...
@@ -95,7 +95,7 @@ Oid lo_creat(PGconn *conn, int mode);
<indexterm><primary>lo_creat</></>
creates a new large object.
The return value is the OID that was assigned to the new large object,
or
InvalidOid
(zero) on failure.
or
<symbol>InvalidOid</symbol>
(zero) on failure.
<replaceable class="parameter">mode</replaceable> is unused and
ignored as of <productname>PostgreSQL</productname> 8.1; however, for
...
...
@@ -123,16 +123,16 @@ Oid lo_create(PGconn *conn, Oid lobjId);
specified by <replaceable class="parameter">lobjId</replaceable>;
if so, failure occurs if that OID is already in use for some large
object. If <replaceable class="parameter">lobjId</replaceable>
is
InvalidOid
(zero) then <function>lo_create</> assigns an unused
is
<symbol>InvalidOid</symbol>
(zero) then <function>lo_create</> assigns an unused
OID (this is the same behavior as <function>lo_creat</>).
The return value is the OID that was assigned to the new large object,
or
InvalidOid
(zero) on failure.
or
<symbol>InvalidOid</symbol>
(zero) on failure.
</para>
<para>
<function>lo_create</> is new as of <productname>PostgreSQL</productname>
8.1; if this function is run against an older server version, it will
fail and return
InvalidOid
.
fail and return
<symbol>InvalidOid</symbol>
.
</para>
<para>
...
...
@@ -156,9 +156,9 @@ Oid lo_import(PGconn *conn, const char *filename);
specifies the operating system name of
the file to be imported as a large object.
The return value is the OID that was assigned to the new large object,
or
InvalidOid
(zero) on failure.
or
<symbol>InvalidOid</symbol>
(zero) on failure.
Note that the file is read by the client interface library, not by
the server; so it must exist in the client filesystem and be readable
the server; so it must exist in the client file
system and be readable
by the client application.
</para>
</sect2>
...
...
doc/src/sgml/maintenance.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/maintenance.sgml,v 1.6
2 2006/09/16 00:30:14 momjian
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/maintenance.sgml,v 1.6
3 2006/10/23 18:10:31 petere
Exp $ -->
<chapter id="maintenance">
<title>Routine Database Maintenance Tasks</title>
...
...
@@ -90,9 +90,10 @@
<para>
The standard form of <command>VACUUM</> can run in parallel with production
database operations. Commands such as SELECTs, INSERTs, UPDATEs and DELETEs
database operations. Commands such as <command>SELECT</command>,
<command>INSERT</command>, <command>UPDATE</command>, and <command>DELETE</command>
will continue to function as normal, though you will not be able to modify the
definition of a table with commands such as
ALTER TABLE ADD COLUMN
definition of a table with commands such as
<command>ALTER TABLE ADD COLUMN</command>
while it is being vacuumed.
Beginning in <productname>PostgreSQL</productname> 8.0, there are
configuration parameters that can be adjusted to further reduce the
...
...
doc/src/sgml/plperl.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/plperl.sgml,v 2.5
7 2006/09/16 00:30:14 momjian
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/plperl.sgml,v 2.5
8 2006/10/23 18:10:31 petere
Exp $ -->
<chapter id="plperl">
<title>PL/Perl - Perl Procedural Language</title>
...
...
@@ -21,7 +21,7 @@
within stored functions, of the manyfold <quote>string
munging</quote> operators and functions available for Perl. Parsing
complex strings may be be easier using Perl than it is with the
string functions and control structures provided in PL/pg
sql
.</para>
string functions and control structures provided in PL/pg
SQL
.</para>
<para>
To install PL/Perl in a particular database, use
...
...
@@ -188,7 +188,7 @@ SELECT * FROM perl_row();
</programlisting>
Any columns in the declared result data type that are not present in the
hash will be returned as
NULL
s.
hash will be returned as
null value
s.
</para>
<para>
...
...
doc/src/sgml/plpgsql.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/plpgsql.sgml,v 1.10
0 2006/09/16 00:30:14 momjian
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/plpgsql.sgml,v 1.10
1 2006/10/23 18:10:31 petere
Exp $ -->
<chapter id="plpgsql">
<title><application>PL/pgSQL</application> - <acronym>SQL</acronym> Procedural Language</title>
...
...
@@ -176,7 +176,7 @@ $$ LANGUAGE plpgsql;
client and server </para></listitem>
<listitem><para> Intermediate results that the client does not
need do not need to be marshal
l
ed or transferred between server
need do not need to be marshaled or transferred between server
and client </para></listitem>
<listitem><para> There is no need for additional rounds of query
...
...
@@ -1066,7 +1066,7 @@ tax := subtotal * 0.06;
Any <application>PL/pgSQL</application> variable name appearing
in the query text is replaced by a parameter symbol, and then the
current value of the variable is provided as the parameter value
at runtime. This allows the same textual query to do different
at run
time. This allows the same textual query to do different
things in different calls of the function.
</para>
...
...
@@ -1182,7 +1182,7 @@ DELETE ... RETURNING <replaceable>expressions</replaceable> INTO <optional>STRIC
substituted into the rest of the query as usual.
This works for <command>SELECT</>,
<command>INSERT</>/<command>UPDATE</>/<command>DELETE</> with
<literal>RETURNING</>, and utility commands that return rowset
<literal>RETURNING</>, and utility commands that return row
-
set
results (such as <command>EXPLAIN</>).
Except for the <literal>INTO</> clause, the SQL command is the same
as it would be written outside <application>PL/pgSQL</application>.
...
...
@@ -2738,7 +2738,7 @@ RAISE EXCEPTION 'Nonexistent ID --> %', user_id;
<para>
<command>RAISE EXCEPTION</command> presently always generates
the same
SQLSTATE
code, <literal>P0001</>, no matter what message
the same
<varname>SQLSTATE</varname>
code, <literal>P0001</>, no matter what message
it is invoked with. It is possible to trap this exception with
<literal>EXCEPTION ... WHEN RAISE_EXCEPTION THEN ...</> but there
is no way to tell one <command>RAISE</> from another.
...
...
doc/src/sgml/plpython.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/plpython.sgml,v 1.3
5 2006/10/21 18:33:05 tgl
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/plpython.sgml,v 1.3
6 2006/10/23 18:10:31 petere
Exp $ -->
<chapter id="plpython">
<title>PL/Python - Python Procedural Language</title>
...
...
@@ -65,7 +65,7 @@ $$ LANGUAGE plpythonu;
<varname>args[]</varname>; named arguments are also passed as ordinary
variables to the Python script. The result is returned from the Python code
in the usual way, with <literal>return</literal> or
<literal>yield</literal> (in case of a resultset statement).
<literal>yield</literal> (in case of a result
-
set statement).
</para>
<para>
...
...
doc/src/sgml/queries.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/queries.sgml,v 1.3
7 2006/10/22 03:03:41 tgl
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/queries.sgml,v 1.3
8 2006/10/23 18:10:31 petere
Exp $ -->
<chapter id="queries">
<title>Queries</title>
...
...
@@ -1367,7 +1367,7 @@ VALUES ( <replaceable class="PARAMETER">expression</replaceable> [, ...] ) [, ..
Each parenthesized list of expressions generates a row in the table.
The lists must all have the same number of elements (i.e., the number
of columns in the table), and corresponding entries in each list must
have compatible data
types. The actual data
type assigned to each column
have compatible data
types. The actual data
type assigned to each column
of the result is determined using the same rules as for <literal>UNION</>
(see <xref linkend="typeconv-union-case">).
</para>
...
...
doc/src/sgml/ref/alter_table.sgml
View file @
0f763503
<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.9
1 2006/10/13 21:43:18 tgl
Exp $
$PostgreSQL: pgsql/doc/src/sgml/ref/alter_table.sgml,v 1.9
2 2006/10/23 18:10:32 petere
Exp $
PostgreSQL documentation
-->
...
...
@@ -740,7 +740,7 @@ ALTER TABLE foo
<para>
The same, when the column has a default expression that won't automatically
cast to the new datatype:
cast to the new data
type:
<programlisting>
ALTER TABLE foo
ALTER COLUMN foo_timestamp DROP DEFAULT,
...
...
doc/src/sgml/ref/comment.sgml
View file @
0f763503
<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/comment.sgml,v 1.3
2 2006/09/16 00:30:17 momjian
Exp $
$PostgreSQL: pgsql/doc/src/sgml/ref/comment.sgml,v 1.3
3 2006/10/23 18:10:32 petere
Exp $
PostgreSQL documentation
-->
...
...
@@ -206,7 +206,7 @@ COMMENT ON
connected to a database can see all the comments for objects in
that database (although only superusers can change comments for
objects that they don't own). For shared objects such as
databases, roles, and tablespaces comments are stored glo
ab
lly
databases, roles, and tablespaces comments are stored glo
ba
lly
and any user connected to any database can see all the comments
for shared objects. Therefore, don't put security-critical
information in comments.
...
...
doc/src/sgml/ref/create_trigger.sgml
View file @
0f763503
<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/create_trigger.sgml,v 1.4
4 2006/09/16 00:30:17 momjian
Exp $
$PostgreSQL: pgsql/doc/src/sgml/ref/create_trigger.sgml,v 1.4
5 2006/10/23 18:10:32 petere
Exp $
PostgreSQL documentation
-->
...
...
@@ -258,7 +258,7 @@ CREATE TRIGGER <replaceable class="PARAMETER">name</replaceable> { BEFORE | AFTE
DELETE</literal> to always fire before the delete action, even a cascading
one. This is considered more consistent. There is also unpredictable
behavior when <literal>BEFORE</literal> triggers modify rows that are later
to be modified by referential actions. This can lead to contraint violations
to be modified by referential actions. This can lead to con
s
traint violations
or stored data that does not honor the referential constraint.
</para>
...
...
doc/src/sgml/ref/drop_type.sgml
View file @
0f763503
<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_type.sgml,v 1.2
8 2006/09/16 00:30:18 momjian
Exp $
$PostgreSQL: pgsql/doc/src/sgml/ref/drop_type.sgml,v 1.2
9 2006/10/23 18:10:32 petere
Exp $
PostgreSQL documentation
-->
...
...
@@ -94,7 +94,7 @@ DROP TYPE box;
<para>
This command is similar to the corresponding command in the SQL
standard, a
a
part from the <literal>IF EXISTS</>
standard, apart from the <literal>IF EXISTS</>
option, which is a <productname>PostgreSQL</> extension.
But note that the <command>CREATE TYPE</command> command
and the data type extension mechanisms in
...
...
doc/src/sgml/ref/insert.sgml
View file @
0f763503
<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/insert.sgml,v 1.3
3 2006/09/18 19:54:01 tgl
Exp $
$PostgreSQL: pgsql/doc/src/sgml/ref/insert.sgml,v 1.3
4 2006/10/23 18:10:32 petere
Exp $
PostgreSQL documentation
-->
...
...
@@ -234,7 +234,7 @@ INSERT INTO films DEFAULT VALUES;
</para>
<para>
To insert multiple rows using the multi
-
row <command>VALUES</> syntax:
To insert multiple rows using the multirow <command>VALUES</> syntax:
<programlisting>
INSERT INTO films (code, title, did, date_prod, kind) VALUES
...
...
doc/src/sgml/ref/pg_config-ref.sgml
View file @
0f763503
<
!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_config-ref.sgml,v 1.2
4 2006/09/16 00:30:19 momjian
Exp $ -->
<
!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_config-ref.sgml,v 1.2
5 2006/10/23 18:10:32 petere
Exp $ -->
<
refentry
id
=
"app-pgconfig"
>
<
refmeta
>
...
...
@@ -177,7 +177,7 @@
<
term
><
option
>--
cc
</
option
></>
<
listitem
>
<
para
>
Print
the
value
of
the
CC
macro
that
was
used
for
building
Print
the
value
of
the
<
varname
>
CC
</
varname
>
variable
that
was
used
for
building
<
productname
>
PostgreSQL
</>.
This
shows
the
C
compiler
used
.
</
para
>
</
listitem
>
...
...
@@ -187,7 +187,7 @@
<
term
><
option
>--
cppflags
</
option
></>
<
listitem
>
<
para
>
Print
the
value
of
the
CPPFLAGS
macro
that
was
used
for
building
Print
the
value
of
the
<
varname
>
CPPFLAGS
</
varname
>
variable
that
was
used
for
building
<
productname
>
PostgreSQL
</>.
This
shows
C
compiler
switches
needed
at
preprocessing
time
(
typically
,
<
literal
>-
I
</>
switches
).
</
para
>
...
...
@@ -198,7 +198,7 @@
<
term
><
option
>--
cflags
</
option
></>
<
listitem
>
<
para
>
Print
the
value
of
the
CFLAGS
macro
that
was
used
for
building
Print
the
value
of
the
<
varname
>
CFLAGS
</
varname
>
variable
that
was
used
for
building
<
productname
>
PostgreSQL
</>.
This
shows
C
compiler
switches
.
</
para
>
</
listitem
>
...
...
@@ -208,7 +208,7 @@
<
term
><
option
>--
cflags_sl
</
option
></>
<
listitem
>
<
para
>
Print
the
value
of
the
CFLAGS_SL
macro
that
was
used
for
building
Print
the
value
of
the
<
varname
>
CFLAGS_SL
</
varname
>
variable
that
was
used
for
building
<
productname
>
PostgreSQL
</>.
This
shows
extra
C
compiler
switches
used
for
building
shared
libraries
.
</
para
>
...
...
@@ -219,7 +219,7 @@
<
term
><
option
>--
ldflags
</
option
></>
<
listitem
>
<
para
>
Print
the
value
of
the
LDFLAGS
macro
that
was
used
for
building
Print
the
value
of
the
<
varname
>
LDFLAGS
</
varname
>
variable
that
was
used
for
building
<
productname
>
PostgreSQL
</>.
This
shows
linker
switches
.
</
para
>
</
listitem
>
...
...
@@ -229,7 +229,7 @@
<
term
><
option
>--
ldflags_sl
</
option
></>
<
listitem
>
<
para
>
Print
the
value
of
the
LDFLAGS_SL
macro
that
was
used
for
building
Print
the
value
of
the
<
varname
>
LDFLAGS_SL
</
varname
>
variable
that
was
used
for
building
<
productname
>
PostgreSQL
</>.
This
shows
linker
switches
used
for
building
shared
libraries
.
</
para
>
...
...
@@ -240,7 +240,7 @@
<
term
><
option
>--
libs
</
option
></>
<
listitem
>
<
para
>
Print
the
value
of
the
LIBS
macro
that
was
used
for
building
Print
the
value
of
the
<
varname
>
LIBS
</
varname
>
variable
that
was
used
for
building
<
productname
>
PostgreSQL
</>.
This
normally
contains
<
literal
>-
l
</>
switches
for
external
libraries
linked
into
<
productname
>
PostgreSQL
</>.
</
para
>
...
...
doc/src/sgml/ref/pg_dump.sgml
View file @
0f763503
<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.9
0 2006/10/09 23:36:58 tgl
Exp $
$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.9
1 2006/10/23 18:10:32 petere
Exp $
PostgreSQL documentation
-->
...
...
@@ -748,7 +748,7 @@ CREATE DATABASE foo WITH TEMPLATE template0;
</para>
<para>
Because <application>pg_dump</application> is used to tranfer data
Because <application>pg_dump</application> is used to tran
s
fer data
to newer versions of <productname>PostgreSQL</>, the output of
<application>pg_dump</application> can be loaded into
newer <productname>PostgreSQL</> databases. It also can read older
...
...
doc/src/sgml/ref/psql-ref.sgml
View file @
0f763503
<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.17
1 2006/10/09 23:31:29 tgl
Exp $
$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.17
2 2006/10/23 18:10:32 petere
Exp $
PostgreSQL documentation
-->
...
...
@@ -2772,7 +2772,7 @@ Field separator is "oo".
<listitem>
<para>
Set the console font to <
quote
>Lucida Console</>, because the
Set the console font to <
literal
>Lucida Console</>, because the
raster font does not work with the ANSI code page.
</para>
</listitem>
...
...
doc/src/sgml/ref/values.sgml
View file @
0f763503
<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/values.sgml,v 1.
1 2006/09/18 19:54:01 tgl
Exp $
$PostgreSQL: pgsql/doc/src/sgml/ref/values.sgml,v 1.
2 2006/10/23 18:10:32 petere
Exp $
PostgreSQL documentation
-->
...
...
@@ -202,9 +202,9 @@ UPDATE employees SET salary = salary * v.increase
<para>
When <command>VALUES</> is used in <command>INSERT</>, the values are all
automatically coerced to the datatype of the corresponding destination
automatically coerced to the data
type of the corresponding destination
column. When it's used in other contexts, it may be necessary to specify
the correct datatype. If the entries are all quoted literal constants,
the correct data
type. If the entries are all quoted literal constants,
coercing the first is sufficient to determine the assumed type for all:
<programlisting>
...
...
doc/src/sgml/release.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.4
79 2006/10/21 18:41:53 tgl
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.4
80 2006/10/23 18:10:31 petere
Exp $ -->
<!--
Typical markup:
...
...
@@ -55,7 +55,7 @@ links to the main documentation.
<listitem>
<para>
Query language enhancements including <command>INSERT/UPDATE/DELETE
RETURNING</command>, multi
-
row <literal>VALUES</literal> lists, and
RETURNING</command>, multirow <literal>VALUES</literal> lists, and
optional target-table alias in
<command>UPDATE</>/<command>DELETE</command>
</para>
...
...
@@ -147,7 +147,7 @@ links to the main documentation.
<listitem>
<para>
Many
/contrib
improvements
Many
<filename>contrib/</filename>
improvements
</para>
</listitem>
...
...
@@ -192,7 +192,7 @@ links to the main documentation.
constructor syntax</link> (<literal>ROW(...)</>) so that
list elements <literal>foo.*</> will be expanded to a list
of their member fields, rather than creating a nested
rowtype field as formerly (Tom)
row
type field as formerly (Tom)
</para>
<para>
...
...
@@ -298,13 +298,13 @@ links to the main documentation.
<listitem>
<para>
Deprecate use of <application>postmaster</> symlink (Peter)
Deprecate use of <application>postmaster</> sym
bolic
link (Peter)
</para>
<para>
<application>postmaster</> and <application>postgres</>
commands now act identically, with the behavior determined
by
switches. The <application>postmaster</> sym
link is
by
command-line options. The <application>postmaster</> symbolic
link is
kept for compatibility, but is not really needed.
</para>
</listitem>
...
...
@@ -365,7 +365,7 @@ links to the main documentation.
<listitem>
<para>
Improve cost estimation for nestloop index scans (Tom)
Improve cost estimation for nest
ed-
loop index scans (Tom)
</para>
<para>
...
...
@@ -400,7 +400,7 @@ links to the main documentation.
<listitem>
<para>
In
/contrib/xml2
, rename <function>xml_valid()</> to
In
<filename>contrib/xml2/<filename>
, rename <function>xml_valid()</> to
<function>xml_is_well_formed()</> (Tom)
</para>
...
...
@@ -413,15 +413,16 @@ links to the main documentation.
<listitem>
<para>
Remove
/contrib/ora2pg
, now at <ulink
Remove
<filename>contrib/ora2pg/<filename>
, now at <ulink
url="http://www.samse.fr/GPL/ora2pg"></ulink>
</para>
</listitem>
<listitem>
<para>
Remove contrib modules that have been migrated to pgfoundry:
adddepend, dbase, dbmirror, fulltextindex, mac, userlock
Remove contrib modules that have been migrated to PgFoundry:
<filename>adddepend</>, <filename>dbase</>, <filename>dbmirror</>,
<filename>fulltextindex</>, <filename>mac</>, <filename>userlock</>
</para>
</listitem>
...
...
@@ -506,7 +507,7 @@ links to the main documentation.
<para>
This leaves extra free space in each table or index page,
allowing improved performance as the database grows. This
is particularly valuable to maintain
<command>CLUSTER</>
ing.
is particularly valuable to maintain
cluster
ing.
</para>
</listitem>
...
...
@@ -600,7 +601,7 @@ links to the main documentation.
<listitem>
<para>
Speed up vacuuming of
bt
ree indexes (Heikki Linnakangas,
Speed up vacuuming of
B-T
ree indexes (Heikki Linnakangas,
Tom)
</para>
</listitem>
...
...
@@ -621,7 +622,7 @@ links to the main documentation.
<listitem>
<para>
Remove dead index entries before
bt
ree page split (Junji
Remove dead index entries before
B-T
ree page split (Junji
Teramoto)
</para>
</listitem>
...
...
@@ -636,16 +637,16 @@ links to the main documentation.
<listitem>
<para>
Allow a forced switch to a new
x
log file (Simon, Tom)
Allow a forced switch to a new
transaction
log file (Simon, Tom)
</para>
<para>
This is valuable for keeping warm standby slave servers
in sync with the master.
x
log file switching now also happens
in sync with the master.
Transaction
log file switching now also happens
automatically during <link
linkend="functions-admin"><function>pg_stop_backup()</></link>.
This ensures that all
x
log files needed for recovery can be archived immediately.
transaction
log files needed for recovery can be archived immediately.
</para>
</listitem>
...
...
@@ -655,7 +656,7 @@ links to the main documentation.
</para>
<para>
Add functions for interrogating the current
x
log insertion
Add functions for interrogating the current
transaction
log insertion
point and determining <acronym>WAL</> filenames from the
hex <acronym>WAL</> locations displayed by <link
linkend="functions-admin"><function>pg_stop_backup()</></link>
...
...
@@ -681,7 +682,7 @@ links to the main documentation.
<para>
Add <link
linkend="guc-archive-timeout"><varname>archive_timeout</></link>
to force
x
log file switches at a given interval (Simon)
to force
transaction
log file switches at a given interval (Simon)
</para>
<para>
...
...
@@ -2653,7 +2654,7 @@ MIN/MAX optimization (Tom)</para></listitem>
<listitem><para>Fix crash from using and modifying a plpgsql function in the
same transaction</para></listitem>
<listitem><para>Fix WAL replay for case where a
bt
ree index has been
<listitem><para>Fix WAL replay for case where a
B-T
ree index has been
truncated</para></listitem>
<listitem><para>Fix <literal>SIMILAR TO</> for patterns involving
...
...
@@ -3776,7 +3777,7 @@ psql -t -f fixseq.sql db1 | psql -e db1
</para>
<para>
This prevents a large number of <filename>*.backup</> files from
existing in <filename>
/pg_xlog
</>.
existing in <filename>
pg_xlog/
</>.
</para>
</listitem>
...
...
doc/src/sgml/sources.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/sources.sgml,v 2.
19 2006/09/16 00:30:15 momjian
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/sources.sgml,v 2.
20 2006/10/23 18:10:32 petere
Exp $ -->
<chapter id="source">
<title>PostgreSQL Coding Conventions</title>
...
...
@@ -219,7 +219,7 @@ elog(level, "format string", ...);
<programlisting>
ereport(level, (errmsg_internal("format string", ...)));
</programlisting>
Notice that the SQLSTATE errcode is always defaulted, and the message
Notice that the SQLSTATE err
or
code is always defaulted, and the message
string is not included in the internationalization message dictionary.
Therefore, <function>elog</> should be used only for internal errors and
low-level debug logging. Any message that is likely to be of interest to
...
...
doc/src/sgml/spi.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/spi.sgml,v 1.4
8 2006/09/10 20:56:42 tgl
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/spi.sgml,v 1.4
9 2006/10/23 18:10:32 petere
Exp $ -->
<chapter id="spi">
<title>Server Programming Interface</title>
...
...
@@ -369,7 +369,7 @@ SPI_execute("INSERT INTO foo SELECT * FROM bar", false, 5);
then you may use the
global pointer <literal>SPITupleTable *SPI_tuptable</literal> to
access the result rows. Some utility commands (such as
<command>EXPLAIN</>) also return rowsets, and <literal>SPI_tuptable</>
<command>EXPLAIN</>) also return row
sets, and <literal>SPI_tuptable</>
will contain the result in these cases too.
</para>
...
...
doc/src/sgml/wal.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/wal.sgml,v 1.4
0 2006/09/16 00:30:16 momjian
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/wal.sgml,v 1.4
1 2006/10/23 18:10:32 petere
Exp $ -->
<chapter id="wal">
<title>Reliability and the Write-Ahead Log</title>
...
...
@@ -85,8 +85,8 @@
permanent storage <emphasis>before</> modifying the actual page on
disk. By doing this, during crash recovery <productname>PostgreSQL</> can
restore partially-written pages. If you have a battery-backed disk
controller or file-system software
(e.g., Reiser4) that prevents partial
page writes
, you can turn off this page imaging by using the
controller or file-system software
that prevents partial page writes
(e.g., ReiserFS 4)
, you can turn off this page imaging by using the
<xref linkend="guc-full-page-writes"> parameter.
</para>
</sect1>
...
...
doc/src/sgml/xindex.sgml
View file @
0f763503
<!-- $PostgreSQL: pgsql/doc/src/sgml/xindex.sgml,v 1.5
1 2006/09/21 15:09:38 teodor
Exp $ -->
<!-- $PostgreSQL: pgsql/doc/src/sgml/xindex.sgml,v 1.5
2 2006/10/23 18:10:32 petere
Exp $ -->
<sect1 id="xindex">
<title>Interfacing Extensions To Indexes</title>
...
...
@@ -387,7 +387,7 @@
</thead>
<tbody>
<row>
<entry>consistent - determine whether key satifies the
<entry>consistent - determine whether key sati
s
fies the
query qualifier</entry>
<entry>1</entry>
</row>
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment