diff --git a/doc/FAQ b/doc/FAQ index bf5dda1ab41..fd0965a79f0 100644 --- a/doc/FAQ +++ b/doc/FAQ @@ -1,7 +1,7 @@ Frequently Asked Questions (FAQ) for PostgreSQL - Last updated: Sat Oct 19 22:58:02 EDT 2002 + Last updated: Sun Oct 20 20:47:14 EDT 2002 Current maintainer: Bruce Momjian (pgman@candle.pha.pa.us) @@ -339,7 +339,7 @@ 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 - to MySQL at http://openacs.org/why-not-mysql.html + to MySQL at http://openacs.org/philosophy/why-not-mysql.html Reliability We realize that a DBMS must be reliable, or it is worthless. We @@ -596,12 +596,12 @@ was 64, and changing it required a rebuild after altering the MaxBackendId constant in include/storage/sinvaladt.h. - 3.9) What are the pgsql_tmp directory? + 3.9) What is in 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. + 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. The temporary files are usually deleted automatically, but might remain if a backend crashes during a sort. A stop and restart of the @@ -758,19 +758,16 @@ When using wild-card operators such as LIKE or ~, indexes can only be used in certain circumstances: * The beginning of the search string must be anchored to the start - of the string, i.e.: + 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. - * 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. - 4.9) How do I see how the query optimizer is evaluating my query? See the EXPLAIN manual page. @@ -1057,7 +1054,7 @@ CREATE TABLE test (x int, modtime timestamp DEFAULT CURRENT_TIMESTAMP ); Because PostgreSQL loads database-specific system catalogs, it is uncertain how a cross-database query should even behave. - /contrib/dblink allows cross-database queries using function calls. Of + contrib/dblink allows cross-database queries using function calls. Of course, a client can make simultaneous connections to different databases and merge the results on the client side. @@ -1089,8 +1086,8 @@ CREATE TABLE test (x int, modtime timestamp DEFAULT CURRENT_TIMESTAMP ); 4.28) What encryption options are available? - * /contrib/pgcrypto contains many encryption functions for use in - SQL queries. + * contrib/pgcrypto contains many encryption functions for use in SQL + queries. * The only way to encrypt transmission from the client to the server is by using hostssl in pg_hba.conf. * Database user passwords are automatically encrypted when stored in diff --git a/doc/src/FAQ/FAQ.html b/doc/src/FAQ/FAQ.html index be9c1425124..8e49793ca54 100644 --- a/doc/src/FAQ/FAQ.html +++ b/doc/src/FAQ/FAQ.html @@ -1,12 +1,8 @@ - - + - - - - + PostgreSQL FAQ @@ -14,7 +10,7 @@ alink="#0000ff">

Frequently Asked Questions (FAQ) for PostgreSQL

-

Last updated: Sat Oct 19 22:58:02 EDT 2002

+

Last updated: Sun Oct 20 20:47:14 EDT 2002

Current maintainer: Bruce Momjian (pgman@candle.pha.pa.us)
@@ -80,9 +76,9 @@ clients" when trying to connect?
3.9) What is in the pgsql_tmp directory?
- 3.10) Why do I need to do a dump and restore + 3.10) Why do I need to do a dump and restore to upgrade PostgreSQL releases?
- +

Operational Questions

4.1) What is the difference between binary @@ -440,9 +436,8 @@ 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 to - MySQL at - - http://openacs.org/why-not-mysql.html
+ MySQL at + http://openacs.org/philosophy/why-not-mysql.html

@@ -653,7 +648,7 @@

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, + 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 @@ -721,7 +716,7 @@

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 + postgres PID. You can set breakpoints in the debugger and issue queries from psql. If you are debugging postgres startup, you can set PGOPTIONS="-W n", then start psql. This will cause startup to delay for n seconds @@ -759,7 +754,7 @@ maximum number of processes, NPROC; the maximum number of processes per user, MAXUPRC; and the maximum number of open files, NFILE and - NINODE. The reason that PostgreSQL has a limit on + NINODE. The reason that PostgreSQL has a limit on the number of allowed backend processes is so your system won't run out of resources.

@@ -768,14 +763,13 @@ the MaxBackendId constant in include/storage/sinvaladt.h.

-

3.9) What are the pgsql_tmp - directory?

+

3.9) What is in 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.

+

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.

The temporary files are usually deleted automatically, but might remain if a backend crashes during a sort. A stop and restart of the @@ -815,7 +809,7 @@

The entire query may have to be evaluated, even if you only want the first few rows. Consider using a query that has an ORDER - BY. If there is an index that matches the 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.

@@ -955,22 +949,22 @@

When using wild-card operators such as LIKE or - ~, indexes can only be used in certain circumstances: + ~, indexes can only be used in certain circumstances:

  • 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.
    • + initdb.

    @@ -1342,7 +1336,7 @@ BYTEA bytea variable-length byte array (null-byte safe) Because PostgreSQL loads database-specific system catalogs, it is uncertain how a cross-database query should even behave.

    -

    /contrib/dblink allows cross-database queries using +

    contrib/dblink allows cross-database queries using function calls. Of course, a client can make simultaneous connections to different databases and merge the results on the client side.

    @@ -1379,13 +1373,13 @@ BYTEA bytea variable-length byte array (null-byte safe)

    4.28) What encryption options are available?

    @@ -1413,7 +1407,7 @@ BYTEA bytea variable-length byte array (null-byte safe) 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.

    + contrib/tablefunc.

    5.4) I have changed a source file. Why does the recompile not see the change?