1998-02-28 23:08:15 +08:00
|
|
|
|
2001-12-04 15:12:08 +08:00
|
|
|
Frequently Asked Questions (FAQ) for PostgreSQL
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2003-09-06 00:43:13 +08:00
|
|
|
Last updated: Fri Sep 5 12:42:57 EDT 2003
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2000-03-23 14:30:58 +08:00
|
|
|
Current maintainer: Bruce Momjian (pgman@candle.pha.pa.us)
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2000-07-26 10:20:02 +08:00
|
|
|
The most recent version of this document can be viewed at
|
2003-02-19 01:23:08 +08:00
|
|
|
http://www.PostgreSQL.org/docs/faqs/FAQ.html.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2000-07-27 03:20:00 +08:00
|
|
|
Platform-specific questions are answered at
|
2003-02-19 01:23:08 +08:00
|
|
|
http://www.PostgreSQL.org/docs/index.html.
|
1998-02-28 23:08:15 +08:00
|
|
|
_________________________________________________________________
|
|
|
|
|
1999-07-11 00:28:02 +08:00
|
|
|
General Questions
|
1998-10-24 12:43:39 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
1.1) What is PostgreSQL? How is it pronounced?
|
|
|
|
1.2) What is the copyright on PostgreSQL?
|
1999-07-11 00:28:02 +08:00
|
|
|
1.3) What Unix platforms does PostgreSQL run on?
|
2002-01-11 07:07:07 +08:00
|
|
|
1.4) What non-Unix ports are available?
|
1999-07-11 00:28:02 +08:00
|
|
|
1.5) Where can I get PostgreSQL?
|
2000-07-26 10:20:02 +08:00
|
|
|
1.6) Where can I get support?
|
|
|
|
1.7) What is the latest release?
|
|
|
|
1.8) What documentation is available?
|
1999-07-11 00:28:02 +08:00
|
|
|
1.9) How do I find out about known bugs or missing features?
|
|
|
|
1.10) How can I learn SQL?
|
|
|
|
1.11) Is PostgreSQL Y2K compliant?
|
|
|
|
1.12) How do I join the development team?
|
|
|
|
1.13) How do I submit a bug report?
|
2002-01-11 07:07:07 +08:00
|
|
|
1.14) How does PostgreSQL compare to other DBMSs?
|
2001-12-05 13:33:48 +08:00
|
|
|
1.15) How can I financially assist PostgreSQL?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
User Client Questions
|
1998-10-24 12:43:39 +08:00
|
|
|
|
1999-07-11 00:28:02 +08:00
|
|
|
2.1) Are there ODBC drivers for PostgreSQL?
|
2002-01-11 07:07:07 +08:00
|
|
|
2.2) What tools are available for using PostgreSQL with Web pages?
|
2002-12-05 13:47:44 +08:00
|
|
|
2.3) Does PostgreSQL have a graphical user interface?
|
1999-07-11 00:28:02 +08:00
|
|
|
2.4) What languages are available to communicate with PostgreSQL?
|
|
|
|
|
|
|
|
Administrative Questions
|
|
|
|
|
2001-01-22 06:16:56 +08:00
|
|
|
3.1) How do I install PostgreSQL somewhere other than
|
1998-02-28 23:08:15 +08:00
|
|
|
/usr/local/pgsql?
|
2002-01-11 07:07:07 +08:00
|
|
|
3.2) When I start postmaster, I get a Bad System Call or core dumped
|
|
|
|
message. Why?
|
|
|
|
3.3) When I try to start postmaster, I get IpcMemoryCreate errors.
|
|
|
|
Why?
|
|
|
|
3.4) When I try to start postmaster, I get IpcSemaphoreCreate errors.
|
2000-07-26 10:20:02 +08:00
|
|
|
Why?
|
2002-02-15 01:15:00 +08:00
|
|
|
3.5) How do I control connections from other hosts?
|
|
|
|
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?
|
2002-10-14 11:15:33 +08:00
|
|
|
3.9) What is in the pgsql_tmp directory?
|
2002-08-22 23:31:07 +08:00
|
|
|
3.10) Why do I need to do a dump and restore to upgrade PostgreSQL
|
|
|
|
releases?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
Operational Questions
|
1998-10-24 12:43:39 +08:00
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.1) What is the difference between binary cursors and normal cursors?
|
2003-05-28 12:35:28 +08:00
|
|
|
4.2) How do I SELECT only the first few rows of a query? A random row?
|
2002-01-04 13:44:45 +08:00
|
|
|
4.3) How do I get a list of tables or other things I can see in psql?
|
2003-05-27 03:25:20 +08:00
|
|
|
4.4) How do you remove a column from a table, or change it's data
|
|
|
|
type?
|
2002-01-11 07:07:07 +08:00
|
|
|
4.5) What is the maximum size for a row, a table, and a database?
|
2002-01-04 13:44:45 +08:00
|
|
|
4.6) How much database disk space is required to store data from a
|
2000-07-26 10:20:02 +08:00
|
|
|
typical text file?
|
2002-04-18 12:45:11 +08:00
|
|
|
4.7) How do I find out what tables, indexes, databases, and users are
|
|
|
|
defined?
|
2002-01-04 13:44:45 +08:00
|
|
|
4.8) My queries are slow or don't make use of the indexes. Why?
|
|
|
|
4.9) How do I see how the query optimizer is evaluating my query?
|
|
|
|
4.10) What is an R-tree index?
|
|
|
|
4.11) What is the Genetic Query Optimizer?
|
|
|
|
4.12) How do I perform regular expression searches and
|
2001-05-11 09:33:01 +08:00
|
|
|
case-insensitive regular expression searches? How do I use an index
|
|
|
|
for case-insensitive searches?
|
2002-01-04 13:44:45 +08:00
|
|
|
4.13) In a query, how do I detect if a field is NULL?
|
|
|
|
4.14) What is the difference between the various character types?
|
|
|
|
4.15.1) How do I create a serial/auto-incrementing field?
|
|
|
|
4.15.2) How do I get the value of a SERIAL insert?
|
|
|
|
4.15.3) Don't currval() and nextval() lead to a race condition with
|
2000-07-27 00:54:58 +08:00
|
|
|
other users?
|
2002-02-13 01:14:55 +08:00
|
|
|
4.15.4) Why aren't my sequence numbers reused on transaction abort?
|
2002-02-13 01:18:10 +08:00
|
|
|
Why are there gaps in the numbering of my sequence/SERIAL column?
|
2002-01-04 13:44:45 +08:00
|
|
|
4.16) What is an OID? What is a TID?
|
|
|
|
4.17) What is the meaning of some of the terms used in PostgreSQL?
|
|
|
|
4.18) Why do I get the error "ERROR: Memory exhausted in
|
2002-01-11 07:07:07 +08:00
|
|
|
AllocSetAlloc()"?
|
2002-01-04 13:44:45 +08:00
|
|
|
4.19) How do I tell what PostgreSQL version I am running?
|
2002-01-11 07:07:07 +08:00
|
|
|
4.20) Why does my large-object operations get "invalid large obj
|
|
|
|
descriptor"?
|
2002-01-04 13:44:45 +08:00
|
|
|
4.21) How do I create a column that will default to the current time?
|
|
|
|
4.22) Why are my subqueries using IN so slow?
|
|
|
|
4.23) How do I perform an outer join?
|
|
|
|
4.24) How do I perform queries using multiple databases?
|
2002-04-09 11:22:11 +08:00
|
|
|
4.25) How do I return multiple rows or columns from a function?
|
2002-06-11 03:47:57 +08:00
|
|
|
4.26) Why can't I reliably create/drop temporary tables in PL/PgSQL
|
|
|
|
functions?
|
2002-10-11 13:02:24 +08:00
|
|
|
4.27) What replication options are available?
|
|
|
|
4.28) What encryption options are available?
|
1998-02-28 23:08:15 +08:00
|
|
|
|
1999-07-11 00:28:02 +08:00
|
|
|
Extending PostgreSQL
|
1998-10-24 12:43:39 +08:00
|
|
|
|
1999-07-11 00:28:02 +08:00
|
|
|
5.1) I wrote a user-defined function. When I run it in psql, why does
|
2000-06-09 20:20:15 +08:00
|
|
|
it dump core?
|
2001-02-16 06:15:10 +08:00
|
|
|
5.2) How can I contribute some nifty new types and functions to
|
1999-07-11 00:28:02 +08:00
|
|
|
PostgreSQL?
|
2001-02-16 06:15:10 +08:00
|
|
|
5.3) How do I write a C function to return a tuple?
|
2002-01-11 07:07:07 +08:00
|
|
|
5.4) I have changed a source file. Why does the recompile not see the
|
2000-07-27 00:54:58 +08:00
|
|
|
change?
|
1998-02-28 23:08:15 +08:00
|
|
|
_________________________________________________________________
|
|
|
|
|
1999-07-11 00:28:02 +08:00
|
|
|
General Questions
|
|
|
|
|
2002-10-14 10:50:28 +08:00
|
|
|
1.1) What is PostgreSQL? How is it pronounced?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
PostgreSQL is pronounced Post-Gres-Q-L.
|
|
|
|
|
1998-02-28 23:08:15 +08:00
|
|
|
PostgreSQL is an enhancement of the POSTGRES database management
|
|
|
|
system, a next-generation DBMS research prototype. While PostgreSQL
|
|
|
|
retains the powerful data model and rich data types of POSTGRES, it
|
|
|
|
replaces the PostQuel query language with an extended subset of SQL.
|
|
|
|
PostgreSQL is free and the complete source is available.
|
|
|
|
|
2002-10-14 10:50:28 +08:00
|
|
|
PostgreSQL development is performed by a team of developers who all
|
|
|
|
subscribe to the PostgreSQL development mailing list. The current
|
|
|
|
coordinator is Marc G. Fournier (scrappy@PostgreSQL.org). (See section
|
|
|
|
1.6 on how to join). This team is now responsible for all development
|
|
|
|
of PostgreSQL.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
|
|
|
The authors of PostgreSQL 1.01 were Andrew Yu and Jolly Chen. Many
|
2000-10-05 12:49:12 +08:00
|
|
|
others have contributed to the porting, testing, debugging, and
|
1998-02-28 23:08:15 +08:00
|
|
|
enhancement of the code. The original Postgres code, from which
|
|
|
|
PostgreSQL is derived, was the effort of many graduate students,
|
|
|
|
undergraduate students, and staff programmers working under the
|
|
|
|
direction of Professor Michael Stonebraker at the University of
|
|
|
|
California, Berkeley.
|
|
|
|
|
|
|
|
The original name of the software at Berkeley was Postgres. When SQL
|
|
|
|
functionality was added in 1995, its name was changed to Postgres95.
|
|
|
|
The name was changed at the end of 1996 to PostgreSQL.
|
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
1.2) What is the copyright on PostgreSQL?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-10-05 12:49:12 +08:00
|
|
|
PostgreSQL is subject to the following COPYRIGHT:
|
1998-02-28 23:08:15 +08:00
|
|
|
|
|
|
|
PostgreSQL Data Base Management System
|
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
Portions copyright (c) 1996-2002, PostgreSQL Global Development Group
|
2001-01-27 12:35:16 +08:00
|
|
|
Portions Copyright (c) 1994-6 Regents of the University of California
|
1998-02-28 23:08:15 +08:00
|
|
|
|
|
|
|
Permission to use, copy, modify, and distribute this software and its
|
|
|
|
documentation for any purpose, without fee, and without a written
|
|
|
|
agreement is hereby granted, provided that the above copyright notice
|
|
|
|
and this paragraph and the following two paragraphs appear in all
|
|
|
|
copies.
|
|
|
|
|
|
|
|
IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY
|
|
|
|
FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,
|
|
|
|
INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND
|
|
|
|
ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN
|
|
|
|
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
|
|
|
|
THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES,
|
|
|
|
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
|
|
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE
|
|
|
|
PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE UNIVERSITY OF
|
|
|
|
CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT,
|
|
|
|
UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
|
|
|
|
|
2002-01-23 04:24:14 +08:00
|
|
|
The above is the BSD license, the classic open-source license. It has
|
|
|
|
no restrictions on how the source code may be used. We like it and
|
|
|
|
have no intention of changing it.
|
|
|
|
|
1999-07-11 00:28:02 +08:00
|
|
|
1.3) What Unix platforms does PostgreSQL run on?
|
|
|
|
|
2001-01-21 13:01:57 +08:00
|
|
|
In general, a modern Unix-compatible platform should be able to run
|
|
|
|
PostgreSQL. The platforms that had received explicit testing at the
|
|
|
|
time of release are listed in the installation instructions.
|
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
1.4) What non-Unix ports are available?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
Client
|
|
|
|
|
1999-07-11 00:28:02 +08:00
|
|
|
It is possible to compile the libpq C library, psql, and other
|
2002-10-14 10:50:28 +08:00
|
|
|
interfaces and client applications to run on MS Windows platforms. In
|
|
|
|
this case, the client is running on MS Windows, and communicates via
|
|
|
|
TCP/IP to a server running on one of our supported Unix platforms. A
|
|
|
|
file win32.mak is included in the distribution for making a Win32
|
|
|
|
libpq library and psql. PostgreSQL also communicates with ODBC
|
|
|
|
clients.
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
Server
|
|
|
|
|
2001-02-06 12:28:50 +08:00
|
|
|
The database server can run on Windows NT and Win2k using Cygwin, the
|
|
|
|
Cygnus Unix/NT porting library. See pgsql/doc/FAQ_MSWIN in the
|
2002-10-14 10:50:28 +08:00
|
|
|
distribution or the MS Windows FAQ at
|
2003-03-18 03:47:28 +08:00
|
|
|
http://www.PostgreSQL.org/docs/faqs/text/FAQ_MSWIN.
|
2002-10-14 10:50:28 +08:00
|
|
|
|
2003-03-18 03:47:28 +08:00
|
|
|
A native port to MS Win NT/2000/XP is currently being worked on. For
|
|
|
|
more details on the current status of PostgreSQL on Windows see
|
2003-09-06 00:43:13 +08:00
|
|
|
http://techdocs.postgresql.org/guides/Windows and
|
|
|
|
http://candle.pha.pa.us/main/writings/pgsql/win32.html.
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2003-04-21 22:54:15 +08:00
|
|
|
There is also a Novell Netware 6 port at http://forge.novell.com.
|
|
|
|
|
1999-07-11 00:28:02 +08:00
|
|
|
1.5) Where can I get PostgreSQL?
|
|
|
|
|
|
|
|
The primary anonymous ftp site for PostgreSQL is
|
2002-01-11 07:07:07 +08:00
|
|
|
ftp://ftp.PostgreSQL.org/pub. For mirror sites, see our main web site.
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-07-26 10:20:02 +08:00
|
|
|
1.6) Where can I get support?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-07-21 04:31:38 +08:00
|
|
|
The main mailing list is: pgsql-general@PostgreSQL.org. It is
|
1999-06-06 02:24:55 +08:00
|
|
|
available for discussion of matters pertaining to PostgreSQL. To
|
2000-07-27 00:54:58 +08:00
|
|
|
subscribe, send mail with the following lines in the body (not the
|
2002-01-11 07:07:07 +08:00
|
|
|
subject line):
|
2000-12-09 12:29:38 +08:00
|
|
|
subscribe
|
|
|
|
end
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2000-07-21 04:31:38 +08:00
|
|
|
to pgsql-general-request@PostgreSQL.org.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
|
|
|
There is also a digest list available. To subscribe to this list, send
|
2000-07-21 04:31:38 +08:00
|
|
|
email to: pgsql-general-digest-request@PostgreSQL.org with a body of:
|
2000-12-09 12:29:38 +08:00
|
|
|
subscribe
|
|
|
|
end
|
1998-02-28 23:08:15 +08:00
|
|
|
|
|
|
|
Digests are sent out to members of this list whenever the main list
|
|
|
|
has received around 30k of messages.
|
|
|
|
|
1999-06-06 02:24:55 +08:00
|
|
|
The bugs mailing list is available. To subscribe to this list, send
|
2000-07-28 00:55:33 +08:00
|
|
|
email to pgsql-bugs-request@PostgreSQL.org with a body of:
|
2000-12-09 12:29:38 +08:00
|
|
|
subscribe
|
|
|
|
end
|
1999-06-06 02:24:55 +08:00
|
|
|
|
1998-02-28 23:08:15 +08:00
|
|
|
There is also a developers discussion mailing list available. To
|
2000-07-28 00:55:33 +08:00
|
|
|
subscribe to this list, send email to
|
|
|
|
pgsql-hackers-request@PostgreSQL.org with a body of:
|
2000-12-09 12:29:38 +08:00
|
|
|
subscribe
|
|
|
|
end
|
1998-02-28 23:08:15 +08:00
|
|
|
|
1998-08-30 12:01:31 +08:00
|
|
|
Additional mailing lists and information about PostgreSQL can be found
|
|
|
|
via the PostgreSQL WWW home page at:
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2000-07-21 04:31:38 +08:00
|
|
|
http://www.PostgreSQL.org
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2003-04-17 02:56:24 +08:00
|
|
|
There is also an IRC channel on EFNet and OpenProjects, channel
|
|
|
|
#PostgreSQL. I use the Unix command irc -c '#PostgreSQL' "$USER"
|
|
|
|
irc.phoenix.net.
|
1998-08-30 12:01:31 +08:00
|
|
|
|
2001-01-23 09:00:55 +08:00
|
|
|
A list of commercial support companies is available at
|
2003-07-21 05:52:46 +08:00
|
|
|
http://techdocs.postgresql.org/companies.php.
|
1999-06-06 02:30:43 +08:00
|
|
|
|
2000-07-26 10:20:02 +08:00
|
|
|
1.7) What is the latest release?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2003-07-23 12:11:21 +08:00
|
|
|
The latest release of PostgreSQL is version 7.3.4.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2003-07-24 00:55:47 +08:00
|
|
|
We plan to have major releases every six to eight months.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2000-07-26 10:20:02 +08:00
|
|
|
1.8) What documentation is available?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
1998-08-30 12:01:31 +08:00
|
|
|
Several manuals, manual pages, and some small test examples are
|
2000-06-09 20:20:15 +08:00
|
|
|
included in the distribution. See the /doc directory. You can also
|
2003-03-18 03:47:28 +08:00
|
|
|
browse the manuals online at http://www.PostgreSQL.org/docs.
|
2000-06-09 20:20:15 +08:00
|
|
|
|
2002-02-22 04:13:39 +08:00
|
|
|
There are two PostgreSQL books available online at
|
|
|
|
http://www.PostgreSQL.org/docs/awbook.html and
|
|
|
|
http://www.commandprompt.com/ppbook/. There is a list of PostgreSQL
|
2003-06-07 06:20:40 +08:00
|
|
|
books available for purchase at
|
|
|
|
http://techdocs.PostgreSQL.org/techdocs/bookreviews.php. There is also
|
|
|
|
a collection of PostgreSQL technical articles at
|
2002-10-14 10:50:28 +08:00
|
|
|
http://techdocs.PostgreSQL.org/.
|
1998-04-16 00:50:32 +08:00
|
|
|
|
|
|
|
psql has some nice \d commands to show information about types,
|
|
|
|
operators, functions, aggregates, etc.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
Our web site contains even more documentation.
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
1.9) How do I find out about known bugs or missing features?
|
|
|
|
|
2000-07-27 00:54:58 +08:00
|
|
|
PostgreSQL supports an extended subset of SQL-92. See our TODO list
|
|
|
|
for known bugs, missing features, and future plans.
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
1.10) How can I learn SQL?
|
|
|
|
|
2000-07-21 04:31:38 +08:00
|
|
|
The PostgreSQL book at http://www.PostgreSQL.org/docs/awbook.html
|
2002-02-03 05:46:45 +08:00
|
|
|
teaches SQL. There is another PostgreSQL book at
|
|
|
|
http://www.commandprompt.com/ppbook. There is a nice tutorial at
|
|
|
|
http://www.intermedia.net/support/sql/sqltut.shtm, at
|
|
|
|
http://ourworld.compuserve.com/homepages/graeme_birchall/HTM_COOK.HTM,
|
|
|
|
and at http://sqlcourse.com.
|
2000-03-23 14:30:58 +08:00
|
|
|
|
|
|
|
Another one is "Teach Yourself SQL in 21 Days, Second Edition" at
|
2000-12-09 12:29:38 +08:00
|
|
|
http://members.tripod.com/er4ebus/sql/index.htm
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-08-27 11:55:20 +08:00
|
|
|
Many of our users like The Practical SQL Handbook, Bowman, Judith S.,
|
2000-10-10 04:21:01 +08:00
|
|
|
et al., Addison-Wesley. Others like The Complete Reference SQL, Groff
|
2000-08-27 11:55:20 +08:00
|
|
|
et al., McGraw-Hill.
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
1.11) Is PostgreSQL Y2K compliant?
|
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
Yes, we easily handle dates past the year 2000 AD, and before 2000 BC.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
1999-07-11 00:28:02 +08:00
|
|
|
1.12) How do I join the development team?
|
|
|
|
|
2000-07-27 00:54:58 +08:00
|
|
|
First, download the latest source and read the PostgreSQL Developers
|
2002-01-11 07:07:07 +08:00
|
|
|
documentation on our web site, or in the distribution. Second,
|
1999-07-11 00:28:02 +08:00
|
|
|
subscribe to the pgsql-hackers and pgsql-patches mailing lists. Third,
|
2002-01-11 07:07:07 +08:00
|
|
|
submit high quality patches to pgsql-patches.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2000-07-21 01:48:36 +08:00
|
|
|
There are about a dozen people who have commit privileges to the
|
2000-07-26 10:20:02 +08:00
|
|
|
PostgreSQL CVS archive. They each have submitted so many high-quality
|
2000-07-27 00:54:58 +08:00
|
|
|
patches that it was impossible for the existing committers to keep up,
|
|
|
|
and we had confidence that patches they committed were of high
|
|
|
|
quality.
|
1998-10-24 12:43:39 +08:00
|
|
|
|
1999-07-11 00:28:02 +08:00
|
|
|
1.13) How do I submit a bug report?
|
|
|
|
|
2002-10-14 10:50:28 +08:00
|
|
|
Please visit the PostgreSQL BugTool page at
|
|
|
|
http://www.PostgreSQL.org/bugs/bugs.php, which gives guidelines and
|
|
|
|
directions on how to submit a bug report.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2000-07-21 04:31:38 +08:00
|
|
|
Also check out our ftp site ftp://ftp.PostgreSQL.org/pub to see if
|
1999-07-11 00:28:02 +08:00
|
|
|
there is a more recent PostgreSQL version or patches.
|
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
1.14) How does PostgreSQL compare to other DBMSs?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
There are several ways of measuring software: features, performance,
|
|
|
|
reliability, support, and price.
|
|
|
|
|
|
|
|
Features
|
2002-01-11 07:07:07 +08:00
|
|
|
PostgreSQL has most features present in large commercial DBMSs,
|
|
|
|
like transactions, subselects, triggers, views, foreign key
|
|
|
|
referential integrity, and sophisticated locking. We have some
|
|
|
|
features they do not have, like user-defined types,
|
2000-06-24 09:51:14 +08:00
|
|
|
inheritance, rules, and multi-version concurrency control to
|
2001-01-22 13:56:26 +08:00
|
|
|
reduce lock contention.
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
Performance
|
2002-06-11 10:22:41 +08:00
|
|
|
PostgreSQL has performance similar to other commercial and open
|
|
|
|
source databases. it is faster for some things, slower for
|
2002-06-11 18:29:54 +08:00
|
|
|
others. In comparison to MySQL or leaner database systems, we
|
|
|
|
are slower on inserts/updates because of transaction overhead.
|
2002-01-11 07:07:07 +08:00
|
|
|
Of course, MySQL does not have any of the features mentioned in
|
2002-06-11 10:22:41 +08:00
|
|
|
the Features section above. We are built for reliability and
|
|
|
|
features, though we continue to improve performance in every
|
|
|
|
release. There is an interesting Web page comparing PostgreSQL
|
2002-10-21 08:47:44 +08:00
|
|
|
to MySQL at http://openacs.org/philosophy/why-not-mysql.html
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
Reliability
|
|
|
|
We realize that a DBMS must be reliable, or it is worthless. We
|
|
|
|
strive to release well-tested, stable code that has a minimum
|
|
|
|
of bugs. Each release has at least one month of beta testing,
|
|
|
|
and our release history shows that we can provide stable, solid
|
|
|
|
releases that are ready for production use. We believe we
|
|
|
|
compare favorably to other database software in this area.
|
|
|
|
|
|
|
|
Support
|
2002-10-14 10:50:28 +08:00
|
|
|
Our mailing lists provide contact with a large group of
|
|
|
|
developers and users to help resolve any problems encountered.
|
|
|
|
While we cannot guarantee a fix, commercial DBMSs do not always
|
|
|
|
supply a fix either. Direct access to developers, the user
|
|
|
|
community, manuals, and the source code often make PostgreSQL
|
|
|
|
support superior to other DBMSs. There is commercial
|
|
|
|
per-incident support available for those who need it. (See FAQ
|
|
|
|
section 1.6.)
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
Price
|
|
|
|
We are free for all use, both commercial and non-commercial.
|
|
|
|
You can add our code to your product with no limitations,
|
|
|
|
except those outlined in our BSD-style license stated above.
|
2001-11-28 04:25:45 +08:00
|
|
|
|
2001-12-05 13:33:48 +08:00
|
|
|
1.15) How can I financially assist PostgreSQL?
|
2001-11-28 04:25:45 +08:00
|
|
|
|
2002-10-14 10:50:28 +08:00
|
|
|
PostgreSQL has had a first-class infrastructure since we started in
|
2002-10-14 11:15:33 +08:00
|
|
|
1996. This is all thanks to Marc Fournier, who has created and managed
|
2002-10-14 10:50:28 +08:00
|
|
|
this infrastructure over the years.
|
2001-11-28 04:25:45 +08:00
|
|
|
|
|
|
|
Quality infrastructure is very important to an open-source project. It
|
|
|
|
prevents disruptions that can greatly delay forward movement of the
|
|
|
|
project.
|
|
|
|
|
|
|
|
Of course, this infrastructure is not cheap. There are a variety of
|
|
|
|
monthly and one-time expenses that are required to keep it going. If
|
|
|
|
you or your company has money it can donate to help fund this effort,
|
2002-10-14 10:50:28 +08:00
|
|
|
please go to http://store.pgsql.com/shopping/ and make a donation.
|
2001-12-05 13:41:13 +08:00
|
|
|
|
2001-11-28 04:25:45 +08:00
|
|
|
Although the web page mentions PostgreSQL, Inc, the "contributions"
|
|
|
|
item is solely to support the PostgreSQL project and does not fund any
|
|
|
|
specific company. If you prefer, you can also send a check to the
|
|
|
|
contact address.
|
1999-07-11 00:28:02 +08:00
|
|
|
_________________________________________________________________
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2003-05-31 10:25:11 +08:00
|
|
|
Also, if you have a success story about PostgreSQL, please submit it
|
|
|
|
to our advocacy site at http://advocacy.postgresql.org.
|
|
|
|
|
1999-07-11 00:28:02 +08:00
|
|
|
User Client Questions
|
|
|
|
|
|
|
|
2.1) Are there ODBC drivers for PostgreSQL?
|
|
|
|
|
2000-06-24 09:51:14 +08:00
|
|
|
There are two ODBC drivers available, PsqlODBC and OpenLink ODBC.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-12-05 13:47:44 +08:00
|
|
|
You can download PsqlODBC from
|
|
|
|
http://gborg.postgresql.org/project/psqlodbc/projdisplay.php.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
1998-08-30 12:01:31 +08:00
|
|
|
OpenLink ODBC can be gotten from http://www.openlinksw.com. It works
|
|
|
|
with their standard ODBC client software so you'll have PostgreSQL
|
|
|
|
ODBC available on every client platform they support (Win, Mac, Unix,
|
|
|
|
VMS).
|
|
|
|
|
|
|
|
They will probably be selling this product to people who need
|
1998-02-28 23:08:15 +08:00
|
|
|
commercial-quality support, but a freeware version will always be
|
2002-01-11 07:07:07 +08:00
|
|
|
available. Please send questions to postgres95@openlink.co.uk.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2001-01-23 09:00:55 +08:00
|
|
|
2.2) What tools are available for using PostgreSQL with Web pages?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
1998-02-28 23:08:15 +08:00
|
|
|
A nice introduction to Database-backed Web pages can be seen at:
|
2002-01-11 07:07:07 +08:00
|
|
|
http://www.webreview.com
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2000-10-05 12:49:12 +08:00
|
|
|
For Web integration, PHP is an excellent interface. It is at
|
2002-01-11 07:07:07 +08:00
|
|
|
http://www.php.net.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-10-14 10:50:28 +08:00
|
|
|
For complex cases, many use the Perl interface and CGI.pm or mod_perl.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-12-05 13:47:44 +08:00
|
|
|
2.3) Does PostgreSQL have a graphical user interface?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-12-05 13:47:44 +08:00
|
|
|
Yes, there are several graphical interfaces to PostgreSQL available.
|
2002-12-17 02:40:32 +08:00
|
|
|
These include PgAccess http://www.pgaccess.org), PgAdmin II
|
2002-12-05 13:47:44 +08:00
|
|
|
(http://www.pgadmin.org, Win32-only), RHDB Admin
|
|
|
|
(http://sources.redhat.com/rhdb/ ) and Rekall (
|
|
|
|
http://www.thekompany.com/products/rekall/, proprietary). There is
|
|
|
|
also PHPPgAdmin ( http://phppgadmin.sourceforge.net/ ), a web-based
|
|
|
|
interface to PostgreSQL.
|
|
|
|
|
2003-02-18 13:07:04 +08:00
|
|
|
See http://techdocs.postgresql.org/guides/GUITools for a more detailed
|
|
|
|
list.
|
|
|
|
|
2002-10-14 10:50:28 +08:00
|
|
|
2.4) What languages are able to communicate with PostgreSQL?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-12-05 13:47:44 +08:00
|
|
|
Most popular programming languages contain an interface to PostgreSQL.
|
|
|
|
Check your programming language's list of extension modules.
|
|
|
|
|
|
|
|
The following interfaces are included in the PostgreSQL distribution:
|
2000-07-27 03:20:00 +08:00
|
|
|
* C (libpq)
|
|
|
|
* Embedded C (ecpg)
|
|
|
|
* Java (jdbc)
|
|
|
|
* Python (PyGreSQL)
|
|
|
|
* TCL (libpgtcl)
|
2002-07-30 09:35:29 +08:00
|
|
|
|
2002-12-05 13:47:44 +08:00
|
|
|
Additional interfaces are available at http://gborg.postgresql.org in
|
|
|
|
the Drivers/Interfaces section.
|
1998-02-28 23:08:15 +08:00
|
|
|
_________________________________________________________________
|
|
|
|
|
1999-07-11 00:28:02 +08:00
|
|
|
Administrative Questions
|
|
|
|
|
2001-01-22 06:16:56 +08:00
|
|
|
3.1) How do I install PostgreSQL somewhere other than /usr/local/pgsql?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2001-01-22 06:16:56 +08:00
|
|
|
Specify the --prefix option when running configure.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
3.2) When I start postmaster, I get a Bad System Call or core dumped
|
1999-07-11 00:28:02 +08:00
|
|
|
message. Why?
|
|
|
|
|
1998-02-28 23:08:15 +08:00
|
|
|
It could be a variety of problems, but first check to see that you
|
2000-07-21 04:13:15 +08:00
|
|
|
have System V extensions installed in your kernel. PostgreSQL requires
|
1998-10-24 12:43:39 +08:00
|
|
|
kernel support for shared memory and semaphores.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
3.3) When I try to start postmaster, I get IpcMemoryCreate errors. Why?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-07-26 10:20:02 +08:00
|
|
|
You either do not have shared memory configured properly in your
|
|
|
|
kernel or you need to enlarge the shared memory available in the
|
|
|
|
kernel. The exact amount you need depends on your architecture and how
|
2002-01-11 07:07:07 +08:00
|
|
|
many buffers and backend processes you configure for postmaster. For
|
|
|
|
most systems, with default numbers of buffers and processes, you need
|
|
|
|
a minimum of ~1 MB. See the PostgreSQL Administrator's Guide for more
|
|
|
|
detailed information about shared memory and semaphores.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
3.4) When I try to start postmaster, I get IpcSemaphoreCreate errors. Why?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
If the error message is IpcSemaphoreCreate: semget failed (No space
|
|
|
|
left on device) then your kernel is not configured with enough
|
|
|
|
semaphores. Postgres needs one semaphore per potential backend
|
2002-01-11 07:07:07 +08:00
|
|
|
process. A temporary solution is to start postmaster with a smaller
|
|
|
|
limit on the number of backend processes. Use -N with a parameter less
|
|
|
|
than the default of 32. A more permanent solution is to increase your
|
|
|
|
kernel's SEMMNS and SEMMNI parameters.
|
|
|
|
|
|
|
|
Inoperative semaphores can also cause crashes during heavy database
|
|
|
|
access.
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
If the error message is something else, you might not have semaphore
|
2001-04-10 03:28:01 +08:00
|
|
|
support configured in your kernel at all. See the PostgreSQL
|
|
|
|
Administrator's Guide for more detailed information about shared
|
|
|
|
memory and semaphores.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-02-15 01:15:00 +08:00
|
|
|
3.5) How do I control connections from other hosts?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
1998-02-28 23:08:15 +08:00
|
|
|
By default, PostgreSQL only allows connections from the local machine
|
2000-06-09 20:20:15 +08:00
|
|
|
using Unix domain sockets. Other machines will not be able to connect
|
2002-01-11 07:07:07 +08:00
|
|
|
unless you add the -i flag to postmaster, and enable host-based
|
1999-06-06 02:24:55 +08:00
|
|
|
authentication by modifying the file $PGDATA/pg_hba.conf accordingly.
|
1999-07-11 00:28:02 +08:00
|
|
|
This will allow TCP/IP connections.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-02-15 01:15:00 +08:00
|
|
|
3.6) How do I tune the database engine for better performance?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
Certainly, indexes can speed up queries. The EXPLAIN command allows
|
1998-10-24 12:43:39 +08:00
|
|
|
you to see how PostgreSQL is interpreting your query, and which
|
2002-01-11 07:07:07 +08:00
|
|
|
indexes are being used.
|
1998-10-24 12:43:39 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
If you are doing many INSERTs, consider doing them in a large batch
|
|
|
|
using the COPY command. This is much faster than individual INSERTS.
|
|
|
|
Second, statements not in a BEGIN WORK/COMMIT transaction block are
|
|
|
|
considered to be in their own transaction. Consider performing several
|
|
|
|
statements in a single transaction block. This reduces the transaction
|
|
|
|
overhead. Also, consider dropping and recreating indexes when making
|
|
|
|
large data changes.
|
1998-08-30 12:01:31 +08:00
|
|
|
|
2000-07-27 00:54:58 +08:00
|
|
|
There are several tuning options. You can disable fsync() by starting
|
2002-01-11 07:07:07 +08:00
|
|
|
postmaster with a -o -F option. This will prevent fsync()s from
|
2000-07-27 00:54:58 +08:00
|
|
|
flushing to disk after every transaction.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
|
|
|
You can also use the postmaster -B option to increase the number of
|
1998-10-24 12:43:39 +08:00
|
|
|
shared memory buffers used by the backend processes. If you make this
|
2002-01-11 07:07:07 +08:00
|
|
|
parameter too high, the postmaster may not start because you have
|
1999-06-06 02:24:55 +08:00
|
|
|
exceeded your kernel's limit on shared memory space. Each buffer is 8K
|
|
|
|
and the default is 64 buffers.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
1999-06-06 02:24:55 +08:00
|
|
|
You can also use the backend -S option to increase the maximum amount
|
2000-06-09 20:20:15 +08:00
|
|
|
of memory used by the backend process for temporary sorts. The -S
|
2002-01-11 07:07:07 +08:00
|
|
|
value is measured in kilobytes, and the default is 512 (i.e. 512K).
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2000-07-26 10:20:02 +08:00
|
|
|
You can also use the CLUSTER command to group data in tables to match
|
2000-07-27 00:54:58 +08:00
|
|
|
an index. See the CLUSTER manual page for more details.
|
1998-04-16 00:50:32 +08:00
|
|
|
|
2002-02-15 01:15:00 +08:00
|
|
|
3.7) What debugging features are available?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
1998-02-28 23:08:15 +08:00
|
|
|
PostgreSQL has several features that report status information that
|
|
|
|
can be valuable for debugging purposes.
|
|
|
|
|
1999-06-06 02:24:55 +08:00
|
|
|
First, by running configure with the --enable-cassert option, many
|
2002-01-11 07:07:07 +08:00
|
|
|
assert()s monitor the progress of the backend and halt the program
|
1998-02-28 23:08:15 +08:00
|
|
|
when something unexpected occurs.
|
|
|
|
|
|
|
|
Both postmaster and postgres have several debug options available.
|
2002-01-11 07:07:07 +08:00
|
|
|
First, whenever you start postmaster, make sure you send the standard
|
|
|
|
output and error to a log file, like:
|
2000-12-09 12:29:38 +08:00
|
|
|
cd /usr/local/pgsql
|
|
|
|
./bin/postmaster >server.log 2>&1 &
|
1998-02-28 23:08:15 +08:00
|
|
|
|
|
|
|
This will put a server.log file in the top-level PostgreSQL directory.
|
1998-10-24 12:43:39 +08:00
|
|
|
This file contains useful information about problems or errors
|
1998-02-28 23:08:15 +08:00
|
|
|
encountered by the server. Postmaster has a -d option that allows even
|
|
|
|
more detailed information to be reported. The -d option takes a number
|
1998-10-24 12:43:39 +08:00
|
|
|
that specifies the debug level. Be warned that high debug level values
|
1999-06-06 02:24:55 +08:00
|
|
|
generate large log files.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
If postmaster is not running, you can actually run the postgres
|
2000-06-09 20:20:15 +08:00
|
|
|
backend from the command line, and type your SQL statement directly.
|
|
|
|
This is recommended only for debugging purposes. Note that a newline
|
|
|
|
terminates the query, not a semicolon. If you have compiled with
|
|
|
|
debugging symbols, you can use a debugger to see what is happening.
|
2002-01-11 07:07:07 +08:00
|
|
|
Because the backend was not started from postmaster, it is not running
|
|
|
|
in an identical environment and locking/backend interaction problems
|
|
|
|
may not be duplicated.
|
2000-06-09 20:20:15 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
If postmaster is running, start psql in one window, then find the PID
|
|
|
|
of the postgres process used by psql. Use a debugger to attach to the
|
|
|
|
postgres PID. You can set breakpoints in the debugger and issue
|
2000-06-09 20:20:15 +08:00
|
|
|
queries from psql. If you are debugging postgres startup, you can set
|
|
|
|
PGOPTIONS="-W n", then start psql. This will cause startup to delay
|
2001-11-29 05:11:39 +08:00
|
|
|
for n seconds so you can attach to the process with the debugger, set
|
|
|
|
any breakpoints, and continue through the startup sequence.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
1999-06-06 02:24:55 +08:00
|
|
|
The postgres program has -s, -A, and -t options that can be very
|
|
|
|
useful for debugging and performance measurements.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
|
|
|
You can also compile with profiling to see what functions are taking
|
|
|
|
execution time. The backend profile files will be deposited in the
|
|
|
|
pgsql/data/base/dbname directory. The client profile file will be put
|
2002-04-18 10:48:19 +08:00
|
|
|
in the client's current directory. Linux requires a compile with
|
|
|
|
-DLINUX_PROFILE for proper profiling.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-02-15 01:15:00 +08:00
|
|
|
3.8) Why do I get "Sorry, too many clients" when trying to connect?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
You need to increase postmaster's limit on how many concurrent backend
|
|
|
|
processes it can start.
|
1999-06-05 11:43:07 +08:00
|
|
|
|
2001-09-07 09:24:18 +08:00
|
|
|
The default limit is 32 processes. You can increase it by restarting
|
2002-01-11 07:07:07 +08:00
|
|
|
postmaster with a suitable -N value or modifying postgresql.conf.
|
2000-06-09 20:20:15 +08:00
|
|
|
|
|
|
|
Note that if you make -N larger than 32, you must also increase -B
|
|
|
|
beyond its default of 64; -B must be at least twice -N, and probably
|
|
|
|
should be more than that for best performance. For large numbers of
|
|
|
|
backend processes, you are also likely to find that you need to
|
|
|
|
increase various Unix kernel configuration parameters. Things to check
|
2000-10-05 12:57:27 +08:00
|
|
|
include the maximum size of shared memory blocks, SHMMAX; the maximum
|
|
|
|
number of semaphores, SEMMNS and SEMMNI; the maximum number of
|
|
|
|
processes, NPROC; the maximum number of processes per user, MAXUPRC;
|
2000-06-09 20:20:15 +08:00
|
|
|
and the maximum number of open files, NFILE and NINODE. The reason
|
2000-07-21 04:13:15 +08:00
|
|
|
that PostgreSQL has a limit on the number of allowed backend processes
|
2000-07-26 10:20:02 +08:00
|
|
|
is so your system won't run out of resources.
|
1999-06-05 11:43:07 +08:00
|
|
|
|
2002-10-21 08:47:44 +08:00
|
|
|
3.9) What is in the pgsql_tmp directory?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-10-21 08:47:44 +08:00
|
|
|
This directory contains 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 here to hold the extra data.
|
1999-06-05 11:43:07 +08:00
|
|
|
|
2002-10-14 11:15:33 +08:00
|
|
|
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.
|
2002-06-21 10:01:04 +08:00
|
|
|
|
2002-08-22 23:31:07 +08:00
|
|
|
3.10) Why do I need to do a dump and restore to upgrade between major
|
|
|
|
PostgreSQL releases?
|
2002-06-21 10:01:04 +08:00
|
|
|
|
2002-08-22 23:31:07 +08:00
|
|
|
The PostgreSQL team makes only small changes between minor releases,
|
|
|
|
so upgrading from 7.2 to 7.2.1 does not require a dump and restore.
|
2002-10-14 10:50:28 +08:00
|
|
|
However, major releases (e.g. from 7.2 to 7.3) often change the
|
|
|
|
internal format of system tables and data files. These changes are
|
|
|
|
often complex, so we don't maintain backward compatability for data
|
|
|
|
files. A dump outputs data in a generic format that can then be loaded
|
|
|
|
in using the new internal format.
|
2002-08-22 23:31:07 +08:00
|
|
|
|
|
|
|
In releases where the on-disk format does not change, the pg_upgrade
|
|
|
|
script can be used to upgrade without a dump/restore. The release
|
|
|
|
notes mention whether pg_upgrade is available for the release.
|
1999-07-11 00:28:02 +08:00
|
|
|
_________________________________________________________________
|
1998-02-28 23:08:15 +08:00
|
|
|
|
1999-07-11 00:28:02 +08:00
|
|
|
Operational Questions
|
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.1) What is the difference between binary cursors and normal cursors?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-03-23 14:30:58 +08:00
|
|
|
See the DECLARE manual page for a description.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2003-05-28 12:35:28 +08:00
|
|
|
4.2) How do I SELECT only the first few rows of a query? A random row?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-03-23 14:30:58 +08:00
|
|
|
See the FETCH manual page, or use SELECT ... LIMIT....
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2000-03-23 14:30:58 +08:00
|
|
|
The entire query may have to be evaluated, even if you only want the
|
2002-10-14 10:50:28 +08:00
|
|
|
first few rows. Consider using a query that has an ORDER BY. If there
|
|
|
|
is an index that matches the ORDER BY, PostgreSQL may be able to
|
|
|
|
evaluate only the first few records requested, or the entire query may
|
|
|
|
have to be evaluated until the desired rows have been generated.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2003-05-28 12:35:28 +08:00
|
|
|
To SELECT a random row, use:
|
|
|
|
SELECT col
|
|
|
|
FROM tab
|
|
|
|
ORDER BY random()
|
|
|
|
LIMIT 1;
|
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.3) How do I get a list of tables or other things I can see in psql?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-07-26 10:20:02 +08:00
|
|
|
You can read the source code for psql in file
|
2001-01-22 06:16:56 +08:00
|
|
|
pgsql/src/bin/psql/describe.c. It contains SQL commands that generate
|
|
|
|
the output for psql's backslash commands. You can also start psql with
|
|
|
|
the -E option so it will print out the queries it uses to execute the
|
2000-07-26 10:20:02 +08:00
|
|
|
commands you give.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2003-05-27 03:25:20 +08:00
|
|
|
4.4) How do you remove a column from a table, or change its data type?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2003-05-27 03:25:20 +08:00
|
|
|
DROP COLUMN functionality was added in release 7.3 with ALTER TABLE
|
|
|
|
DROP COLUMN. In earlier versions, you can do this:
|
2002-04-27 11:04:08 +08:00
|
|
|
BEGIN;
|
|
|
|
LOCK TABLE old_table;
|
2000-12-09 12:29:38 +08:00
|
|
|
SELECT ... -- select all columns but the one you want to remove
|
|
|
|
INTO TABLE new_table
|
|
|
|
FROM old_table;
|
|
|
|
DROP TABLE old_table;
|
|
|
|
ALTER TABLE new_table RENAME TO old_table;
|
2002-04-27 11:04:08 +08:00
|
|
|
COMMIT;
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2003-05-27 03:25:20 +08:00
|
|
|
To change the data type of a column, do this:
|
|
|
|
BEGIN;
|
|
|
|
ALTER TABLE tab ADD COLUMN new_col new_data_type;
|
|
|
|
UPDATE tab SET new_col = CAST(old_col AS new_data_type);
|
2003-06-07 06:20:40 +08:00
|
|
|
ALTER TABLE tab DROP COLUMN old_col;
|
2003-05-27 03:25:20 +08:00
|
|
|
COMMIT;
|
|
|
|
|
|
|
|
You might then want to do VACUUM FULL tab to reclaim the disk space
|
|
|
|
used by the expired rows.
|
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
4.5) What is the maximum size for a row, a table, and a database?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-06-09 20:20:15 +08:00
|
|
|
These are the limits:
|
2003-03-18 00:33:12 +08:00
|
|
|
Maximum size for a database? unlimited (4 TB databases exist)
|
2001-12-05 13:38:51 +08:00
|
|
|
Maximum size for a table? 16 TB
|
2002-07-12 00:35:56 +08:00
|
|
|
Maximum size for a row? 1.6TB
|
|
|
|
Maximum size for a field? 1 GB
|
2001-12-05 13:38:51 +08:00
|
|
|
Maximum number of rows in a table? unlimited
|
|
|
|
Maximum number of columns in a table? 250-1600 depending on column types
|
|
|
|
Maximum number of indexes on a table? unlimited
|
2000-06-09 20:20:15 +08:00
|
|
|
|
|
|
|
Of course, these are not actually unlimited, but limited to available
|
2001-01-28 04:19:34 +08:00
|
|
|
disk space and memory/swap space. Performance may suffer when these
|
|
|
|
values get unusually large.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
The maximum table size of 16 TB does not require large file support
|
|
|
|
from the operating system. Large tables are stored as multiple 1 GB
|
2001-07-11 09:01:56 +08:00
|
|
|
files so file system size limits are not important.
|
2001-01-29 01:39:44 +08:00
|
|
|
|
|
|
|
The maximum table size and maximum number of columns can be increased
|
2001-01-29 09:23:36 +08:00
|
|
|
if the default block size is increased to 32k.
|
2001-01-29 01:39:44 +08:00
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.6) How much database disk space is required to store data from a typical
|
2000-07-26 10:20:02 +08:00
|
|
|
text file?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-02-15 01:15:00 +08:00
|
|
|
A PostgreSQL database may require up to five times the disk space to
|
|
|
|
store data from a text file.
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-02-15 01:15:00 +08:00
|
|
|
As an example, consider a file of 100,000 lines with an integer and
|
|
|
|
text description on each line. Suppose the text string avergages
|
2002-02-18 13:09:01 +08:00
|
|
|
twenty bytes in length. The flat file would be 2.8 MB. The size of the
|
|
|
|
PostgreSQL database file containing this data can be estimated as 6.4
|
|
|
|
MB:
|
1999-07-11 00:28:02 +08:00
|
|
|
36 bytes: each row header (approximate)
|
2002-10-14 10:50:28 +08:00
|
|
|
24 bytes: one int field and one text field
|
1999-07-11 00:28:02 +08:00
|
|
|
+ 4 bytes: pointer on page to tuple
|
|
|
|
----------------------------------------
|
2002-02-18 13:09:01 +08:00
|
|
|
64 bytes per row
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
The data page size in PostgreSQL is 8192 bytes (8 KB), so:
|
|
|
|
|
|
|
|
8192 bytes per page
|
2002-02-18 13:09:01 +08:00
|
|
|
------------------- = 128 rows per database page (rounded down)
|
|
|
|
64 bytes per row
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-02-15 01:15:00 +08:00
|
|
|
100000 data rows
|
2002-02-18 13:09:01 +08:00
|
|
|
-------------------- = 782 database pages (rounded up)
|
|
|
|
128 rows per page
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-02-18 13:09:01 +08:00
|
|
|
782 database pages * 8192 bytes per page = 6,406,144 bytes (6.4 MB)
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-07-26 10:20:02 +08:00
|
|
|
Indexes do not require as much overhead, but do contain the data that
|
1999-07-11 00:28:02 +08:00
|
|
|
is being indexed, so they can be large also.
|
|
|
|
|
2002-07-05 03:26:10 +08:00
|
|
|
NULLs are stored in bitmaps, so they use very little space.
|
|
|
|
|
2002-04-18 12:45:11 +08:00
|
|
|
4.7) How do I find out what tables, indexes, databases, and users are
|
|
|
|
defined?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
psql has a variety of backslash commands to show such information. Use
|
2002-04-18 12:45:11 +08:00
|
|
|
\? to see them. There are also system tables beginning with pg_ that
|
|
|
|
describe these too. Also, psql -l will list all databases.
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
Also try the file pgsql/src/tutorial/syscat.source. It illustrates
|
2000-03-23 14:30:58 +08:00
|
|
|
many of the SELECTs needed to get information from the database system
|
1999-07-11 00:28:02 +08:00
|
|
|
tables.
|
1999-06-05 11:43:07 +08:00
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.8) My queries are slow or don't make use of the indexes. Why?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-03-04 00:02:31 +08:00
|
|
|
Indexes are not automatically used by every query. Indexes are only
|
2002-03-04 02:35:46 +08:00
|
|
|
used if the table is larger than a minimum size, and the query selects
|
2002-03-04 00:02:31 +08:00
|
|
|
only a small percentage of the rows in the table. This is because the
|
2002-06-24 05:16:29 +08:00
|
|
|
random disk access caused by an index scan can be slower than a
|
2002-03-04 00:02:31 +08:00
|
|
|
straight read through the table, or sequential scan.
|
|
|
|
|
|
|
|
To determine if an index should be used, PostgreSQL must have
|
|
|
|
statistics about the table. These statistics are collected using
|
|
|
|
VACUUM ANALYZE, or simply ANALYZE. Using statistics, the optimizer
|
|
|
|
knows how many rows are in the table, and can better determine if
|
|
|
|
indexes should be used. Statistics are also valuable in determining
|
|
|
|
optimal join order and join methods. Statistics collection should be
|
|
|
|
performed periodically as the contents of the table change.
|
|
|
|
|
|
|
|
Indexes are normally not used for ORDER BY or to perform joins. A
|
|
|
|
sequential scan followed by an explicit sort is usually faster than an
|
|
|
|
index scan of a large table.
|
|
|
|
However, LIMIT combined with ORDER BY often will use an index because
|
2002-06-24 05:16:29 +08:00
|
|
|
only a small portion of the table is returned. In fact, though MAX()
|
|
|
|
and MIN() don't use indexes, it is possible to retrieve such values
|
|
|
|
using an index with ORDER BY and LIMIT:
|
|
|
|
SELECT col
|
|
|
|
FROM tab
|
2002-06-25 09:45:58 +08:00
|
|
|
ORDER BY col [ DESC ]
|
2002-10-14 10:50:28 +08:00
|
|
|
LIMIT 1;
|
2002-06-24 05:16:29 +08:00
|
|
|
|
2003-01-18 01:15:14 +08:00
|
|
|
If you believe the optimizer is incorrect in choosing a sequential
|
|
|
|
scan, use SET enable_seqscan TO 'off' and run tests to see if an index
|
|
|
|
scan is indeed faster.
|
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
When using wild-card operators such as LIKE or ~, indexes can only be
|
2002-06-25 11:32:31 +08:00
|
|
|
used in certain circumstances:
|
|
|
|
* The beginning of the search string must be anchored to the start
|
2002-10-21 08:47:44 +08:00
|
|
|
of the string, i.e.
|
|
|
|
+ LIKE patterns must not start with %.
|
|
|
|
+ ~ (regular expression) patterns must start with ^.
|
|
|
|
* The search string can not start with a character class, e.g.
|
|
|
|
[a-e].
|
|
|
|
* Case-insensitive searches such as ILIKE and ~* do not utilise
|
|
|
|
indexes. Instead, use functional indexes, which are described in
|
|
|
|
section 4.12.
|
|
|
|
* The default C locale must be used during initdb.
|
2002-06-25 11:32:31 +08:00
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.9) How do I see how the query optimizer is evaluating my query?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-03-23 14:30:58 +08:00
|
|
|
See the EXPLAIN manual page.
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.10) What is an R-tree index?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-07-21 04:13:15 +08:00
|
|
|
An R-tree index is used for indexing spatial data. A hash index can't
|
1999-07-11 00:28:02 +08:00
|
|
|
handle range searches. A B-tree index only handles range searches in a
|
2002-01-11 07:07:07 +08:00
|
|
|
single dimension. R-trees can handle multi-dimensional data. For
|
1999-07-11 00:28:02 +08:00
|
|
|
example, if an R-tree index can be built on an attribute of type
|
2000-10-05 13:14:58 +08:00
|
|
|
point, the system can more efficiently answer queries such as "select
|
|
|
|
all points within a bounding rectangle."
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-10-05 13:14:58 +08:00
|
|
|
The canonical paper that describes the original R-tree design is:
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-10-05 13:14:58 +08:00
|
|
|
Guttman, A. "R-trees: A Dynamic Index Structure for Spatial
|
2002-01-11 07:07:07 +08:00
|
|
|
Searching." Proceedings of the 1984 ACM SIGMOD Int'l Conf on Mgmt of
|
|
|
|
Data, 45-57.
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
You can also find this paper in Stonebraker's "Readings in Database
|
2000-10-09 15:38:53 +08:00
|
|
|
Systems".
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-10-05 13:14:58 +08:00
|
|
|
Built-in R-trees can handle polygons and boxes. In theory, R-trees can
|
1999-07-11 00:28:02 +08:00
|
|
|
be extended to handle higher number of dimensions. In practice,
|
2000-10-05 13:14:58 +08:00
|
|
|
extending R-trees requires a bit of work and we don't currently have
|
1999-07-11 00:28:02 +08:00
|
|
|
any documentation on how to do it.
|
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.11) What is the Genetic Query Optimizer?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-07-26 10:20:02 +08:00
|
|
|
The GEQO module speeds query optimization when joining many tables by
|
|
|
|
means of a Genetic Algorithm (GA). It allows the handling of large
|
2000-10-05 13:14:58 +08:00
|
|
|
join queries through nonexhaustive search.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.12) How do I perform regular expression searches and case-insensitive
|
2001-05-11 09:33:01 +08:00
|
|
|
regular expression searches? How do I use an index for case-insensitive
|
|
|
|
searches?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-10-05 13:14:58 +08:00
|
|
|
The ~ operator does regular expression matching, and ~* does
|
2001-01-23 09:11:06 +08:00
|
|
|
case-insensitive regular expression matching. The case-insensitive
|
2002-07-12 00:38:08 +08:00
|
|
|
variant of LIKE is called ILIKE.
|
2001-01-23 09:11:06 +08:00
|
|
|
|
2001-05-11 09:33:01 +08:00
|
|
|
Case-insensitive equality comparisons are normally expressed as:
|
|
|
|
SELECT *
|
|
|
|
FROM tab
|
2002-10-14 11:15:33 +08:00
|
|
|
WHERE lower(col) = 'abc';
|
2001-05-11 09:33:01 +08:00
|
|
|
|
|
|
|
This will not use an standard index. However, if you create a
|
|
|
|
functional index, it will be used:
|
2002-10-14 11:15:33 +08:00
|
|
|
CREATE INDEX tabindex ON tab (lower(col));
|
2001-05-11 09:33:01 +08:00
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.13) In a query, how do I detect if a field is NULL?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
You test the column with IS NULL and IS NOT NULL.
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.14) What is the difference between the various character types?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
1996-10-04 01:15:56 +08:00
|
|
|
Type Internal Name Notes
|
1996-08-19 06:14:33 +08:00
|
|
|
--------------------------------------------------
|
2002-10-14 10:50:28 +08:00
|
|
|
VARCHAR(n) varchar size specifies maximum length, no padding
|
2003-01-13 02:36:22 +08:00
|
|
|
CHAR(n) bpchar blank padded to the specified fixed length
|
2000-12-01 02:46:42 +08:00
|
|
|
TEXT text no specific upper limit on length
|
2002-01-11 07:41:49 +08:00
|
|
|
BYTEA bytea variable-length byte array (null-byte safe)
|
2003-02-18 13:07:04 +08:00
|
|
|
"char" char one character
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2000-06-09 20:20:15 +08:00
|
|
|
You will see the internal name when examining system catalogs and in
|
|
|
|
some error messages.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2003-02-18 13:07:04 +08:00
|
|
|
The first four types above are "varlena" types (i.e., the first four
|
2000-12-09 12:29:38 +08:00
|
|
|
bytes on disk are the length, followed by the data). Thus the actual
|
|
|
|
space used is slightly greater than the declared size. However, these
|
2000-12-01 02:46:42 +08:00
|
|
|
data types are also subject to compression or being stored out-of-line
|
|
|
|
by TOAST, so the space on disk might also be less than expected.
|
2003-01-13 02:36:22 +08:00
|
|
|
VARCHAR(n) is best when storing variable-length strings and it limits
|
2001-10-13 13:27:05 +08:00
|
|
|
how long a string can be. TEXT is for strings of unlimited length,
|
2003-01-13 02:36:22 +08:00
|
|
|
with a maximum of one gigabyte.
|
2003-01-12 13:16:12 +08:00
|
|
|
|
|
|
|
CHAR(n) is for storing strings that are all the same length. CHAR(n)
|
2003-01-12 22:58:46 +08:00
|
|
|
pads with blanks to the specified length, while VARCHAR(n) only stores
|
|
|
|
the characters supplied. BYTEA is for storing binary data,
|
2003-02-18 13:07:04 +08:00
|
|
|
particularly values that include NULL bytes. All the types described
|
|
|
|
here have similar performance characteristics.
|
2001-10-13 09:32:47 +08:00
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.15.1) How do I create a serial/auto-incrementing field?
|
2000-03-23 14:30:58 +08:00
|
|
|
|
2000-07-26 10:20:02 +08:00
|
|
|
PostgreSQL supports a SERIAL data type. It auto-creates a sequence and
|
2000-07-21 04:13:15 +08:00
|
|
|
index on the column. For example, this:
|
2000-12-09 12:29:38 +08:00
|
|
|
CREATE TABLE person (
|
|
|
|
id SERIAL,
|
|
|
|
name TEXT
|
|
|
|
);
|
2000-03-23 14:30:58 +08:00
|
|
|
|
2000-07-21 04:13:15 +08:00
|
|
|
is automatically translated into this:
|
2000-12-09 12:29:38 +08:00
|
|
|
CREATE SEQUENCE person_id_seq;
|
|
|
|
CREATE TABLE person (
|
|
|
|
id INT4 NOT NULL DEFAULT nextval('person_id_seq'),
|
|
|
|
name TEXT
|
|
|
|
);
|
|
|
|
CREATE UNIQUE INDEX person_id_key ON person ( id );
|
2000-03-23 14:30:58 +08:00
|
|
|
|
|
|
|
See the create_sequence manual page for more information about
|
2000-07-27 00:54:58 +08:00
|
|
|
sequences. You can also use each row's OID field as a unique value.
|
2000-03-23 14:30:58 +08:00
|
|
|
However, if you need to dump and reload the database, you need to use
|
2000-07-27 00:54:58 +08:00
|
|
|
pg_dump's -o option or COPY WITH OIDS option to preserve the OIDs.
|
2000-03-23 14:30:58 +08:00
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.15.2) How do I get the value of a SERIAL insert?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
One approach is to retrieve the next SERIAL value from the sequence
|
2000-07-26 10:20:02 +08:00
|
|
|
object with the nextval() function before inserting and then insert it
|
2002-10-14 10:50:28 +08:00
|
|
|
explicitly. Using the example table in 4.15.1, an example in a
|
|
|
|
pseudo-language would look like this:
|
|
|
|
new_id = execute("SELECT nextval('person_id_seq')");
|
|
|
|
execute("INSERT INTO person (id, name) VALUES (new_id, 'Blaise Pascal')");
|
2000-03-23 14:30:58 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
You would then also have the new value stored in new_id for use in
|
|
|
|
other queries (e.g., as a foreign key to the person table). Note that
|
|
|
|
the name of the automatically created SEQUENCE object will be named
|
|
|
|
<table>_<serialcolumn>_seq, where table and serialcolumn are the names
|
|
|
|
of your table and your SERIAL column, respectively.
|
2000-03-23 14:30:58 +08:00
|
|
|
|
2000-10-05 13:14:58 +08:00
|
|
|
Alternatively, you could retrieve the assigned SERIAL value with the
|
|
|
|
currval() function after it was inserted by default, e.g.,
|
2002-10-14 10:50:28 +08:00
|
|
|
execute("INSERT INTO person (name) VALUES ('Blaise Pascal')");
|
|
|
|
new_id = execute("SELECT currval('person_id_seq')");
|
2000-03-23 14:30:58 +08:00
|
|
|
|
2000-07-27 00:54:58 +08:00
|
|
|
Finally, you could use the OID returned from the INSERT statement to
|
2000-10-05 13:14:58 +08:00
|
|
|
look up the default value, though this is probably the least portable
|
2003-09-02 00:47:58 +08:00
|
|
|
approach, and the oid value will wrap around when it reaches 4
|
|
|
|
billion. In Perl, using DBI with Edmund Mergl's DBD::Pg module, the
|
2000-03-23 14:30:58 +08:00
|
|
|
oid value is made available via $sth->{pg_oid_status} after
|
|
|
|
$sth->execute().
|
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.15.3) Don't currval() and nextval() lead to a race condition with other
|
2000-07-27 00:54:58 +08:00
|
|
|
users?
|
2000-03-23 14:30:58 +08:00
|
|
|
|
2002-10-14 10:50:28 +08:00
|
|
|
No. currval() returns the current value assigned by your backend, not
|
2001-10-13 11:53:45 +08:00
|
|
|
by all users.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-02-13 01:14:55 +08:00
|
|
|
4.15.4) Why aren't my sequence numbers reused on transaction abort? Why are
|
2002-02-13 01:18:10 +08:00
|
|
|
there gaps in the numbering of my sequence/SERIAL column?
|
2002-02-13 01:14:55 +08:00
|
|
|
|
|
|
|
To improve concurrency, sequence values are given out to running
|
2002-02-13 01:18:10 +08:00
|
|
|
transactions as needed and are not locked until the transaction
|
2002-02-13 01:14:55 +08:00
|
|
|
completes. This causes gaps in numbering from aborted transactions.
|
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.16) What is an OID? What is a TID?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2000-07-26 10:20:02 +08:00
|
|
|
OIDs are PostgreSQL's answer to unique row ids. Every row that is
|
2000-07-27 00:54:58 +08:00
|
|
|
created in PostgreSQL gets a unique OID. All OIDs generated during
|
2002-10-14 10:50:28 +08:00
|
|
|
initdb are less than 16384 (from include/access/transam.h). All
|
2000-10-05 13:14:58 +08:00
|
|
|
user-created OIDs are equal to or greater than this. By default, all
|
|
|
|
these OIDs are unique not only within a table or database, but unique
|
1998-10-24 12:43:39 +08:00
|
|
|
within the entire PostgreSQL installation.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2000-07-27 00:54:58 +08:00
|
|
|
PostgreSQL uses OIDs in its internal system tables to link rows
|
|
|
|
between tables. These OIDs can be used to identify specific user rows
|
|
|
|
and used in joins. It is recommended you use column type OID to store
|
|
|
|
OID values. You can create an index on the OID field for faster
|
2000-07-26 10:20:02 +08:00
|
|
|
access.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
OIDs are assigned to all new rows from a central area that is used by
|
2000-07-27 00:54:58 +08:00
|
|
|
all databases. If you want to change the OID to something else, or if
|
2002-01-11 07:07:07 +08:00
|
|
|
you want to make a copy of the table, with the original OIDs, there is
|
|
|
|
no reason you can't do it:
|
1999-06-05 11:43:07 +08:00
|
|
|
CREATE TABLE new_table(old_oid oid, mycol int);
|
2000-07-26 10:20:02 +08:00
|
|
|
SELECT old_oid, mycol INTO new FROM old;
|
1999-06-05 11:43:07 +08:00
|
|
|
COPY new TO '/tmp/pgtable';
|
|
|
|
DELETE FROM new;
|
|
|
|
COPY new WITH OIDS FROM '/tmp/pgtable';
|
1998-08-30 12:01:31 +08:00
|
|
|
|
2000-07-28 03:22:20 +08:00
|
|
|
OIDs are stored as 4-byte integers, and will overflow at 4 billion. No
|
2000-07-28 04:26:55 +08:00
|
|
|
one has reported this ever happening, and we plan to have the limit
|
2000-07-28 03:22:20 +08:00
|
|
|
removed before anyone does.
|
|
|
|
|
2000-07-27 00:54:58 +08:00
|
|
|
TIDs are used to identify specific physical rows with block and offset
|
2002-01-11 07:07:07 +08:00
|
|
|
values. TIDs change after rows are modified or reloaded. They are used
|
1999-06-05 11:43:07 +08:00
|
|
|
by index entries to point to physical rows.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.17) What is the meaning of some of the terms used in PostgreSQL?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
1998-02-28 23:08:15 +08:00
|
|
|
Some of the source code and older documentation use terms that have
|
|
|
|
more common usage. Here are some:
|
2000-03-23 14:30:58 +08:00
|
|
|
* table, relation, class
|
1998-02-28 23:08:15 +08:00
|
|
|
* row, record, tuple
|
2000-03-23 14:30:58 +08:00
|
|
|
* column, field, attribute
|
1998-02-28 23:08:15 +08:00
|
|
|
* retrieve, select
|
|
|
|
* replace, update
|
|
|
|
* append, insert
|
2000-07-27 00:54:58 +08:00
|
|
|
* OID, serial value
|
1998-02-28 23:08:15 +08:00
|
|
|
* portal, cursor
|
|
|
|
* range variable, table name, table alias
|
|
|
|
|
2000-09-30 11:04:39 +08:00
|
|
|
A list of general database terms can be found at:
|
2002-10-14 10:50:28 +08:00
|
|
|
http://hea-www.harvard.edu/MST/simul/software/docs/pkgs/pgsql/glossary
|
|
|
|
/glossary.html
|
2000-09-30 11:04:39 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
4.18) Why do I get the error "ERROR: Memory exhausted in AllocSetAlloc()"?
|
2001-02-16 06:21:23 +08:00
|
|
|
|
2002-07-12 00:38:08 +08:00
|
|
|
You probably have run out of virtual memory on your system, or your
|
|
|
|
kernel has a low limit for certain resources. Try this before starting
|
|
|
|
postmaster:
|
2001-02-16 06:21:23 +08:00
|
|
|
ulimit -d 262144
|
|
|
|
limit datasize 256m
|
|
|
|
|
|
|
|
Depending on your shell, only one of these may succeed, but it will
|
|
|
|
set your process data segment limit much higher and perhaps allow the
|
|
|
|
query to complete. This command applies to the current process, and
|
|
|
|
all subprocesses created after the command is run. If you are having a
|
|
|
|
problem with the SQL client because the backend is returning too much
|
|
|
|
data, try it before starting the client.
|
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.19) How do I tell what PostgreSQL version I am running?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-10-14 10:50:28 +08:00
|
|
|
From psql, type SELECT version();
|
1999-09-28 13:09:56 +08:00
|
|
|
|
2002-01-11 07:07:07 +08:00
|
|
|
4.20) Why does my large-object operations get "invalid large obj
|
|
|
|
descriptor"?
|
1999-09-28 13:09:56 +08:00
|
|
|
|
|
|
|
You need to put BEGIN WORK and COMMIT around any use of a large object
|
|
|
|
handle, that is, surrounding lo_open ... lo_close.
|
|
|
|
|
2000-07-26 10:20:02 +08:00
|
|
|
Currently PostgreSQL enforces the rule by closing large object handles
|
|
|
|
at transaction commit. So the first attempt to do anything with the
|
|
|
|
handle will draw invalid large obj descriptor. So code that used to
|
|
|
|
work (at least most of the time) will now generate that error message
|
|
|
|
if you fail to use a transaction.
|
1999-09-28 13:09:56 +08:00
|
|
|
|
|
|
|
If you are using a client interface like ODBC you may need to set
|
|
|
|
auto-commit off.
|
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.21) How do I create a column that will default to the current time?
|
1999-09-28 13:09:56 +08:00
|
|
|
|
2001-11-12 15:38:57 +08:00
|
|
|
Use CURRENT_TIMESTAMP:
|
|
|
|
CREATE TABLE test (x int, modtime timestamp DEFAULT CURRENT_TIMESTAMP );
|
2000-03-23 14:30:58 +08:00
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.22) Why are my subqueries using IN so slow?
|
2000-03-23 14:30:58 +08:00
|
|
|
|
2000-10-05 13:14:58 +08:00
|
|
|
Currently, we join subqueries to outer queries by sequentially
|
2002-10-10 11:15:19 +08:00
|
|
|
scanning the result of the subquery for each row of the outer query.
|
|
|
|
If the subquery returns only a few rows and the outer query returns
|
|
|
|
many rows, IN is fastest. To speed up other queries, replace IN with
|
|
|
|
EXISTS:
|
2002-10-14 10:50:28 +08:00
|
|
|
SELECT *
|
2000-12-09 12:29:38 +08:00
|
|
|
FROM tab
|
2002-10-14 10:50:28 +08:00
|
|
|
WHERE col IN (SELECT subcol FROM subtab);
|
2000-03-23 14:30:58 +08:00
|
|
|
|
|
|
|
to:
|
2002-10-14 10:50:28 +08:00
|
|
|
SELECT *
|
2000-12-09 12:29:38 +08:00
|
|
|
FROM tab
|
2002-10-14 10:50:28 +08:00
|
|
|
WHERE EXISTS (SELECT subcol FROM subtab WHERE subcol = col);
|
1999-09-28 13:09:56 +08:00
|
|
|
|
2003-01-26 10:43:55 +08:00
|
|
|
For this to be fast, subcol should be an indexed column. This
|
|
|
|
preformance problem will be fixed in 7.4.
|
2000-06-13 16:07:50 +08:00
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.23) How do I perform an outer join?
|
2000-06-13 16:07:50 +08:00
|
|
|
|
2002-07-12 00:38:08 +08:00
|
|
|
PostgreSQL supports outer joins using the SQL standard syntax. Here
|
|
|
|
are two examples:
|
2001-01-22 14:27:41 +08:00
|
|
|
SELECT *
|
|
|
|
FROM t1 LEFT OUTER JOIN t2 ON (t1.col = t2.col);
|
|
|
|
|
|
|
|
or
|
2001-01-22 13:56:26 +08:00
|
|
|
SELECT *
|
|
|
|
FROM t1 LEFT OUTER JOIN t2 USING (col);
|
|
|
|
|
2001-01-23 00:35:35 +08:00
|
|
|
These identical queries join t1.col to t2.col, and also return any
|
|
|
|
unjoined rows in t1 (those with no match in t2). A RIGHT join would
|
|
|
|
add unjoined rows of t2. A FULL join would return the matched rows
|
|
|
|
plus all unjoined rows from t1 and t2. The word OUTER is optional and
|
|
|
|
is assumed in LEFT, RIGHT, and FULL joins. Ordinary joins are called
|
|
|
|
INNER joins.
|
2001-01-22 14:27:41 +08:00
|
|
|
|
2001-01-22 13:56:26 +08:00
|
|
|
In previous releases, outer joins can be simulated using UNION and NOT
|
|
|
|
IN. For example, when joining tab1 and tab2, the following query does
|
|
|
|
an outer join of the two tables:
|
2000-12-09 12:29:38 +08:00
|
|
|
SELECT tab1.col1, tab2.col2
|
|
|
|
FROM tab1, tab2
|
|
|
|
WHERE tab1.col1 = tab2.col1
|
|
|
|
UNION ALL
|
|
|
|
SELECT tab1.col1, NULL
|
|
|
|
FROM tab1
|
|
|
|
WHERE tab1.col1 NOT IN (SELECT tab2.col1 FROM tab2)
|
2001-01-23 01:20:12 +08:00
|
|
|
ORDER BY col1
|
2001-09-04 23:40:18 +08:00
|
|
|
|
2002-01-04 13:44:45 +08:00
|
|
|
4.24) How do I perform queries using multiple databases?
|
2001-09-04 23:40:18 +08:00
|
|
|
|
2002-10-11 13:02:24 +08:00
|
|
|
There is no way to query a database other than the current one.
|
|
|
|
Because PostgreSQL loads database-specific system catalogs, it is
|
|
|
|
uncertain how a cross-database query should even behave.
|
2001-09-04 23:40:18 +08:00
|
|
|
|
2002-10-21 08:47:44 +08:00
|
|
|
contrib/dblink allows cross-database queries using function calls. Of
|
2002-10-11 13:02:24 +08:00
|
|
|
course, a client can make simultaneous connections to different
|
|
|
|
databases and merge the results on the client side.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2002-04-09 11:22:11 +08:00
|
|
|
4.25) How do I return multiple rows or columns from a function?
|
|
|
|
|
2003-03-18 03:53:08 +08:00
|
|
|
In 7.3, you can easily return multiple rows or columns from a
|
|
|
|
function, http://techdocs.postgresql.org/guides/SetReturningFunctions.
|
2002-04-09 11:22:11 +08:00
|
|
|
|
2002-06-11 03:47:57 +08:00
|
|
|
4.26) Why can't I reliably create/drop temporary tables in PL/PgSQL
|
|
|
|
functions?
|
|
|
|
|
|
|
|
PL/PgSQL caches function contents, and an unfortunate side effect is
|
|
|
|
that if a PL/PgSQL function accesses a temporary table, and that table
|
|
|
|
is later dropped and recreated, and the function called again, the
|
|
|
|
function will fail because the cached function contents still point to
|
|
|
|
the old temporary table. The solution is to use EXECUTE for temporary
|
|
|
|
table access in PL/PgSQL. This will cause the query to be reparsed
|
|
|
|
every time.
|
2002-10-11 13:02:24 +08:00
|
|
|
|
|
|
|
4.27) What replication options are available?
|
|
|
|
|
2002-10-12 01:55:17 +08:00
|
|
|
There are several master/slave replication options available. These
|
2002-10-11 13:02:24 +08:00
|
|
|
allow only the master to make database changes and the slave can only
|
|
|
|
do database reads. The bottom of
|
2002-10-14 10:50:28 +08:00
|
|
|
http://gborg.PostgreSQL.org/genpage?replication_research lists them. A
|
2002-10-11 13:02:24 +08:00
|
|
|
multi-master replication solution is being worked on at
|
2002-10-14 10:50:28 +08:00
|
|
|
http://gborg.PostgreSQL.org/project/pgreplication/projdisplay.php.
|
2002-10-11 13:02:24 +08:00
|
|
|
|
2002-10-14 10:50:28 +08:00
|
|
|
4.28) What encryption options are available?
|
2002-10-11 13:02:24 +08:00
|
|
|
|
2002-10-21 08:47:44 +08:00
|
|
|
* contrib/pgcrypto contains many encryption functions for use in SQL
|
|
|
|
queries.
|
2003-07-26 06:07:44 +08:00
|
|
|
* To encrypt transmission from the client to the server, the server
|
|
|
|
must have the ssl option set to true in postgresql.conf, and an
|
|
|
|
applicable host or hostssl record must exist in pg_hba.conf, and
|
|
|
|
the client sslmode must not be disable. (Note that it is also
|
|
|
|
possible to use a third-party encrypted transport, such as stunnel
|
|
|
|
or ssh, rather than PostgreSQL's native SSL connections.)
|
2002-10-11 13:02:24 +08:00
|
|
|
* Database user passwords are automatically encrypted when stored in
|
2002-10-14 10:50:28 +08:00
|
|
|
version 7.3. In previous versions, you must enable the option
|
|
|
|
PASSWORD_ENCRYPTION in postgresql.conf.
|
2002-10-12 01:55:17 +08:00
|
|
|
* The server can run using an encrypted file system.
|
2002-06-11 03:49:59 +08:00
|
|
|
_________________________________________________________________
|
2002-06-11 03:47:57 +08:00
|
|
|
|
1999-07-11 00:28:02 +08:00
|
|
|
Extending PostgreSQL
|
|
|
|
|
|
|
|
5.1) I wrote a user-defined function. When I run it in psql, why does it
|
|
|
|
dump core?
|
|
|
|
|
1998-02-28 23:08:15 +08:00
|
|
|
The problem could be a number of things. Try testing your user-defined
|
2000-10-05 13:14:58 +08:00
|
|
|
function in a stand-alone test program first.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2001-02-16 06:15:10 +08:00
|
|
|
5.2) How can I contribute some nifty new types and functions to PostgreSQL?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
|
|
|
Send your extensions to the pgsql-hackers mailing list, and they will
|
|
|
|
eventually end up in the contrib/ subdirectory.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2001-02-16 06:15:10 +08:00
|
|
|
5.3) How do I write a C function to return a tuple?
|
1999-07-11 00:28:02 +08:00
|
|
|
|
2002-10-18 07:34:10 +08:00
|
|
|
In versions of PostgreSQL beginning with 7.3, table-returning
|
|
|
|
functions are fully supported in C, PL/PgSQL, and SQL. See the
|
|
|
|
Programmer's Guide for more information. An example of a
|
|
|
|
table-returning function defined in C can be found in
|
|
|
|
contrib/tablefunc.
|
1998-02-28 23:08:15 +08:00
|
|
|
|
2001-02-16 06:15:10 +08:00
|
|
|
5.4) I have changed a source file. Why does the recompile not see the
|
1999-07-11 00:28:02 +08:00
|
|
|
change?
|
|
|
|
|
|
|
|
The Makefiles do not have the proper dependencies for include files.
|
2001-01-22 06:16:56 +08:00
|
|
|
You have to do a make clean and then another make. If you are using
|
|
|
|
GCC you can use the --enable-depend option of configure to have the
|
|
|
|
compiler compute the dependencies automatically.
|