Skip to content

P
Postgres FD Implementation
Commit daaf999f authored by Bruce Momjian's avatar Bruce Momjian
Browse files
Options

Improvements to Ian Barwick patch.

parent 0896707e
Hide whitespace changes
Inline Side-by-side
Showing with 49 additions and 46 deletions
doc/FAQ
View file @ daaf999f
Frequently Asked Questions (FAQ) for PostgreSQL
Last updated: Sun Oct 13 22:49:56 EDT 2002
Last updated: Sun Oct 13 23:15:09 EDT 2002
Current maintainer: Bruce Momjian (pgman@candle.pha.pa.us)
......@@ -52,7 +52,7 @@
3.6) How do I tune the database engine for better performance?
3.7) What debugging features are available?
3.8) Why do I get "Sorry, too many clients" when trying to connect?
3.9) What are the pg_sorttempNNN.NN files in my database directory?
3.9) What is in the pgsql_tmp directory?
3.10) Why do I need to do a dump and restore to upgrade PostgreSQL
releases?
......@@ -197,8 +197,7 @@
distribution or the MS Windows FAQ at
http://www.PostgreSQL.org/docs/faq-mswin.html.
A native port to some Microsoft platforms is currently being worked
upon.
A native port to MS Win NT/2000/XP is currently being worked on.
1.5) Where can I get PostgreSQL?
......@@ -368,7 +367,7 @@
1.15) How can I financially assist PostgreSQL?
PostgreSQL has had a first-class infrastructure since we started in
1994. This is all thanks to Marc Fournier, who has created and managed
1996. This is all thanks to Marc Fournier, who has created and managed
this infrastructure over the years.
Quality infrastructure is very important to an open-source project. It
......@@ -419,9 +418,9 @@
2.3) Does PostgreSQL have a graphical user interface? A report generator?
An embedded query language interface?
We have a nice graphical user interface called PgAccess, which is
shipped as part of the distribution. PgAccess also has a report
generator. The Web page is http://www.pgaccess.org/.
We have a nice graphical user interface called PgAccess which can also
be used as a report generator. The Web page is
http://www.pgaccess.org/.
We also include ecpg, which is an embedded SQL query language
interface for C.
......@@ -433,7 +432,7 @@
* C++ (libpq++)
* Embedded C (ecpg)
* Java (jdbc)
* Perl (DBD::Pg)
* Perl (DBD::Pg and perl5)
* ODBC (odbc)
* Python (PyGreSQL)
* TCL (libpgtcl)
......@@ -441,7 +440,8 @@
* PHP ('pg_' functions, Pear::DB)
Additional interfaces are available at
http://www.PostgreSQL.org/interfaces.html.
http://www.PostgreSQL.org/interfaces.html and
http://gborg.PostgreSQL.org.
_________________________________________________________________
Administrative Questions
......@@ -596,16 +596,16 @@
was 64, and changing it required a rebuild after altering the
MaxBackendId constant in include/storage/sinvaladt.h.
3.9) What are the pg_tempNNN.NN files in my database directory?
3.9) What are the pgsql_tmp directory?
They are temporary files generated by the query executor. For example,
if a sort needs to be done to satisfy an ORDER BY, and the sort
requires more space than the backend's -S parameter allows, then
temporary files are created to hold the extra data.
The temporary files should be deleted automatically, but might not if
a backend crashes during a sort. If you have no backends running at
the time, it is safe to delete the pg_tempNNN.NN files.
The temporary files are usually deleted automatically, but might
remain if a backend crashes during a sort. A stop and restart of the
postmaster will remove files from those directories.
3.10) Why do I need to do a dump and restore to upgrade between major
PostgreSQL releases?
......@@ -649,8 +649,8 @@
4.4) How do you remove a column from a table?
Prior to version 7.3, ALTER TABLE DROP COLUMN is not supported. You
can do this instead:
This functionality was added in release 7.3 with ALTER TABLE DROP
COLUMN. In earlier versions, you can do this:
BEGIN;
LOCK TABLE old_table;
SELECT ... -- select all columns but the one you want to remove
......@@ -815,11 +815,11 @@
Case-insensitive equality comparisons are normally expressed as:
SELECT *
FROM tab
WHERE LOWER(col) = 'abc';
WHERE lower(col) = 'abc';
This will not use an standard index. However, if you create a
functional index, it will be used:
CREATE INDEX tabindex ON tab (LOWER(col));
CREATE INDEX tabindex ON tab (lower(col));
4.13) In a query, how do I detect if a field is NULL?
......
doc/src/FAQ/FAQ.html
View file @ daaf999f
......@@ -14,7 +14,7 @@
alink="#0000ff">
<H1>Frequently Asked Questions (FAQ) for PostgreSQL</H1>
<P>Last updated: Sun Oct 13 22:49:56 EDT 2002</P>
<P>Last updated: Sun Oct 13 23:15:09 EDT 2002</P>
<P>Current maintainer: Bruce Momjian (<A href=
"mailto:pgman@candle.pha.pa.us">pgman@candle.pha.pa.us</A>)<BR>
......@@ -78,8 +78,8 @@
<A href="#3.7">3.7</A>) What debugging features are available?<BR>
<A href="#3.8">3.8</A>) Why do I get <I>"Sorry, too many
clients"</I> when trying to connect?<BR>
<A href="#3.9">3.9</A>) What are the <I>pg_sorttempNNN.NN</I>
files in my database directory?<BR>
<A href="#3.9">3.9</A>) What is in the <I>pgsql_tmp</I>
directory?<BR>
<A href="#3.10">3.10</A>) Why do I need to do a dump and restore
to upgrade PostgreSQL releases?<BR>
......@@ -250,10 +250,11 @@
<P>The database server can run on Windows NT and Win2k using
Cygwin, the Cygnus Unix/NT porting library. See
<I>pgsql/doc/FAQ_MSWIN</I> in the distribution or the MS Windows FAQ
at <A href="http://www.PostgreSQL.org/docs/faq-mswin.html">http://www.PostgreSQL.org/docs/faq-mswin.html</A>.</P>
at <A href="http://www.PostgreSQL.org/docs/faq-mswin.html">
http://www.PostgreSQL.org/docs/faq-mswin.html</A>.</P>
<p>A native port to some Microsoft platforms is currently being worked
upon.</p>
<p>A native port to MS Win NT/2000/XP is currently being worked
on.</p>
<H4><A name="1.5">1.5</A>) Where can I get PostgreSQL?</H4>
......@@ -484,7 +485,7 @@
PostgreSQL?</H4>
<P>PostgreSQL has had a first-class infrastructure since we started
in 1994. This is all thanks to Marc Fournier, who has created
in 1996. This is all thanks to Marc Fournier, who has created
and managed this infrastructure over the years.</P>
<P>Quality infrastructure is very important to an open-source
......@@ -545,9 +546,9 @@
interface? A report generator? An embedded query language
interface?</H4>
<P>We have a nice graphical user interface called PgAccess, which is
shipped as part of the distribution. PgAccess also has a report
generator. The Web page is <A href="http://www.pgaccess.org/">http://www.pgaccess.org/</A>.</P>
<P>We have a nice graphical user interface called PgAccess which can
also be used as a report generator. The Web page is
<A href="http://www.pgaccess.org/">http://www.pgaccess.org/</A>.</P>
<P>We also include <I>ecpg</I>, which is an embedded SQL query
language interface for C.</P>
......@@ -565,7 +566,7 @@
<LI>Java (jdbc)</LI>
<LI>Perl (DBD::Pg)</LI>
<LI>Perl (DBD::Pg and perl5)</LI>
<LI>ODBC (odbc)</LI>
......@@ -578,7 +579,9 @@
<LI>PHP ('pg_' functions, Pear::DB)</LI>
</UL>
<P>Additional interfaces are available at
<a href="http://www.PostgreSQL.org/interfaces.html">http://www.PostgreSQL.org/interfaces.html</A>.
<a href="http://www.PostgreSQL.org/interfaces.html">http://www.PostgreSQL.org/interfaces.html</A>
and
<a href="http://gborg.PostgreSQL.org">http://gborg.PostgreSQL.org</A>.
</P>
<HR>
......@@ -765,8 +768,8 @@
the MaxBackendId constant in
<I>include/storage/sinvaladt.h</I>.</P>
<H4><A name="3.9">3.9</A>) What are the <I>pg_tempNNN.NN</I>
files in my database directory?</H4>
<H4><A name="3.9">3.9</A>) What are the <I>pgsql_tmp</I>
directory?</H4>
<P>They are temporary files generated by the query executor. For
example, if a sort needs to be done to satisfy an <SMALL>ORDER
......@@ -774,10 +777,9 @@
<I>-S</I> parameter allows, then temporary files are created to
hold the extra data.</P>
<P>The temporary files should be deleted automatically, but might
not if a backend crashes during a sort. If you have no backends
running at the time, it is safe to delete the pg_tempNNN.NN
files.</P>
<P>The temporary files are usually deleted automatically, but might
remain if a backend crashes during a sort. A stop and restart of the
<I>postmaster</I> will remove files from those directories.</P>
<H4><A name="3.10">3.10</A>) Why do I need to do a dump and restore
to upgrade between major PostgreSQL releases?</H4>
......@@ -790,10 +792,10 @@
data in a generic format that can then be loaded in using the new internal
format.</P>
<p>In releases where the on-disk format does not change, the
<i>pg_upgrade</i> script can be used to upgrade without a dump/restore.
The release notes mention whether <i>pg_upgrade</i> is available for the
release.</p>
<P>In releases where the on-disk format does not change, the
<I>pg_upgrade</I> script can be used to upgrade without a dump/restore.
The release notes mention whether <I>pg_upgrade</I> is available for the
release.</P>
<HR>
......@@ -831,8 +833,9 @@
<H4><A name="4.4">4.4</A>) How do you remove a column from a
table?</H4>
<P>Prior to version 7.3, <SMALL>ALTER TABLE DROP COLUMN</SMALL> is not supported.
You can do this instead:</P>
<P>This functionality was added in release 7.3 with
<SMALL>ALTER TABLE DROP COLUMN</SMALL>. In earlier versions,
you can do this:</P>
<PRE>
BEGIN;
LOCK TABLE old_table;
......@@ -1023,13 +1026,13 @@
<PRE>
SELECT *
FROM tab
WHERE LOWER(col) = 'abc';
WHERE lower(col) = 'abc';
</PRE>
This will not use an standard index. However, if you create a
functional index, it will be used:
<PRE>
CREATE INDEX tabindex ON tab (LOWER(col));
CREATE INDEX tabindex ON tab (lower(col));
</PRE>
<H4><A name="4.13">4.13</A>) In a query, how do I detect if a field
......@@ -1118,7 +1121,7 @@ BYTEA bytea variable-length byte array (null-byte safe)
and your <SMALL>SERIAL</SMALL> column, respectively.
<P>Alternatively, you could retrieve the assigned
<SMALL>SERIAL</SMALL> value with the <I>currval</I>() function
<SMALL>SERIAL</SMALL> value with the <I>currval()</I> function
<I>after</I> it was inserted by default, e.g.,</P>
<PRE>
execute("INSERT INTO person (name) VALUES ('Blaise Pascal')");
......@@ -1135,7 +1138,7 @@ BYTEA bytea variable-length byte array (null-byte safe)
<H4><A name="4.15.3">4.15.3</A>) Don't <I>currval()</I> and
<I>nextval()</I> lead to a race condition with other users?</H4>
<P>No. <i>currval</i>() returns the current value assigned by your
<P>No. <I>currval()</I> returns the current value assigned by your
backend, not by all users.</P>
<H4><A name="4.15.4">4.15.4</A>) Why aren't my sequence numbers
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment