Commit Graph

5380 Commits

Author SHA1 Message Date
Tom Lane
768b647ead Now that I look, table 8-1 has some other marginal misstatements in it.
If we're going to put brackets around optional precision specs in some
entries, we'd better do it in all.
2004-09-20 04:19:50 +00:00
Neil Conway
f6279e9ed7 Minor documentation cleanup and improvement. 2004-09-20 00:04:19 +00:00
Tom Lane
089fb6c4ce Put the brackets in the right places in timestamp entries in table 8-1.
Spotted by Josh Purinton.
2004-09-18 15:28:03 +00:00
Tom Lane
f6d278364e Improve documentation of log rotation options, per Ed L. 2004-09-17 22:40:46 +00:00
Peter Eisentraut
152a101f2b Allow WIN1250 as server encoding. 2004-09-17 21:59:57 +00:00
Neil Conway
12ce26f8da Hyperlink a reference to DROP CAST in the CREATE CAST reference page. 2004-09-17 02:06:33 +00:00
Neil Conway
42c0d1f3cd Minor doc tweak: mention that function names can be optionally schema-
qualified.
2004-09-16 04:16:08 +00:00
Bruce Momjian
1459d8c4b0 Mark as done:
< * Point-in-time data recovery using backup and write-ahead log,
< * Create native Win32 port, http://momjian.postgresql.org/main/writings/pgsql/project/win32.html
> * -Point-in-time data recovery using backup and write-ahead log
> * -Create native Win32 port
470c470
<     o Fix PL/pgSQL RENAME to work on variables other than OLD/NEW
> 	o Fix PL/pgSQL RENAME to work on variables other than OLD/NEW
2004-09-14 14:34:45 +00:00
Tom Lane
b2c4071299 Redesign query-snapshot timing so that volatile functions in READ COMMITTED
mode see a fresh snapshot for each command in the function, rather than
using the latest interactive command's snapshot.  Also, suppress fresh
snapshots as well as CommandCounterIncrement inside STABLE and IMMUTABLE
functions, instead using the snapshot taken for the most closely nested
regular query.  (This behavior is only sane for read-only functions, so
the patch also enforces that such functions contain only SELECT commands.)
As per my proposal of 6-Sep-2004; I note that I floated essentially the
same proposal on 19-Jun-2002, but that discussion tailed off without any
action.  Since 8.0 seems like the right place to be taking possibly
nontrivial backwards compatibility hits, let's get it done now.
2004-09-13 20:10:13 +00:00
Bruce Momjian
8a54a51863 Done:
< * Have AFTER triggers execute after the appropriate SQL statement in a
> * -Have AFTER triggers execute after the appropriate SQL statement in a
2004-09-10 22:38:52 +00:00
Tom Lane
b339d1fff6 Fire non-deferred AFTER triggers immediately upon query completion,
rather than when returning to the idle loop.  This makes no particular
difference for interactively-issued queries, but it makes a big difference
for queries issued within functions: trigger execution now occurs before
the calling function is allowed to proceed.  This responds to numerous
complaints about nonintuitive behavior of foreign key checking, such as
http://archives.postgresql.org/pgsql-bugs/2004-09/msg00020.php, and
appears to be required by the SQL99 spec.
Also take the opportunity to simplify the data structures used for the
pending-trigger list, rename them for more clarity, and squeeze out a
bit of space.
2004-09-10 18:40:09 +00:00
Bruce Momjian
856d1faac1 Add:
> * Make row-wise comparisons work per SQL spec
>
2004-09-10 16:35:56 +00:00
Bruce Momjian
594be448e1 Add:
> * Remove Win32 rename/unlink looping if unnecessary
2004-09-10 10:03:41 +00:00
Tom Lane
b1c4bdae74 Clarify description of SET CONSTRAINTS. Point out that it is still
missing the ability to schema-qualify constraint names.
2004-09-08 20:47:37 +00:00
Tom Lane
3cc21343dc FAQ_HPUX updates from Shinji Teragaito. 2004-09-02 17:46:24 +00:00
Bruce Momjian
c58eb2dd7b Add:
> * Consider using hash buckets to do DISTINCT, rather than sorting
>
>   This would be beneficial when there are few distinct values.
2004-09-02 01:18:46 +00:00
Tom Lane
0b143dd725 Remove a stray reference to sequences as having tablespaces. 2004-09-01 14:09:19 +00:00
Tom Lane
3ff8cc45ad Add a note about the difference between Postgres' treatment of the rights
of an object owner and the SQL spec's treatment of these rights.
2004-09-01 04:13:11 +00:00
Bruce Momjian
90e1ac9292 Add index mention:
<P>In pre-8.0 releases, indexes often can not be used unless the data
    types exactly match the index's column types.  This is particularly
    true of int2, int8, and numeric column indexes.</P>
2004-09-01 03:28:15 +00:00
Tom Lane
8c603f2c95 Replace log_filename_prefix with more general log_filename parameter,
to allow DBA to choose the form in which log filenames reflect the
current time.  Also allow for truncating instead of appending to
pre-existing files --- this is convenient when the log filename pattern
rewrites the same names cyclically.  Per Ed L.
2004-08-31 04:53:44 +00:00
Tom Lane
26b7c04b37 Avoid ambiguity, as per suggestion from Peter Stricker. 2004-08-30 21:29:12 +00:00
Tom Lane
8226f503ef Rather than referring to src/tutorial/README, put the build instructions
for the tutorial files right here.
2004-08-30 21:25:27 +00:00
Bruce Momjian
af8406bb2a Remove item because it is on the open item list:
< * Fix oid2name and dbsize for tablespaces
2004-08-30 16:08:20 +00:00
Tom Lane
166300f318 Add note that contrib/rserv is gone. 2004-08-30 00:47:31 +00:00
Tom Lane
79abc3b0de Add explicit note that empty-string array element values now have to
be written with quotes.  Minor copy-editing too.
2004-08-30 00:33:52 +00:00
Tom Lane
50742aed68 Add WAL logging for CREATE/DROP DATABASE and CREATE/DROP TABLESPACE.
Fix TablespaceCreateDbspace() to be able to create a dummy directory
in place of a dropped tablespace's symlink.  This eliminates the open
problem of a PANIC during WAL replay when a replayed action attempts
to touch a file in a since-deleted tablespace.  It also makes for a
significant improvement in the usability of PITR replay.
2004-08-29 21:08:48 +00:00
Bruce Momjian
ef16b4e157 Update wording:
< 	This would require some background daemon to maintain clustering
> 	This might require some background daemon to maintain clustering
397,398c397,398
< 	paritally filled for easier reorganization.  It also might require
< 	creating a merged heap/index data file so an index lookup would
> 	paritally filled for easier reorganization.  Another idea would
>         be to create a merged heap/index data file so an index lookup would
2004-08-27 04:34:28 +00:00
Bruce Momjian
968b87686a Update win32 comments. 2004-08-27 02:09:18 +00:00
Bruce Momjian
3bc7564cf9 Update:
< 	This would require some background daemon to restore clustering
> 	This would require some background daemon to maintain clustering
397c397,399
< 	paritally filled for easier reorganization.
> 	paritally filled for easier reorganization.  It also might require
> 	creating a merged heap/index data file so an index lookup would
> 	automatically access the heap data too.
2004-08-27 01:44:49 +00:00
Bruce Momjian
dd9923eb25 New Win32 wording that mentions "code". 2004-08-26 16:54:36 +00:00
Bruce Momjian
32142e2a60 Update documentation to prefer CIDR format for pg_hba.conf and use new
CIDR column in examples first.
2004-08-26 16:50:05 +00:00
Bruce Momjian
8ec3221d32 Update Win32 wording. 2004-08-26 13:44:38 +00:00
Bruce Momjian
cf5dd06755 Add warning about Win32 bugs in this release. 2004-08-26 13:08:59 +00:00
Bruce Momjian
ce8a4ffca6 Update Japanese FAQ.
Jun Kuwamura
2004-08-26 04:09:59 +00:00
Bruce Momjian
4b9ca271d6 Update tcp connection faq. 2004-08-26 03:18:25 +00:00
Bruce Momjian
93c3baa96f Add:
> * Merge hardwired timezone names with the TZ database; allow either kind
>   everywhere a TZ name is currently taken
> * Allow customization of the known set of TZ names (generalize the
>   present australian_timezones hack)
2004-08-26 03:09:13 +00:00
Bruce Momjian
4359ebed37 Update item:
< * Implement dirty reads or shared row locks and use them in RI triggers (?)
> * Implement dirty reads or shared row locks and use them in RI triggers
>
>   Adding shared locks requires recording the table/rows numbers in a
>   shared area, and this could potentially be a large amount of data.
>   One idea is to store the table/row numbers in a separate table and set
>   a bit on the row indicating looking in this new table is required to
>   find any shared row locks.
>
2004-08-24 11:09:44 +00:00
Neil Conway
cda1bd6cfe Various minor improvements to the SGML documentation: fix some incorrect
SGML markup, add a "deprecated features" section to the 8.0 release
notes, untabify release.sgml and runtime.sgml, and make some other
minor improvements.
2004-08-24 00:06:51 +00:00
Bruce Momjian
059912ce2e Mention removal of page images in PITR files:
<   partial page writes during recovery.
>   partial page writes during recovery.  These pages can also be
>   eliminated from point-in-time archive files.
2004-08-23 21:56:50 +00:00
Bruce Momjian
728026a6bc Update that 8.0 will support MS Win natively. 2004-08-23 21:51:53 +00:00
Bruce Momjian
1549f5e440 Update newest version number. 2004-08-23 16:16:43 +00:00
Tom Lane
bebbbde6aa Seems it would be nice if the ALTER INDEX ref page were actually
linked into the docs ...
2004-08-21 16:16:04 +00:00
Tom Lane
c1700bf8c0 Fix typo (extraneous comma). 2004-08-21 15:45:46 +00:00
Bruce Momjian
ade9cbafdf Mention that to_char(interval) will be removed in 8.1. 2004-08-21 03:25:34 +00:00
Bruce Momjian
ff8e5526dd Add ALTER SCHEMA item detail:
< 	o Allow databases, schemas, and indexes to be moved to different
< 	  tablespaces
> 	o Allow databases and schemas to be moved to different tablespaces
>
> 	One complexity is whether moving a schema should move all existing
> 	schema objects or just define the location for future object creation.
>
382c385
< 	o Add ALTER INDEX that works just like ALTER TABLE already does
> 	o -Add ALTER INDEX that works just like ALTER TABLE already does
384d386
< 	o Add ALTER INDEX syntax to work like ALTER TABLE indexname
2004-08-20 20:07:12 +00:00
Bruce Momjian
a9ed7476a0 Add psql tab completion TODO:
< * -Have psql \dn show only visible temp schemas using current_schemas()
< * -Have psql '\i ~/<tab><tab>' actually load files it displays from home dir
484a483,484
> * -Have psql \dn show only visible temp schemas using current_schemas()
> * -Have psql '\i ~/<tab><tab>' actually load files it displays from home dir
516a517,527
>
> * psql tab completion
>
> 	o Provide a list of conversions after ALTER CONVERSION?
> 	o Support for ALTER SEQUENCE clauses
> 	o Add RENAME TO to ALTER TRIGGER
> 	o Support for ALTER USER
> 	o Fix ALTER (GROUP|DOMAIN|...) <sth> DROP
> 	o Support for ALTER LANGUAGE <sth> RENAME TO
> 	o Improve support for COPY
> 	o Improve support for ALTER TABLE
2004-08-20 19:30:39 +00:00
Bruce Momjian
fcc5b95e0f Add mention of environment variable conflict with uncommenting config
file variables:

<   Another option is to allow commented values to return to their
<   default values.
>   This has to address environment variables that are then overridden
>   by config file values.  Another option is to allow commented values
>   to return to their default values.
2004-08-20 15:20:27 +00:00
Bruce Momjian
0bd5a8cd59 Fix typo in new ALTER INDEX manual page. 2004-08-20 14:56:57 +00:00
Bruce Momjian
09d4e96d7e Add ALTER INDEX, particularly for moving tablespaces.
Gavin Sherry
2004-08-20 04:29:33 +00:00
Bruce Momjian
daa076c4fd > Please find attached a submission to add a "exit on error" option to
> pg_restore, as it seems that some people have scripts that rely on the
> previous "abort on error" default behavior when restoring data with a
> direct connection.
>
> Fabien Coelho
2004-08-20 04:20:23 +00:00
Bruce Momjian
2674bbbe99 Add:
> * Add a function that returns the 'uptime' of the postmaster
2004-08-20 03:06:00 +00:00
Bruce Momjian
4d328bcd9c Update wording on commented postgresql.conf values:
>   Another option is to allow commented values to return to their
>   default values.
2004-08-19 22:25:09 +00:00
Bruce Momjian
040450beef Use backslash in %USERPROFILE%\.pgpass. 2004-08-19 16:39:13 +00:00
Bruce Momjian
04854a89ef Add:
> 	o Allow COPY to optionally include column headings as the first line
2004-08-19 02:36:24 +00:00
Bruce Momjian
84f878f5cd Don't use get_home_path so libpq doesn't pull path.c into the library. 2004-08-19 00:00:34 +00:00
Bruce Momjian
f657594bf7 Remove NT4 mention in release notes. 2004-08-18 15:48:36 +00:00
Bruce Momjian
7500704167 Remove as duplicate:
< 	o Allow pg_dumpall to use non-text output formats
2004-08-18 04:00:32 +00:00
Bruce Momjian
83f8fb7459 Add:
> * Move some /contrib modules out to their own project sites
2004-08-18 03:51:35 +00:00
Bruce Momjian
1f0a19c263 The enclose patch clarifies and makes a more useful example for the
Global Values in PL/Perl section of the documents.

David Fetter
2004-08-18 03:37:56 +00:00
Bruce Momjian
3d20578e93 Add pg_dump section:
< * -Allow pg_dump to dump CREATE CONVERSION (Christopher)
< * -Make pg_restore continue after errors, so it acts more like pg_dump scripts
485,486d482
< * Allow pg_dumpall to use non-text output formats
< * Have pg_dump use multi-statement transactions for INSERT dumps
493,496d488
< * Allow pg_dump to use multiple -t and -n switches
<
<   This should be done by allowing a '-t schema.table' syntax.
<
498a491,512
>
> * pg_dump
> 	o Allow pg_dumpall to use non-text output formats
> 	o Have pg_dump use multi-statement transactions for INSERT dumps
> 	o -Allow pg_dump to dump CREATE CONVERSION (Christopher)
> 	o -Make pg_restore continue after errors, so it acts more like pg_dump
> 	  scripts
> 	o Allow pg_dump to use multiple -t and -n switches
>
> 	  This should be done by allowing a '-t schema.table' syntax.
>
> 	o Add dumping of comments on composite type columns
> 	o Add dumping of comments on index columns
> 	o Replace crude DELETE FROM method of pg_dumpall for cleaning of
> 	  users and groups with separate DROP commands
> 	o Add dumping and restoring of LOB comments
> 	o Stop dumping CASCADE on DROP TYPE commands in clean mode
> 	o Add full object name to the tag field.  eg. for operators we need
> 	  '=(integer, integer)', instead of just '='.
> 	o Add pg_dumpall custom format dumps. This is probably best done by
> 	  combining pg_dump and pg_dumpall into a single binary
> 	o Add CSV output format
2004-08-18 03:19:42 +00:00
Bruce Momjian
af032f15da Replace incorrect example for quote_ident
Greg Sabino Mullan
2004-08-18 03:06:56 +00:00
Tom Lane
950c8afcb4 Update release history for 7.4.5. 2004-08-18 03:03:32 +00:00
Bruce Momjian
388ffad040 Add:
< * -Allow savepoints / nested transactions [transactions] (Alvaro)
> * -Allow savepoints / nested transactions (Alvaro)
348a349,353
> * Add an option to automatically use savepoints for each statement in a
>   multi-statement transaction.
>
>   When enabled, this would allow errors in multi-statement transactions
>   to be automatically ignored.
2004-08-17 17:14:56 +00:00
Bruce Momjian
f5f5d7bead Remove transactions TODO.detail. 2004-08-17 17:11:44 +00:00
Bruce Momjian
3f0fa93cfc Chain on to SIGPIPE handler rather than just do action on default.
Always create thread-specific variable.
2004-08-17 16:54:47 +00:00
Tom Lane
64410289f8 Add trivial NULL statement to plpgsql, for Oracle compatibility. 2004-08-16 17:52:06 +00:00
Bruce Momjian
bc91389df9 Add:
> 	o Add ALTER INDEX syntax to work like ALTER TABLE indexname
2004-08-16 16:14:31 +00:00
Bruce Momjian
fa82574bc5 Add:
> * Set proper permissions on non-system schemas during db creation
>
>   Currently all schemas are owned by the super-user because they are
>   copied from the template1 database.
>
2004-08-16 04:38:46 +00:00
Tom Lane
e617fe729d Mark server_encoding and integer_datetimes as GUC_REPORT, per previous
proposals by Oliver Jowett.  Update documentation.
2004-08-16 02:12:29 +00:00
Tom Lane
e76bcb855b Fix trivial typo. 2004-08-15 00:27:14 +00:00
Tom Lane
682d9fc774 Minor copy-editing for 7.4.4, 7.3.7, 7.2.5 release notes. 2004-08-15 00:09:24 +00:00
Tom Lane
d6b69cf2fc Fix typo, per Andreas Seltenreich. 2004-08-14 23:49:07 +00:00
Tom Lane
793dd8e729 Add discussion and example about predicate locking and why "serializable"
mode isn't really serializable.  I had thought this was covered already
in our docs, but I sure can't find it.
2004-08-14 22:18:23 +00:00
Tom Lane
11d8138ca3 Minor editorializing. 2004-08-14 22:17:08 +00:00
Bruce Momjian
0e0793a71a Add:
>
> * Allow buffered WAL writes and fsync
>
>   Instead of guaranteeing recovery of all committed transactions, this
>   would provide improved performance by delaying WAL writes and fsync
>   so an abrupt operating system restart might lose a few seconds of
>   committed transactions but still be consistent.  We could perhaps
>   remove the 'fsync' parameter (which results in an an inconsistent
>   database) in favor of this capability.
2004-08-14 01:30:49 +00:00
Tom Lane
2d65574041 Preliminary release notes for 7.4.4, 7.3.7, 7.2.5. Will add to the
back branches later.
2004-08-13 18:22:12 +00:00
Bruce Momjian
146b000651 Mention log_statement_stats can not be enabled with the other options. 2004-08-13 16:29:55 +00:00
Tom Lane
5a67d7618f Clarify trigger function return convention, per Thomas Hallgren. 2004-08-13 16:17:19 +00:00
Bruce Momjian
ae449122cf Mention the installer doesn't run on NT4. 2004-08-13 03:00:07 +00:00
Bruce Momjian
9227509230 Add:
> 	o Add ALTER INDEX that works just like ALTER TABLE already does
> 	  on an index
2004-08-13 02:47:53 +00:00
Tom Lane
7f7e8cc3f2 Allow commas in BEGIN, START TRANSACTION, and SET TRANSACTION, as required
by the SQL standard.  For backwards compatibility, however, continue to
accept the syntax without.  Minor editorialization in the reference pages
for these commands, too.
2004-08-12 21:00:34 +00:00
Bruce Momjian
9e01aaa8bf Add:
> * Allow finer control over the caching of prepared query plans
>
>   Currently, queries prepared via the libpq API are planned on first
>   execute using the supplied parameters --- allow SQL PREPARE to do the
>   same.  Also, allow control over replanning prepared queries either
>   manually or automatically when statistics for execute parameters
>   differ dramatically from those used during planning.
>
2004-08-12 19:45:24 +00:00
Tom Lane
a583675108 Allow optional SAVEPOINT keyword in RELEASE and ROLLBACK TO, for greater
compliance with SQL2003 spec syntax.

Oliver Jowett
2004-08-12 19:12:21 +00:00
Bruce Momjian
10249abfa1 Cleanup Win32 COPY handling, and move archive examples to SGML. 2004-08-12 19:03:44 +00:00
Tom Lane
f79fbb2bec Add PQserverVersion() to libpq to provide more-convenient access to
the server version number.  This commit also removes bogus DOS line
endings from libpqddll.def.

Greg Sabino Mullane
2004-08-11 18:06:01 +00:00
Bruce Momjian
f7667e4cfa Update DELETE FROM:
< * Allow DELETE to handle table aliases for self-joins
> * Allow an alias to be provided for the target table in UPDATE/DELETE
276,279c276,282
<   There is no way to create a table alias for the deleted table for use
<   in the DELETE WHERE clause.  The agreed approach is to allow a USING
<   clause to specify additional tables.  UPDATE already has an optional
<   FROM clause for this purpose.
>   This is not SQL-spec but many DBMSs allow it.
>
> * Allow additional tables to be specified in DELETE for joins
>
>   UPDATE already allows this (UPDATE...FROM) but we need similar
>   functionality in DELETE.  It's been agreed that the keyword should
>   be USING, to avoid anything as confusing as DELETE FROM a FROM b.
2004-08-10 17:30:47 +00:00
Bruce Momjian
2c29664b6b Update DELETE FROM TODO info. 2004-08-10 16:29:43 +00:00
Bruce Momjian
fdcad61fd5 Add:
* Add COMMENT ON for all cluster global objects (users, groups,
  databases and tablespaces)
2004-08-10 01:38:59 +00:00
Tom Lane
97b1ac1aef Update documentation to reflect the fact that we now know exactly what
time zone names we support.
2004-08-10 00:55:08 +00:00
Bruce Momjian
1ad8aedb5f Removed, shared table:
< * Add COMMENT for tablespaces
2004-08-09 22:48:01 +00:00
Bruce Momjian
8196e1f85a Add:
> * Add COMMENT for tablespaces
2004-08-09 22:39:18 +00:00
Tom Lane
1109959907 Remove no-longer-relevant information about trying to force your OS
to support PST8PDT time zone for the regression tests.
2004-08-09 05:34:39 +00:00
Tom Lane
82fde1aaa8 Add note pointing out the difference in semantics between Oracle and
plpgsql EXCEPTION blocks.
2004-08-08 22:40:46 +00:00
Tom Lane
35a5fb6863 Move expanded discussion of inheritance's limitations out of tutorial
and into ddl.sgml.  Rewrite for more completeness and (hopefully)
clarity.
2004-08-08 21:33:11 +00:00
Tom Lane
33bf242a8a Make listen_addresses be a comma-separated list instead of a space-separated
list.  More consistent with our other list-containing GUC variables.
2004-08-08 20:17:36 +00:00
Tom Lane
dc199eafa7 Document background writer control parameters, do some editorial work
on other recent changes in runtime parameter list.
2004-08-08 19:42:57 +00:00
Joe Conway
881ea47d24 Another array syntax change (whitespace) clarification -- this time in
the release notes.
2004-08-08 06:03:36 +00:00
Joe Conway
4187adc631 Minor clarification of documentation regarding trailing whitespace. 2004-08-08 05:55:55 +00:00
Joe Conway
da8325fa5c Updated release notes for recent array syntax changes. 2004-08-08 05:46:40 +00:00
Joe Conway
cb50ee286d Tighened up syntax checking of array input processing considerably. Junk that
was previously allowed in odd places with odd results now causes an ERROR.
Also changed behavior with respect to whitespace -- trailing whitespace is
now ignored as well as leading whitespace (which has always been ignored).

Documentation updated to reflect change in whitespace handling. Also some
refactoring to what I believe is a more sensible order of several paragraphs.
2004-08-08 05:01:55 +00:00
Tom Lane
8e953e6fbb Update admin guide's discussion of WAL to match present reality. 2004-08-08 04:34:43 +00:00
Tom Lane
6c3561b9e4 Minor editorialization on example --- I think that the use of dollar
quoting in this case is just needless obscurantism.
2004-08-08 02:05:32 +00:00
Bruce Momjian
ff9d69d931 This patch adds SQL2003 to the set of standards with which PostgreSQL
is attempting to comply.

David Fetter
2004-08-08 01:52:14 +00:00
Bruce Momjian
2539edc53f This adds a caveat to the inheritance part of the tutorial.
David Fetter
2004-08-08 01:51:05 +00:00
Bruce Momjian
0236b5e07e This patch adds an example to the CREATE DOMAIN docs.
David Fetter
2004-08-08 01:49:30 +00:00
Bruce Momjian
ff8d68df5c Included is an example of using savepoints in a non-trivial example.
Giving examples in the SQL command reference is hard because we don't
have conditionals at the SQL level.

Gavin Sherry
2004-08-08 01:48:31 +00:00
Tom Lane
9b3caebb0a Update plpgsql documentation for 8.0 (mostly, make use of named
function parameters and dollar quoting in examples; do some polishing
of the existing dollar-quoting docs).  The 'how to port from Oracle'
section is looking pretty respectable these days ...
2004-08-08 00:50:58 +00:00
Tom Lane
27fedc8a5e Improve privileges discussion (mostly, mention grant options). 2004-08-07 20:44:50 +00:00
Tom Lane
82433e913c Update a couple of example error messages to reflect the fact that we
don't generate constraint names like "$1" anymore.
2004-08-07 19:53:48 +00:00
Tom Lane
c71e3de264 Improve markup a little. 2004-08-07 19:14:45 +00:00
Tom Lane
c2f14a7cdf Improve tablespace discussion, and bring it up to date with code. 2004-08-07 19:02:43 +00:00
Bruce Momjian
ff2c8950fe Update pitr docs to mention inclusive/exclusive xid specification 2004-08-07 18:07:46 +00:00
Bruce Momjian
752089ea41 Fix markup. 2004-08-07 12:21:25 +00:00
Bruce Momjian
a1c2ed7b02 Mention that transactions can complete in a different numeric order, for
PITR recovery.
2004-08-07 03:21:11 +00:00
Bruce Momjian
8ac6de38f1 Add:
> * Create dump tool for write-ahead logs for use in determining
>   transaction id for point-in-time recovery
2004-08-07 01:58:12 +00:00
Tom Lane
f8450bb32a Some editorial work on the 8.0 release notes. Update for recent commits,
improve existing descriptions.
2004-08-06 23:33:48 +00:00
Bruce Momjian
57050f9bdf Modify:
> * Un-comment all variables in postgresql.conf
84,85c84,85
<   By removing comments we prevent the confusion that commenting a line
<   returns a modified value to its default, which it does not.
>   By not showing commented-out variables, we discourage people from
>   thinking that re-commenting a variable returns it to its default.
2004-08-06 17:52:44 +00:00
Bruce Momjian
78877260e6 Add:
> * Track dependencies in function bodies and recompile/invalidate
2004-08-06 15:24:20 +00:00
Bruce Momjian
ab7e8cba58 Add description:
>
>   By removing comments we prevent the confusion that commenting a line
>   returns a modified value to its default, which it does not.
>
2004-08-06 15:12:38 +00:00
Bruce Momjian
e6c7206356 Add:
> * Remove comments on postgresql.conf variables
2004-08-06 15:08:52 +00:00
Bruce Momjian
0307c09cf5 Rename vacuum_cost_naptime to vacuum_cost_delay, with agreement from Jan. 2004-08-06 04:15:09 +00:00
Tom Lane
bdf8ef6925 Create a built-in log rotation program, so that we no longer have to
recommend that people go get Apache's rotatelogs program.  Additional
benefits are that configuration is done through GUC, rather than
externally, and that the postmaster can monitor the log rotator and
restart it after failure (though we certainly hope that won't happen
often).
Andreas Pflug, some rework by Tom Lane.
2004-08-05 23:32:13 +00:00
Joe Conway
0e13d627be Require that array literals produce "rectangular" arrays, i.e. all the
subarrays of a given dimension have the same number of elements/subarrays.

Also repair a longstanding undocumented (as far as I can see) ability to
explicitly set array bounds in the array literal syntax. It now can
deal properly with negative array indicies. Modify array_out so that
arrays with non-standard lower bounds (i.e. not 1) are output with
the expicit dimension syntax. This fixes a longstanding issue whereby
arrays with non-default lower bounds had them changed to default
after a dump/reload cycle.

Modify regression tests and docs to suit, and add some minimal
documentation regarding the explicit dimension syntax.
2004-08-05 03:30:44 +00:00
Bruce Momjian
a128926e89 Update for 8.0 2004-08-04 22:59:42 +00:00
Tom Lane
fcbc438727 Label CVS tip as 8.0devel instead of 7.5devel. Adjust various comments
and documentation to reference 8.0 instead of 7.5.
2004-08-04 21:34:35 +00:00
Tom Lane
8515efa128 Add some notes about unimplemented aspects of PITR backup/recovery. 2004-08-04 17:37:09 +00:00
Tom Lane
59ff484894 Preliminary documentation for PITR. 2004-08-03 23:42:59 +00:00
Tom Lane
58c41712d5 Add functions pg_start_backup, pg_stop_backup to create backup label
and history files as per recent discussion.  While at it, remove
pg_terminate_backend, since we have decided we do not have time during
this release cycle to address the reliability concerns it creates.
Split the 'Miscellaneous Functions' documentation section into
'System Information Functions' and 'System Administration Functions',
which hopefully will draw the eyes of those looking for such things.
2004-08-03 20:32:36 +00:00
Bruce Momjian
635018b77e Move dbsize/oid2name to open items list. 2004-08-03 01:14:57 +00:00
Bruce Momjian
e3b8530cc3 Readd pg_config --pgxs code. 2004-08-02 12:34:14 +00:00
Tom Lane
f0efe26402 Support USING INDEX TABLESPACE clause for PRIMARY KEY and UNIQUE
constraints.  Christopher Kings-Lynne.
2004-08-02 04:28:29 +00:00
Tom Lane
efcaf1e868 Some mop-up work for savepoints (nested transactions). Store a small
number of active subtransaction XIDs in each backend's PGPROC entry,
and use this to avoid expensive probes into pg_subtrans during
TransactionIdIsInProgress.  Extend EOXactCallback API to allow add-on
modules to get control at subxact start/end.  (This is deliberately
not compatible with the former API, since any uses of that API probably
need manual review anyway.)  Add basic reference documentation for
SAVEPOINT and related commands.  Minor other cleanups to check off some
of the open issues for subtransactions.
Alvaro Herrera and Tom Lane.
2004-08-01 17:32:22 +00:00
Bruce Momjian
9d9cdf82a4 Some name cleanup. 2004-08-01 14:08:08 +00:00
Bruce Momjian
48187a1dea Fix :
< * Magnus is Magnus Haglander (?)
> * Magnus is Magnus Hagander <mha@sollentuna.net>
2004-08-01 13:55:12 +00:00
Bruce Momjian
ca9540d34f Add docs for initdb --auth. 2004-08-01 06:19:26 +00:00
Bruce Momjian
9d623ed252 Minor release wording improvments. 2004-08-01 05:22:26 +00:00
Bruce Momjian
5b0d5ea92d Add descriptions to TODO items and make adjustments based on 7.5. 2004-08-01 05:15:58 +00:00
Bruce Momjian
6e5e78241b Remove pool discussion. All old stuff. 2004-08-01 04:53:38 +00:00
Tom Lane
9c8d0850c3 Support "OR condition ..." in plpgsql EXCEPTION clauses to make the syntax
more nearly Oracle-equivalent.  Allow matching by category as well as
specific error code.  Document the set of available condition names
(or more accurately, synchronize it with the existing documentation).  In
passing, update errcodes.sgml to include codes added during 7.5 development.
2004-07-31 23:04:58 +00:00
Peter Eisentraut
ea7a8b9ed7 Remove obsolete files 2004-07-31 16:35:17 +00:00
Tom Lane
beda4814c1 plpgsql does exceptions.
There are still some things that need refinement; in particular I fear
that the recognized set of error condition names probably has little in
common with what Oracle recognizes.  But it's a start.
2004-07-31 07:39:21 +00:00
Tom Lane
b5d2821929 Fix broken markup, release date. 2004-07-31 07:11:07 +00:00
Bruce Momjian
f951a46771 Add:
> * Allow point-in-time recovery to archive partially filled logs
2004-07-31 06:13:52 +00:00
Bruce Momjian
6b771dfa38 Remove mention that we can't trap function errors. 2004-07-31 04:22:46 +00:00
Bruce Momjian
d01af7730e Fix number for FAQ item. 2004-07-30 16:51:59 +00:00
Peter Eisentraut
adf57cd7e2 PostgreSQL extension makefile framework ("pgxs"), by Fabien Coelho, with
some massaging by Peter Eisentraut.  This is basically a simple
generalization of the existing contrib makefiles.
2004-07-30 12:26:40 +00:00
Bruce Momjian
66917fcff5 Add:
> * Allow administrators to safely terminate individual sessions
2004-07-29 16:47:07 +00:00
Bruce Momjian
a3b9a02716 Update Turkish FAQ.
Devrim GUNDUZ
2004-07-29 16:30:32 +00:00
Bruce Momjian
e57243ea7e Add:
> * Allow server logs to be read using SQL commands
> * Allow server configuration parameters to be modified remotetly
2004-07-29 16:24:02 +00:00
Bruce Momjian
d79dc61df9 Update release notes with better wording.
Brian B.
2004-07-28 14:28:57 +00:00
Bruce Momjian
b1ee93884d Update tuple header size. 2004-07-27 03:27:48 +00:00
Bruce Momjian
5b2f4afffe Here is a patch that fixes the pipes used in find_other_exec() when
running as a service on windows <= 2000. Required to make the pg_ctl
service wrapper to work at all.

Magnus Hagander
2004-07-26 01:48:00 +00:00
Bruce Momjian
25a1324703 Adjust release notes based on community feedback. 2004-07-26 00:26:42 +00:00
Bruce Momjian
a2abe9fe58 Update 7.5 release notes. 2004-07-25 04:18:05 +00:00
Tom Lane
0655b26282 log_destination should only be PGC_SIGHUP, not PGC_POSTMASTER, as per
discussion yesterday.  Also a few improvements in the associated
documentation.
2004-07-24 19:51:23 +00:00
Bruce Momjian
cbcd8b5bec First draft of 7.5 release notes. Still needs markup, additional major
items, and detailed text descriptions.
2004-07-24 09:36:53 +00:00
Bruce Momjian
406e8aa294 Updated wording:
> * Have psql show current values for a sequence
2004-07-22 12:24:13 +00:00
Bruce Momjian
e15c432302 Done:
> * -Have psql show more information about sequences
2004-07-22 11:49:19 +00:00
Tom Lane
2042b3428d Invent WAL timelines, as per recent discussion, to make point-in-time
recovery more manageable.  Also, undo recent change to add FILE_HEADER
and WASTED_SPACE records to XLOG; instead make the XLOG page header
variable-size with extra fields in the first page of an XLOG file.
This should fix the boundary-case bugs observed by Mark Kirkwood.
initdb forced due to change of XLOG representation.
2004-07-21 22:31:26 +00:00
Bruce Momjian
8eeae3e11c Please find enclosed a patch that matches the PL/Perl documentation
(fairly closely, I hope) to the current PL/Perl implementation.

David Fetter
2004-07-21 20:44:52 +00:00
Bruce Momjian
7a55ba7615 Back out pg_autovacuum commit after cvs clean failure causes commit. 2004-07-21 20:34:50 +00:00
Bruce Momjian
8dec0c1bf2 lease find enclosed a patch that matches the PL/Perl documentation
(fairly closely, I hope) to the current PL/Perl implementation.

David Fetter
2004-07-21 20:23:05 +00:00
Bruce Momjian
83997560b7 Mention plpgsql:
< 	o -Allow parameters to be specified by name and type during definition
> 	o -Allow PL/pgSQL parameters to be specified by name and type during definition
2004-07-21 13:46:44 +00:00
Bruce Momjian
53cee20f67 As per the following:
http://archives.postgresql.org/pgsql-cygwin/2004-07/msg00090.php

Jason Tishler
2004-07-20 22:56:40 +00:00
Bruce Momjian
851bcee425 Update:
< * Allow psql to display permission information using \df+ and \l+
> * Consistenly display privilege information for all objects in psql
2004-07-20 22:28:16 +00:00
Bruce Momjian
cd66b86be2 Add:
> * Allow psql to display permission information using \df+ and \l+
2004-07-20 21:01:22 +00:00
Bruce Momjian
5406955541 Add:
> * Fix data types where equality comparison isn't intuitive, e.g. box
2004-07-20 19:52:03 +00:00
Bruce Momjian
3df8b47a5e Done:
> 	o -Allow parameters to be specified by name and type during definition
2004-07-20 19:37:36 +00:00
Bruce Momjian
45995219a0 Here is another patch that fixes a stack of pg_dump bugs:
* Fix help text ordering

* Add back --set-session-authorization to pg_dumpall.  Updated the docs
for that.  Updated help for that.

* Dump ALTER USER commands for the cluster owner ("pgsql").  These are
dumped AFTER the create user and create database commands in case the
permissions to do these have been revoked.

* Dump ALTER OWNER for public schema (because it's possible to change
it).  This was done by adding TOC entries for the public schema, and
filtering them out at archiver time.  I also save the owner in the TOC
entry just for the public schema.

* Suppress dumping single quotes around schema_path and DateStyle
options when they are set using ALTER USER or ALTER DATABASE.  Added a
comment to the steps in guc.c to remind people to update that list.

* Fix dumping in --clean mode against a pre-7.3 server.  It just sets
all drop statements to assume the public schema, allowing it to restore
without error.

* Cleaned up text output.  eg. Don't output -- Tablespaces comment if
there are none.  Same for groups and users.

* Make the commands to DELETE FROM pg_shadow and DELETE FROM pg_group
only be output when -c mode is enabled.  I'm not sure why that hasn't
been done before?!?!

This should be good for application asap, after which I will start on
regression dumping 7.0-7.4 databases.

Christopher Kings-Lynne
2004-07-19 21:39:48 +00:00
Bruce Momjian
8459b2d472 Done:
> * -Allow configuration files to be specified in a different directory
2004-07-19 20:57:30 +00:00
Bruce Momjian
6ce4738eca No CVS FAQ, just CVS docs. 2004-07-19 20:30:16 +00:00
Bruce Momjian
050976321b *** empty log message *** 2004-07-19 20:28:43 +00:00
Tom Lane
694b9ef783 Fix broken markup, per Jonathan Gardner. 2004-07-17 16:33:31 +00:00
Bruce Momjian
6275419446 Add:
> 	o Enforce rules for setting combinations
2004-07-17 10:50:05 +00:00
Bruce Momjian
1e0415d96d Add French FAQ.
LELARGE Guillaume
2004-07-15 15:25:25 +00:00
Bruce Momjian
93a1fce5cc Add permission display to \db+. 2004-07-15 03:56:06 +00:00
Peter Eisentraut
a837ed88b1 Detect locale/encoding mismatch in initdb, or pick a suitable encoding
automatically if none was specified.
2004-07-14 17:55:10 +00:00
Bruce Momjian
bbcee544aa Have \dn+ show permissions and description for schemas.
Dennis Bjorklund
2004-07-13 16:48:16 +00:00
Bruce Momjian
dc0e76ca36 Change pg_dump to use ALTER OWNER commands instead of SET SESSION
AUTHORIZATION commands by default.  Move all GRANT and REVOKE commands
to the end of the dump to avoid restore failures in several situations.
Bring back --use-set-session-authorization option to get previous SET
behaviour

Christopher Kings-Lyne
2004-07-13 03:00:17 +00:00
Bruce Momjian
b6335b4fb4 Add tablespace location display for psql \d.
Gavin Sherry
2004-07-12 20:41:13 +00:00
Bruce Momjian
e47cbb3bad Add has_tablespace_privilege().
Christopher Kings-Lynne
2004-07-12 20:23:59 +00:00
Bruce Momjian
a0db74a35c This patch adds the following options to pg_dumpall, to be passed to
pg_dump:

-S, --superuser=NAME

-O, --no-owner

-X disable-dollar-quoting, --disable-dollar-quoting

-X disable-triggers, --disable-triggers

Christopher Kings-Lynne
2004-07-12 14:35:45 +00:00
Tom Lane
c14a43f657 Remove TABLESPACE option of CREATE SEQUENCE; sequences will now always
live in database or schema's default tablespace, as per today's discussion.
Also, remove some unused keywords from the grammar (PATH, PENDANT,
VERSION), and fix ALSO, which was added as a keyword but not added
to the keyword classification lists, thus making it worse-than-reserved.
2004-07-12 05:38:11 +00:00
Bruce Momjian
c5ff895c48 New text. 2004-07-12 03:58:34 +00:00
Bruce Momjian
a919fdfd3d Wording improvement. 2004-07-12 01:37:01 +00:00
Bruce Momjian
7bcdf2ebee Tablespace examples for CREATE TABLE/INDEX/SCHEMA/DATABASE as well as
some other examples for CREATE DATABASE.

Gavin Sherry
2004-07-12 01:22:53 +00:00
Bruce Momjian
3095c104f0 Move comma. 2004-07-12 01:10:17 +00:00
Bruce Momjian
098d0304d7 Add:
> * Add session start time and last statement time to pg_stat_activity
2004-07-12 00:39:11 +00:00
Bruce Momjian
1ec448cda3 Added Matthew:
<   rather than in /contrib
>   rather than in /contrib (Matthew)
515a516
> * Matthew T. O'Connor <matthew@zeut.net>
2004-07-12 00:23:59 +00:00
Bruce Momjian
233afe6a90 New Czech FAQ.
Pavel Stehule
2004-07-12 00:22:51 +00:00
Bruce Momjian
2bd17a5f52 Add FAQ entry on hardware selection. 2004-07-12 00:18:57 +00:00
Bruce Momjian
0589ab68c5 Remove:
< * Allow moving sequences and toast tables to other tablespaces
2004-07-11 23:52:05 +00:00
Bruce Momjian
a1f3209c07 Add:
> * Allow moving sequences and toast tables to other tablespaces
2004-07-11 23:31:27 +00:00
Bruce Momjian
8dbd10d96d This patch fixes a small error in the Porting PL/SQL to PL/pgSQL
section where a instr function parameter is mistyped as varchar. It
works properly when changed to integer.

Michael Glaesemann
2004-07-11 23:26:51 +00:00
Bruce Momjian
cf9fd800ec Example for create function using argument names
Gavin Sherry
2004-07-11 23:23:43 +00:00
Tom Lane
af4de81469 ALTER TABLE SET TABLESPACE. Gavin Sherry, some rework by Tom Lane. 2004-07-11 23:13:58 +00:00
Bruce Momjian
08d89db34d Update German FAQ> 2004-07-11 23:07:18 +00:00
Bruce Momjian
5c9d069daf Add:
> * Add NOVICE output level for helpful messages like automatic sequence/index creation
2004-07-11 21:57:03 +00:00
Bruce Momjian
5ff9566686 Remove postgresql.conf of 'info' as a valid client_min_messages level. 2004-07-11 21:48:25 +00:00
Bruce Momjian
59429adea9 Add:
> * Allow moving system tables to other tablespaces, where possible
2004-07-11 03:10:50 +00:00
Bruce Momjian
eee93173d4 Add:
> * Allow changing of already-created database and schema tablespaces
2004-07-11 02:03:22 +00:00
Bruce Momjian
e5ca4bde79 Add:
> *  Add an option to sync() before fsync()'ing checkpoint files
2004-07-11 00:28:30 +00:00
Bruce Momjian
6063d11464 Add:
<
> * Use a phantom command counter for nested subtransactions to reduce
>   tuple overhead
2004-07-11 00:26:36 +00:00
Bruce Momjian
130f89e93f Allow configuration files to be placed outside the data directory.
Add new postgresql.conf variables to point to data, pg_hba.conf, and
pg_ident.conf files.

Needs more documentation.
2004-07-11 00:18:45 +00:00
Bruce Momjian
b4a98c5fcc Add:
> * Add include functionality to postgresql.conf
>
2004-07-11 00:18:28 +00:00
Bruce Momjian
afa035c204 Clarify schema meanings in pg_dump manual page by referring to object
definitions more frequently.
2004-07-10 15:51:28 +00:00
Bruce Momjian
4525418451 Add OSX thread support for next 7.4.X 2004-07-07 13:04:45 +00:00
Bruce Momjian
f8d390402b Formatting improvements:
< The most recent version of this document can be viewed at
< the PostgreSQL web site, http://www.PostgreSQL.org.
> The most recent version of this document can be viewed at the PostgreSQL web site, http://www.PostgreSQL.org.
2004-07-07 12:48:54 +00:00
Bruce Momjian
b4e660e352 Regenerate:
> #A dash (-) marks changes that will appear in the upcoming 7.5 release.#
2004-07-07 12:45:50 +00:00
Bruce Momjian
8f599aa6ea regenerate. 2004-07-07 12:45:16 +00:00
Bruce Momjian
aec271475a Bold dash line.
> \#A dash (-) marks changes that will appear in the upcoming 7.5 release.#
2004-07-07 12:44:34 +00:00
Bruce Momjian
a08baad671 Update highlighting of dash. 2004-07-07 12:25:02 +00:00
Bruce Momjian
ea0078da2d Move section:
< * Add replication of distributed databases
< 	o Automatic failover
< 	o Load balancing
< 	o Master/slave replication
< 	o Multi-master replication
< 	o Partition data across servers
< 	o Queries across databases or servers (two-phase commit)
< 	o Allow replication over unreliable or non-persistent links
55a48,55
> * Improve replication solutions
> 	o Automatic failover
> 	o Load balancing
> 	o Master/slave replication
> 	o Multi-master replication
> 	o Partition data across servers
> 	o Queries across databases or servers (two-phase commit)
> 	o Allow replication over unreliable or non-persistent links
2004-07-06 20:29:31 +00:00
Bruce Momjian
33fe94b286 Reorder dash mention to be more prominient.
> A dash (-) marks changes that will appear in the upcoming 7.5 release.
>
> Bracketed items "[]" have more detail.
9,12d12
<
< A dash (-) marks changes that will appear in the upcoming 7.5 release.
<
< Bracketed items "[]" have more detail.
2004-07-06 16:18:31 +00:00
Bruce Momjian
a21bb2722a Done:
> * -Fix upper()/lower() to work for multibyte encodings
2004-07-06 03:23:31 +00:00
Bruce Momjian
da09dea3e3 Fix paragraph mention in ALTER DATABASE manual page.
Christopher Kings-Lynne
2004-07-05 02:34:43 +00:00
Tom Lane
959b353db2 Fix misspellings: langauge -> language. 2004-07-04 23:34:24 +00:00
Tom Lane
a72dd7a9e4 Okay, I've had it with answering newbie questions about why plpgsql
FOR loops are giving weird syntax errors.  Restructure parsing of FOR
loops so that the integer-loop-vs-query-loop decision is driven off
the presence of '..' between IN and LOOP, rather than the presence
of a matching record/row variable name.  Hopefully this will make the
behavior a bit more transparent.
2004-07-04 02:49:04 +00:00
Tom Lane
e34082ee3b Add missing operators of the form interval-plus-datetime, as required for
better SQL compliance in this area, per recent discussion.  Mark related
operators as commutators where possible.  (The system doesn't actually care
about commutator marking for operators not returning boolean, at the moment,
but this seems forward-thinking and besides it made it easier to verify
that we hadn't missed any.)
Also, remove interval-minus-time and interval-minus-timetz operators.
I'm not sure how these got in, but they are nonstandard and had very
obviously broken behavior.  (minus is not commutative in anyone's book.)
I doubt anyone had ever used 'em, because we'd surely have gotten a bug
report about it if so.
2004-07-02 22:50:23 +00:00
Joe Conway
0b89d261c7 Andreas Pflug wrote:
From an idea of Bruce, the attached patch implements the function
 pg_tablespace_databases(oid) RETURNS SETOF oid
 which delivers as set of database oids having objects in the selected
 tablespace, enabling an admin to examine only the databases affecting
 the tablespace for objects instead of scanning all of them.

initdb forced
2004-07-02 18:59:25 +00:00
Peter Eisentraut
c7beffcc1d Override upstream DSSSL style sheet formatting changes 2004-06-29 20:44:34 +00:00
Peter Eisentraut
bc7589a292 Comma splice police 2004-06-29 19:57:40 +00:00
Tom Lane
b3d36a2467 Fix bogus line break within a file name, as noted by Alvaro. 2004-06-27 22:58:19 +00:00
Tom Lane
0adfa2c39d Support renaming of tablespaces, and changing the owners of
aggregates, conversions, functions, operators, operator classes,
schemas, types, and tablespaces.  Fold the existing implementations
of alter domain owner and alter database owner in with these.

Christopher Kings-Lynne
2004-06-25 21:55:59 +00:00
Tom Lane
a0e842d81b Add pg_get_serial_sequence() function, and cause pg_dump to use it.
This eliminates the assumption that a serial column's sequence will
have the same name on reload that it was given in the original database.

Christopher Kings-Lynne
2004-06-25 17:20:29 +00:00
Dennis Bjorklund
d0f1b4c4fb Add argument name to syntax. 2004-06-25 07:05:34 +00:00
Tom Lane
b5b9e33564 Add documentation for pg_cancel_backend and pg_terminate_backend.
Magnus Hagander
2004-06-24 19:57:14 +00:00
Tom Lane
1b80b6da6a Add --pwfile option to initdb, so that passwords can be set by GUI tools
that aren't able to feed the password to initdb's /dev/tty.

Magnus Hagander
2004-06-24 19:26:59 +00:00
Bruce Momjian
153d5d31eb Remove link:
<   http://momjian.postgresql.org/main/writings/pgsql/project/pitr.html
2004-06-23 09:53:57 +00:00
Tom Lane
f5f448fb3e Rename the built-in tablespaces to pg_default and pg_global, and prohibit
creation of user-defined tablespaces with names starting with 'pg_', as
per suggestion of Chris K-L.  Also install admin-guide tablespace
documentation from Gavin.
2004-06-21 04:06:07 +00:00
Bruce Momjian
7864e0aa6a Add pgevent, with docs explaining out to install it on Win32. 2004-06-20 01:32:49 +00:00
Bruce Momjian
1181ea6a78 Add:
> * Fix oid2name and dbsize for tablespaces
2004-06-19 01:48:13 +00:00
Tom Lane
f7ca71a76b Replace createdb's obsolete --location switch with --tablespace.
I kept the same abbreviated letter -D, in hopes of maintaining some
modicum of backwards compatibility (though it's doubtful whether anyone
is really using scripts that invoke createdb -D ...)
2004-06-18 21:47:24 +00:00
Tom Lane
984c8a48f4 initlocation is history. (It's still mentioned in manage-ag.sgml,
but I'll leave that file alone so as not to mess up the doc patch
I trust Gavin is working on.)
2004-06-18 21:24:06 +00:00
Bruce Momjian
b33c7231e5 Add:
> * Allow reporting of which objects are in which tablespaces
> * Allow database recovery where tablespaces can't be created
211a213,214
> 	o Add ALTER TABLESPACE to change location, name, owner
> 	o Allow objects to be moved between tablespaces
2004-06-18 18:35:53 +00:00
Bruce Momjian
9e24182952 Remove tablespaces TODO.detail. 2004-06-18 16:04:13 +00:00
Bruce Momjian
0d1ffd36c4 Done:
> * -Add the concept of dataspaces/tablespaces (Gavin)
2004-06-18 16:03:20 +00:00
Tom Lane
2467394ee1 Tablespaces. Alternate database locations are dead, long live tablespaces.
There are various things left to do: contrib dbsize and oid2name modules
need work, and so does the documentation.  Also someone should think about
COMMENT ON TABLESPACE and maybe RENAME TABLESPACE.  Also initlocation is
dead, it just doesn't know it yet.

Gavin Sherry and Tom Lane.
2004-06-18 06:14:31 +00:00
Bruce Momjian
474875f443 The attached patch adds some index entries pointing to the cursor
reference pages.  Please apply.

Alvaro Herrera
2004-06-17 12:41:02 +00:00
Tom Lane
d70a42e642 Represent type-specific length coercion functions as pg_cast entries,
eliminating the former hard-wired convention about their names.  Allow
pg_cast entries to represent both type coercion and length coercion in
a single step --- this is represented by a function that takes an
extra typmod argument, just like a length coercion function.  This
nicely merges the type and length coercion mechanisms into something
at least a little cleaner than we had before.  Make use of the single-
coercion-step behavior to fix integer-to-bit coercion so that coercing
to bit(n) yields the rightmost n bits of the integer instead of the
leftmost n bits.  This should fix recurrent complaints about the odd
behavior of this coercion.  Clean up the documentation of the bit string
functions, and try to put it where people might actually find it.
Also, get rid of the unreliable heuristics in ruleutils.c about whether
to display nested coercion steps; instead require parse_coerce.c to
label them properly in the first place.
2004-06-16 01:27:00 +00:00
Tom Lane
8e7349b738 Fix doc bug: to_timestamp() returns timestamptz, not plain timestamp. 2004-06-14 19:01:09 +00:00
Bruce Momjian
f4b0d28aa0 New wording:
<   in-progress when the server terminates abruptly
>   in-progress when the server terminated abruptly
2004-06-14 13:44:00 +00:00
Bruce Momjian
8b8bbfff45 New wording:
<   in-progress when the server crashed
>   in-progress when the server terminates abruptly
2004-06-14 13:42:47 +00:00
Bruce Momjian
dd83b34d38 Updated wording:
< * Remove unreferenced table files and temp tables during database vacuum
<   or postmaster startup (Bruce)
> * Remove unreferenced table files created by transactions that were
>   in-progress when the server crashed
>
2004-06-13 23:42:59 +00:00
Bruce Momjian
75c8e51b08 Re-add:
> * Remove unreferenced table files and temp tables during database vacuum
>   or postmaster startup (Bruce)
2004-06-13 23:39:30 +00:00
Tom Lane
ba0f9ff3ba Code review for recently-added network functions. Get it to work when
log_hostname is enabled, clean up documentation.
2004-06-13 19:56:52 +00:00
Tom Lane
88961fc45d Correct erroneous table title, per Halley Pacheco de Oliveira. 2004-06-13 17:51:08 +00:00
Tom Lane
4832c53e10 Some editorializing on 7.4.3 release notes. 2004-06-12 19:30:29 +00:00
Bruce Momjian
aa5fe4ae76 Improve release wording. 2004-06-12 04:22:15 +00:00
Bruce Momjian
b24e361d11 Markup fix. 2004-06-12 04:08:02 +00:00
Bruce Momjian
342e3b06f8 Fix markup 2004-06-12 04:02:53 +00:00
Bruce Momjian
a1c4b9efe4 Update release notes for 7.4.3. 2004-06-12 03:54:51 +00:00
Tom Lane
7643bed58e When using extended-query protocol, postpone planning of unnamed statements
until Bind is received, so that actual parameter values are visible to the
planner.  Make use of the parameter values for estimation purposes (but
don't fold them into the actual plan).  This buys back most of the
potential loss of plan quality that ensues from using out-of-line
parameters instead of putting literal values right into the query text.

This patch creates a notion of constant-folding expressions 'for
estimation purposes only', in which case we can be more aggressive than
the normal eval_const_expressions() logic can be.  Right now the only
difference in behavior is inserting bound values for Params, but it will
be interesting to look at other possibilities.  One that we've seen
come up repeatedly is reducing now() and related functions to current
values, so that queries like ... WHERE timestampcol > now() - '1 day'
have some chance of being planned effectively.

Oliver Jowett, with some kibitzing from Tom Lane.
2004-06-11 01:09:22 +00:00
Bruce Momjian
6cc4175b25 Attached is a patch that takes care of the PATHSEP issue. I made a more
extensive change then what was suggested. I found the file path.c that
contained a lot of "Unix/Windows" agnostic functions so I added a function
there instead and removed the PATHSEP declaration in exec.c altogether. All
to keep things from scattering all over the code.

I also took the liberty of changing the name of the functions
"first_path_sep" and "last_path_sep". Where I come from (and I'm apparently
not alone given the former macro name PATHSEP), they should be called
"first_dir_sep" and "last_dir_sep". The new function I introduced, that
actually finds path separators, is now the "first_path_sep". The patch
contains changes on all affected places of course.

I also changed the documentation on dynamic_library_path to reflect the
chagnes.

Thomas Hallgren
2004-06-10 22:26:24 +00:00
Bruce Momjian
387b38bec4 Done:
> * -Print table names with constraint names in error messages, or make constraint
2004-06-10 19:04:49 +00:00
Bruce Momjian
93db6f6ae2 Reword:
< * Allow hash buckets to fill disk pages, rather than being sparse
> * Pack hash index buckets onto disk pages more efficiently
2004-06-10 11:56:27 +00:00
Bruce Momjian
13c30084f6 Add:
> * Allow pg_dump to use multiple -t and -n switches
2004-06-10 04:33:51 +00:00
Bruce Momjian
741681b7b2 Modify:
< * Order heap pointers on hash index pages by hash value and ctid
> * Allow hash buckets to fill disk pages, rather than being sparse
2004-06-10 04:06:21 +00:00
Bruce Momjian
c7099997ac Add Brazilian version of FAQ.
Euler Taveira de Oliveira
2004-06-10 03:46:11 +00:00
Bruce Momjian
babd02af5a Add:
> * Order heap pointers on hash index pages by hash value and ctid
2004-06-10 03:45:30 +00:00
Tom Lane
7e64dbc6b5 Support assignment to subfields of composite columns in UPDATE and INSERT.
As a side effect, cause subscripts in INSERT targetlists to do something
more or less sensible; previously we evaluated such subscripts and then
effectively ignored them.  Another side effect is that UPDATE-ing an
element or slice of an array value that is NULL now produces a non-null
result, namely an array containing just the assigned-to positions.
2004-06-09 19:08:20 +00:00
Bruce Momjian
69616f96ec Add:
> * Add ON COMMIT capability to CREATE TABLE AS SELECT
2004-06-09 03:15:51 +00:00
Bruce Momjian
cd8b0fc5f1 Change PGETC to PGSYSCONFDIR and PGLOCALE to PGLOCALEDIR, per Peter. 2004-06-08 13:49:23 +00:00
Bruce Momjian
9136613803 Add start/stop times for pg_dump/pg_dumpall when verbose output is used. 2004-06-07 20:35:57 +00:00
Bruce Momjian
613c684a60 Update date. 2004-06-07 15:11:23 +00:00
Tom Lane
982d005d62 Some preliminary documentation for composite-type stuff. 2004-06-07 04:04:47 +00:00
Tom Lane
c541bb86e9 Infrastructure for I/O of composite types: arrange for the I/O routines
of a composite type to get that type's OID as their second parameter,
in place of typelem which is useless.  The actual changes are mostly
centralized in getTypeInputInfo and siblings, but I had to fix a few
places that were fetching pg_type.typelem for themselves instead of
using the lsyscache.c routines.  Also, I renamed all the related variables
from 'typelem' to 'typioparam' to discourage people from assuming that
they necessarily contain array element types.
2004-06-06 00:41:28 +00:00
Bruce Momjian
768916d753 This is a small fix in FAQ. It just clean up some old comments and
change an old -not-working piece of code.
2004-06-04 04:09:40 +00:00
Bruce Momjian
bf2a115f2f Remove dash in pg_ctl signal name. It broke with getopt_long dash
reorganization processing, and it is clearer without the dash anyway.
2004-06-04 04:05:36 +00:00
Bruce Momjian
6870843339 Add PGETC (for pg_service.conf) and PGLOCALE (for locale dir)
environment variable processing to libpq.

The patch also adds code to our client apps so we set the environment
variable directly based on our binary location, unless it is already
set. This will allow our applications to emit proper locale messages
that are generated in libpq.
2004-06-03 00:07:38 +00:00
Bruce Momjian
70f5a87ecc Small patch that adds some documentation for the area() function.
Specifically, point out that intersecting points in a path will yield
(most likely), unexpected results.  Visually these are identical paths,
but mathematically they're not the same.  Ex:

  area |                                           plan
------
+-----------------------------------------------------------------------
-------------------
    -0 | ((0,0),(0,1),(2,1),(2,2),(1,2),(1,0),(0,0))
     2 | ((0,0),(0,1),(1,1),(1,2),(2,2),(2,1),(1,1),(1,0),(0,0))

The current algorithm for area(PATH) is very quick, but only handles
non-intersecting paths.  I'm going to work on two other functions for
the PATH data type that determines if a PATH is intersecting or not,
and a function that returns the area() for an intersecting PATH.  The
intersecting area() function will be considerably slower (I think it's
going to be O(n!) or worse instead of the current O(n), but that comes
with the territory).

Sean Chittenden
2004-06-02 21:34:49 +00:00
Bruce Momjian
36ae5efab1 Improve without cluster wording. 2004-06-02 21:04:40 +00:00
Bruce Momjian
1cdc58722c OK, here's the final version of ALTER TABLE ... SET WITHOUT CLUSTER.
Has docs + regression test.

Christopher Kings-Lynne
2004-06-02 21:01:10 +00:00
Tom Lane
4b2dafcc0b Align GRANT/REVOKE behavior more closely with the SQL spec, per discussion
of bug report #1150.  Also, arrange that the object owner's irrevocable
grant-option permissions are handled implicitly by the system rather than
being listed in the ACL as self-granted rights (which was wrong anyway).
I did not take the further step of showing these permissions in an
explicit 'granted by _SYSTEM' ACL entry, as that seemed more likely to
bollix up existing clients than to do anything really useful.  It's still
a possible future direction, though.
2004-06-01 21:49:23 +00:00
Bruce Momjian
a1bd1d70d6 Update pg_dump -v comments to mention additional comments in dump file. 2004-05-31 13:37:52 +00:00
Bruce Momjian
f024086db3 Done:
> 	o -Allow Java server-side programming
2004-05-31 02:58:43 +00:00
Bruce Momjian
95cdafd333 Remove pljava todo info. 2004-05-31 02:58:09 +00:00
Bruce Momjian
d157b7bbc7 Document new pg_ctl 'kill' command, specificially for Win32. 2004-05-27 03:50:25 +00:00
Tom Lane
c792cbcc26 Recommend ALTER TABLE ... TYPE as the best way to reclaim space occupied by deleted columns. The old method involving UPDATE and VACUUM FULL will be considerably less efficient. 2004-05-27 03:30:11 +00:00
Neil Conway
92b0b080eb Add an index entry for "Performance Tips". Patch from Alvaro Herrera. 2004-05-27 01:00:40 +00:00
Bruce Momjian
ffef9b8c50 AIX doc addition:
> FWIW, the section on configuring kernel resources under various
> Unixen[1] doesn't have any documentation for AIX. If someone out there
> knows which knobs need to be tweaked, would they mind sending in a doc
> patch? (Or just specifying what needs to be done, and I'll add the
> SGML.)

After verifying that nobody wound up messing with the kernel
parameters, here's a docs patch...

 Chris Browne
2004-05-26 18:51:43 +00:00
Bruce Momjian
97d625dd1c *) inet_(client|server)_(addr|port)() and necessary documentation for
the four functions.


> Also, please justify the temp-related changes.  I was not aware that we
> had any breakage there.

patch-tmp-schema.txt contains the following bits:

*) Changes pg_namespace_aclmask() so that the superuser is always able
to create objects in the temp namespace.
*) Changes pg_namespace_aclmask() so that if this is a temp namespace,
objects are only allowed to be created in the temp namespace if the
user has TEMP privs on the database.  This encompasses all object
creation, not just TEMP tables.
*) InitTempTableNamespace() checks to see if the current user, not the
session user, has access to create a temp namespace.

The first two changes are necessary to support the third change.  Now
it's possible to revoke all temp table privs from non-super users and
limiting all creation of temp tables/schemas via a function that's
executed with elevated privs (security definer).  Before this change,
it was not possible to have a setuid function to create a temp
table/schema if the session user had no TEMP privs.

patch-area-path.txt contains:

*) Can now determine the area of a closed path.


patch-dfmgr.txt contains:

*) Small tweak to add the library path that's being expanded.

I was using $lib/foo.so and couldn't easily figure out what the error
message, "invalid macro name in dynamic library path" meant without
looking through the source code.  With the path in there, at least I
know where to start looking in my config file.

Sean Chittenden
2004-05-26 18:35:51 +00:00
Bruce Momjian
8096fe45ce The added aggregates are:
(1) boolean-and and boolean-or aggregates named bool_and and bool_or.
    they (SHOULD;-) correspond to standard sql every and some/any aggregates.
    they do not have the right name as there is a problem with
    the standard and the parser for some/any. Tom also think that
    the standard name is misleading because NULL are ignored.
    Also add 'every' aggregate.

(2) bitwise integer aggregates named bit_and and bit_or for
    int2, int4, int8 and bit types. They are not standard, but I find
    them useful. I needed them once.


The patches adds:

- 2 new very short strict functions for boolean aggregates in
  src/backed/utils/adt/bool.c,
  src/include/utils/builtins.h and src/include/catalog/pg_proc.h

- the new aggregates declared in src/include/catalog/pg_proc.h and
  src/include/catalog/pg_aggregate.h

- some documentation and validation about these new aggregates.

Fabien COELHO
2004-05-26 15:26:28 +00:00
Bruce Momjian
3dc37cd8d6 The patch adresses the TODO list item "Allow external interfaces to
extend the GUC variable set".

Plugin modules like the pl<lang> modules needs a way to declare
configuration parameters. The postmaster has no knowledge of such
modules when it reads the postgresql.conf file. Rather than allowing
totally unknown configuration parameters, the concept of a variable
"class" is introduced. Variables that belongs to a declared classes will
create a placeholder value of string type and will not generate an
error. When a module is loaded, it will declare variables for such a
class and make those variables "consume" any placeholders that has been
defined. Finally, the module will generate warnings for unrecognized
placeholders defined for its class.

More detail:
The design is outlined after the suggestions made by Tom Lane and Joe
Conway in this thread:

http://archives.postgresql.org/pgsql-hackers/2004-02/msg00229.php

A new string variable 'custom_variable_classes' is introduced. This
variable is a comma separated string of identifiers. Each identifier
denots a 'class' that will allow its members to be added without error.
This variable must be defined in postmaster.conf.

The lexer (guc_file.l) is changed so that it can accept a qualified name
in the form <ID>.<ID> as the name of a variable. I also changed so that
the 'custom_variable_classes', if found, is added first of all variables
in order to remove the order of declaration issue.

The guc_variables table is made more dynamic. It is originally created
with 20% slack and can grow dynamically. A capacity is introduced to
avoid resizing every time a new variable is added. guc_variables and
num_guc_variables becomes static (hidden).

The GucInfoMain now uses the new function get_guc_variables() and
GetNumConfigOptions  instead or using the guc_variables directly.

The find_option() function, when passed a missing name, will check if
the name is qualified. If the name is qualified and if the qualifier
denotes a class included in the 'custom_variable_classes', a placeholder
variable will be created. Such a placeholder will not participate in a
list operation but will otherwise function as a normal string variable.

Define<type>GucVariable() functions will be added, one for each variable
type. They are inteded to be used by add-on modules like the pl<lang>
mappings. Example:

extern void DefineCustomBoolVariable(
         const char* name,
         const char* short_desc,
         const char* long_desc,
         bool* valueAddr,
         GucContext context,
         GucBoolAssignHook assign_hook,
         GucShowHook show_hook);

(I created typedefs for the assign-hook and show-hook functions). A call
to these functions will define a new GUC-variable. If a placeholder
exists it will be replaced but it's value will be used in place of the
default value. The valueAddr is assumed ot point at a default value when
the define function is called. The only constraint that is imposed on a
Custom variable is that its name is qualified.

Finally, a function:

void EmittWarningsOnPlacholders(const char* className)

was added. This function should be called when a module has completed
its variable definitions. At that time, no placeholders should remain
for the class that the module uses. If they do, elog(INFO, ...) messages
will be issued to inform the user that unrecognized variables are
present.

Thomas Hallgren
2004-05-26 15:07:41 +00:00
Bruce Momjian
cfbfdc557d This patch implement the TODO [ALTER DATABASE foo OWNER TO bar].
It was necessary to touch in grammar and create a new node to make home
to the new syntax. The command is also supported in E
CPG. Doc updates are attached too. Only superusers can change the owner
of the database. New owners don't need any aditional
privileges.

Euler Taveira de Oliveira
2004-05-26 13:57:04 +00:00
Bruce Momjian
daac2d2c48 Update Russian FAQ.
Viktor Vislobokov
2004-05-24 15:14:52 +00:00
Neil Conway
2b3f6ecdf5 Clarify an entry in the 7.4 release notes. 2004-05-24 04:54:22 +00:00
Bruce Momjian
ffd1880bb4 Add:
> * Allow GRANT/REVOKE permissions to be given to all schema objects with one command
2004-05-24 03:23:00 +00:00
Tom Lane
5fc1046f2f Fix broken markup. 2004-05-23 15:13:43 +00:00
Neil Conway
bfa1171c84 Fix a few more minor errors in the 7.4 release notes. 2004-05-22 11:06:55 +00:00
Neil Conway
76e70108e7 Fix typo in an entry in the 7.4 release notes. 2004-05-22 09:48:15 +00:00
Tom Lane
63bd0db121 Integrate src/timezone library for all platforms. There is more we can
and should do now that we control our own destiny for timezone handling,
but this commit gets the bulk of the picayune diffs in place.
Magnus Hagander and Tom Lane.
2004-05-21 05:08:06 +00:00
Bruce Momjian
40296aa2ec Remove pyton, spell check fix:
> * Support composite types as table columns
286,289d286
< * Python
< 	o Allow users to register their own types with pg_
< 	o Allow SELECT to return a dictionary of dictionaries
< 	o Allow COPY BINARY FROM
456d452
< * Support composite types as table columns
2004-05-20 16:36:14 +00:00
Bruce Momjian
8027065660 Updates from Tom:
< Bracketed items "[]" have more detailed.
> Bracketed items "[]" have more detail.
35,36d34
< * Remove unreferenced table files and temp tables during database vacuum
<   or postmaster startup (Bruce)
68c66
< * Allow pg_dump to dump sequences using NO_MAXVALUE and NO_MINVALUE
> * -Allow pg_dump to dump sequences using NO_MAXVALUE and NO_MINVALUE
70c68
< * Prevent whole-row references from leaking memory, e.g. SELECT COUNT(tab.*)
> * -Prevent whole-row references from leaking memory, e.g. SELECT COUNT(tab.*)
76c74
< * Make LENGTH() of CHAR() not count trailing spaces
> * -Make LENGTH() of CHAR() not count trailing spaces
145c143
< * Allow SELECT * FROM tab WHERE int2col = 4 to use int2col index, int8,
> * -Allow SELECT * FROM tab WHERE int2col = 4 to use int2col index, int8,
179c177
< * Allow more ISOLATION LEVELS to be accepted, but issue a warning for them
> * -Allow more ISOLATION LEVELS to be accepted
186c184
< * Add GUC setting to make created tables default to WITHOUT OIDS
> * -Add GUC setting to make created tables default to WITHOUT OIDS
265d262
< * Allow fastpast to pass values in portable format
271c268
< * Move psql backslash database information into the backend, use nmumonic
> * Move psql backslash database information into the backend, use nmeumonic
275,283d271
< * JDBC
< 	o Comprehensive test suite. This may be available already.
< 	o JDBC-standard BLOB support
< 	o Error Codes (pending backend implementation)
< 	o Support both 'make' and 'ant'
< 	o Fix LargeObject API to handle OIDs as unsigned ints
< 	o Use cursors implicitly to avoid large results (see setCursorName())
< 	o Add LISTEN/NOTIFY support to the JDBC driver (Barry)
<
332c320
< * Have pg_dump -c clear the database using dependency information
> * -Have pg_dump -c clear the database using dependency information
367,368c355,356
< * Cache last known per-tuple offsets to speed long tuple access
< * Automatically place fixed-width, NOT NULL columns first in a table
> * Cache last known per-tuple offsets to speed long tuple access, adjusting
>   for NULLs and TOAST values
467c455,456
< * Change representation of whole-tuple parameters to functions
> * -Change representation of whole-tuple parameters to functions
> * Support composite types as table columns
478,479d466
< * Allow the regression tests to start postmaster with -i so the tests
<   can be run on systems that don't support unix-domain sockets
2004-05-20 15:57:26 +00:00
Bruce Momjian
bb206b6dce Update SCO FAQ.
Larry Rosenman
2004-05-20 04:19:26 +00:00
Bruce Momjian
3e485d0ea1 Add:
> * Investigate SMP context switching issues
2004-05-20 04:10:44 +00:00
Bruce Momjian
4714dcb06c Remove item:
< * Allow col IS TRUE/FALSE use an index like col = TRUE/FALSE
2004-05-20 03:27:16 +00:00
Bruce Momjian
5f55347e33 Add:
> 	o Add default clustering to system tables
2004-05-20 02:58:18 +00:00
Bruce Momjian
f92630bdca Add:
> 	o Add ALTER DOMAIN TYPE
2004-05-20 02:07:50 +00:00
Bruce Momjian
0ca0099139 Add:
> * Allow col IS TRUE/FALSE use an index like col = TRUE/FALSE
2004-05-20 02:01:00 +00:00
Bruce Momjian
d5003e5221 Document &< and &> properly.
William White <bwhite@frognet.net>
2004-05-19 23:56:38 +00:00
Bruce Momjian
24a1fafc8d Clearify CHECK handling of unknown test values.
Karl O. Pinc
2004-05-19 23:10:43 +00:00
Bruce Momjian
952c772158 Done:
> * -Make pg_restore continue after errors, so it acts more like pg_dump scripts
2004-05-19 21:09:53 +00:00
Bruce Momjian
4c82cb9d40 Trim down relocatable docs, per Peter. 2004-05-18 21:46:25 +00:00
Bruce Momjian
dcf459e662 Add some documentation on relocatable installs. 2004-05-18 20:34:01 +00:00
Bruce Momjian
da401bd314 Add:
> * Allow binaries to be statically linked so they are more easily relocated
2004-05-18 16:06:08 +00:00
Bruce Momjian
e30efa0da1 Update Russian FAQ.
Viktor Vislobokov
2004-05-18 13:18:30 +00:00
Bruce Momjian
d14db1321b Add documentation that installations are relocatable unless configure
locations are overridden.
2004-05-17 16:06:25 +00:00
Bruce Momjian
2657c24b6d Reformat sgml doc paragraph. 2004-05-17 15:00:50 +00:00
Neil Conway
8295c27c89 Add documentation for the new "dollar quoting" feature, and update existing
examples to use dollar quoting when appropriate. Original patch from David
Fetter, additional work and editorializing by Neil Conway.
2004-05-16 23:22:08 +00:00
Neil Conway
2871f60f23 Change ln(), log(), power(), and sqrt() to emit the correct SQLSTATE
error codes for certain error conditions, as specified by SQL2003.
2004-05-16 23:18:55 +00:00
Bruce Momjian
335cf9ae7f Restore one mention of logrotate, per Peter. 2004-05-16 19:34:46 +00:00
Neil Conway
0079547bcb Implement the width_bucket() function, per SQL2003. This commit only adds
a variant of the function for the 'numeric' datatype; it would be possible
to add additional variants for other datatypes, but I haven't done so yet.

This commit includes regression tests and minimal documentation; if we
want developers to actually use this function in applications, we'll
probably need to document what it does more fully.
2004-05-14 21:42:30 +00:00
Bruce Momjian
19a495caaa Properly document rotatelogs, and add mention of it to pg_ctl manual page. 2004-05-14 20:01:19 +00:00
Neil Conway
0cb27df5c6 Improve documentation for SQLSTATE error codes, per recent thread on
-patches.
2004-05-14 18:04:02 +00:00
Bruce Momjian
3bfd4d9284 Remove:
< 	o Add PL/PHP (Joe)
2004-05-12 04:10:41 +00:00
Bruce Momjian
270c9aa34a Add DELETE:
> * Add MERGE command that does UPDATE/DELETE, or on failure, INSERT (rules, triggers?)
2004-05-11 20:23:05 +00:00
Bruce Momjian
f739deb50f Add mention of rules/triggers:
> * Add MERGE command that does UPDATE, or on failure, INSERT (rules, triggers?)
2004-05-11 13:44:05 +00:00
Tom Lane
2f63232d30 Promote row expressions to full-fledged citizens of the expression syntax,
rather than allowing them only in a few special cases as before.  In
particular you can now pass a ROW() construct to a function that accepts
a rowtype parameter.  Internal generation of RowExprs fixes a number of
corner cases that used to not work very well, such as referencing the
whole-row result of a JOIN or subquery.  This represents a further step in
the work I started a month or so back to make rowtype values into
first-class citizens.
2004-05-10 22:44:49 +00:00
Neil Conway
9a939886ac Fix typo. 2004-05-10 21:08:28 +00:00
Bruce Momjian
b071a40068 Add:
> * Add MERGE command that does UPDATE, or on failure, INSERT
2004-05-10 03:58:19 +00:00
Bruce Momjian
1fe11fad54 Fix typo. 2004-05-08 02:13:31 +00:00
Bruce Momjian
97c7cb0930 Uppercase keyword for ecpg. 2004-05-07 02:40:43 +00:00
Bruce Momjian
4d46274b33 Done:
> 	o -ALTER TABLE ADD COLUMN column SERIAL doesn't create sequence because
2004-05-06 19:32:09 +00:00
Bruce Momjian
22a2c4b576 Erase MD5 user passwords when a user is renamed because the username is
used as salt for the MD5 password.
2004-05-06 16:59:16 +00:00
Bruce Momjian
d8f6973df3 Update todo/faq timestamps 2004-05-06 16:49:13 +00:00
Bruce Momjian
a4ab5bae42 Done:
o -ALTER TABLE ADD COLUMN does not honor DEFAULT and non-CHECK CONSTRAINT
        o -ALTER TABLE ADD COLUMN column DEFAULT should fill existing
          rows with DEFAULT value
        o -Allow ALTER TABLE to modify column lengths and change to binary
          compatible types

Remove:

        o Allow columns to be reordered using ALTER ... POSITION i col1 [,col2];
          have SELECT * and INSERT honor such ordering
2004-05-05 14:36:20 +00:00
Neil Conway
3b8151a5ee Fix a typo in the documentation. 2004-05-05 09:33:38 +00:00
Tom Lane
077db40fa1 ALTER TABLE rewrite. New cool stuff:
* ALTER ... ADD COLUMN with defaults and NOT NULL constraints works per SQL
spec.  A default is implemented by rewriting the table with the new value
stored in each row.

* ALTER COLUMN TYPE.  You can change a column's datatype to anything you
want, so long as you can specify how to convert the old value.  Rewrites
the table.  (Possible future improvement: optimize no-op conversions such
as varchar(N) to varchar(N+1).)

* Multiple ALTER actions in a single ALTER TABLE command.  You can perform
any number of column additions, type changes, and constraint additions with
only one pass over the table contents.

Basic documentation provided in ALTER TABLE ref page, but some more docs
work is needed.

Original patch from Rod Taylor, additional work from Tom Lane.
2004-05-05 04:48:48 +00:00
Neil Conway
4ef8b2f901 Fix obscure typo in 7.4.0 release notes. 2004-05-03 08:47:54 +00:00
Bruce Momjian
7ebd5dafd8 Assign item:
< 	o Add ALTER TABLE table SET WITHOUT CLUSTER
> 	o Add ALTER TABLE table SET WITHOUT CLUSTER (Christopher)
2004-05-02 12:27:45 +00:00
Bruce Momjian
846cd0f1c2 Update TODO item:
o Add ALTER TABLE table SET WITHOUT CLUSTER
2004-05-02 12:27:00 +00:00
Bruce Momjian
1a273556a3 Update Japanese FAQ.
Jun Kuwamura
2004-05-01 01:27:03 +00:00
Tom Lane
f378288e3b Minor copy-editing. 2004-04-29 04:37:09 +00:00
Bruce Momjian
a3b0c90e24 Fix typo:
<   columns and indexes with many duplicate keys
2004-04-28 16:35:36 +00:00
Neil Conway
a3015829ee Fix typo in libpq docs. 2004-04-24 22:58:40 +00:00
Neil Conway
f0c3a09ab3 Document that PQoidValue(), PQcmdTuples(), and PQoidStatus() now work
when the command that generated the PGresult was an EXECUTE of an
appropriate prepared statement.
2004-04-24 22:53:44 +00:00
Bruce Momjian
f5dd5bf297 Add mention to run thread test program if user is experiencing problems
with threaded applications.
2004-04-24 00:14:28 +00:00
Neil Conway
fc7fd50182 Add ceiling() as an alias for ceil(), and power() as an alias for pow().
Regression tests and documentation have both been updated.

SQL2003 requires that both ceiling() and ceil() be present, so I have
documented both spellings. SQL2003 doesn't mention pow() as far as I
can see, so I decided to replace pow() with power() in the documentation:
there is little reason to encourage the continued usage of a function
that isn't compliant with the standard, given a standard-compliant
alternative.

RELEASE NOTES: should state that pow() is considered deprecated
(although I don't see the need to ever remove it.)
2004-04-23 20:32:20 +00:00
Neil Conway
0fa2afa93a Make psql's \d+ command indicate whether the table in question
contains OIDs. Also, minor documentation improvements to the
psql reference page.
2004-04-22 17:38:16 +00:00
Bruce Momjian
65b020bd61 Fix filename mention in psqlrc.sample file. 2004-04-22 14:33:49 +00:00
Tom Lane
19f1649bed Put information about tag in Outputs section, where it belongs. 2004-04-22 11:46:22 +00:00
Peter Eisentraut
c16fa67c87 Fix typo 2004-04-22 08:36:48 +00:00
Neil Conway
2ff4e44043 Improvements to the backup & restore documentation. 2004-04-22 07:02:36 +00:00
Bruce Momjian
e3391133ae Update EXECUTE docs to mention tag matches prepared statement.
Update log_statement to more clearly state it doesn't filter based on
the statement type of the prepared statement.
2004-04-22 04:18:41 +00:00
Bruce Momjian
be6bbcef56 Add global psql config file, psql.rc.sample. 2004-04-22 01:53:37 +00:00
Neil Conway
4906841901 Minor improvement to CREATE AGGREGATE docs: add an xref to the docs for
builtin aggregate functions.
2004-04-21 21:52:41 +00:00
Peter Eisentraut
aeee856564 New link for Solaris IPC article 2004-04-21 13:18:28 +00:00
Bruce Momjian
49d3d9cf40 Change COPY CSV keyword to be:
FORCE QUOTE to force quotes
	FORCE NOT NULL to quote null input values
2004-04-21 00:34:18 +00:00
Bruce Momjian
2d1221bf89 Done:
< * Add NO WAIT option to various SQL commands
> * -Add NO WAIT LOCKs
2004-04-20 20:16:30 +00:00
Bruce Momjian
6022a7d72f Add doc mention that:
process directly.  Some parameters can only be set at server start;
    any changes to their entries in the configuration file will be ignored
    until the server is restarted.
2004-04-20 16:56:19 +00:00
Bruce Momjian
cfb8d57ba1 Add:
> * Allow AFTER triggers on system tables
2004-04-20 14:03:30 +00:00
Bruce Momjian
8149029162 Improve IS NULL partial index wording. 2004-04-20 12:53:28 +00:00
Bruce Momjian
8b10da1056 Done:
> * -Exit postmaster if postgresql.conf can not be opened
2004-04-20 04:26:27 +00:00
Bruce Momjian
bb18b47390 Document partial indexes for IS NULL lookups. 2004-04-20 04:25:47 +00:00
Bruce Momjian
2f2a3439a5 Remove additional tcl doc mention. 2004-04-20 01:14:55 +00:00
Bruce Momjian
c310d28766 Remove TCL docs. 2004-04-20 01:11:49 +00:00
Bruce Momjian
6ef77149f7 > >> My question is whether postgres can index null values, and if not, do I
> >> have to accept a full table scan when locating records.
> >
> > It indexes them, but "is null" is not an indexable operator, so you
> > can't directly solve the above with a 3-column index.  What you can do
> > instead is use a partial index, for instance
> >
> > create index i on CUSTOMER.WCCustOrderStatusLog (WCOrderStatusID)
> > where Acknowledged is null and Processing is null;
>
> That's a very nifty trick and exactly the sort of answer I was after!

Add CREATE INDEX doc mention of using partial indexes for IS NULL
indexing;  idea from Tom.
2004-04-20 01:00:26 +00:00
Bruce Momjian
d1b3915ce1 In reading the 7.4.2 docs, the sql reference page for PREPARE doesn't
reference DEALLOCATE in any way. It points to EXECUTE, but not to
DEALLOCATE. Suggested fix:

... This also means that a single  prepared statement cannot be used by
multiple simultaneous database clients; however, each client can create
their own prepared statement  to use. The prepared statement can be
manually cleaned up using the DEALLOCATE command.

James Robinson
2004-04-19 23:36:48 +00:00
Bruce Momjian
862b20b382 Complete TODO item:
o -Allow dump/load of CSV format

This adds new keywords to COPY and \copy:

        CSV - enable CSV mode (comma separated variable)
        QUOTE - specify quote character
        ESCAPE - specify escape character
        FORCE - force quoting of specified column
	LITERAL - suppress null comparison for columns

Doc changes included.  Regression updates coming from Andrew.
2004-04-19 17:22:31 +00:00
Bruce Momjian
83ab1c0475 Done:
> 	o -Allow dump/load of CSV format
2004-04-19 17:03:13 +00:00
Bruce Momjian
7931a8fdd1 Fix typo:
< * -Allow psql \du to show groups, and add \dg for groups
> * -Allow psql \du to show users, and add \dg for groups
2004-04-19 15:37:56 +00:00
Bruce Momjian
77c7e8bcb8 Clarify meaning of second DateStyle value. 2004-04-15 04:46:18 +00:00
Bruce Momjian
18229e080c Update name:
< * Alvaro Herrera <alvherre@dcc.uchile.cl>
> * Alvaro is Alvaro Herrera <alvherre@dcc.uchile.cl>
2004-04-14 19:15:27 +00:00
Bruce Momjian
76e953bd70 Update owners of items:
< * Add the concept of dataspaces/tablespaces [tablespaces]
> * Add the concept of dataspaces/tablespaces [tablespaces] (Gavin)
167c167
< * Allow savepoints / nested transactions [transactions] (Bruce)
> * Allow savepoints / nested transactions [transactions] (Alvaro)
240c240
< 	o Allow Java server-side programming [java]
> 	o Allow Java server-side programming [java] (Dave)
496a497
> * Alvaro Herrera <alvherre@dcc.uchile.cl>
2004-04-14 18:33:03 +00:00
Bruce Momjian
abdabeb995 Change psql \copy stdin/stdout to read from command input/output.
Add pstdin/pstdout to read from psql's stdin/stdout.

BACKWARD INCOMPATIBLE CHANGE
2004-04-12 15:58:52 +00:00
Bruce Momjian
7b3189c185 > > This update fixes a few small typos in names,
> > pronouns and formatting in the Russian FAQ.

Serguei Mokhov
2004-04-12 03:22:20 +00:00
Bruce Momjian
1934055cbe Please find a small patch to fix the brain damage "century" and
"millennium" date part implementation in postgresql, both in the code
and the documentation, so that it conforms to the official definition.
If you do not agree with the official definition, please send your
complaint to "pope@vatican.org". I'm not responsible for them;-)

With the previous version, the centuries and millenniums had a wrong
number and started the wrong year. Moreover century number 0, which does
not exist in reality, lasted 200 years. Also, millennium number 0 lasted
2000 years.

If you want postgresql to have it's own definition of "century" and
"millennium" that does not conform to the one of the society, just give
them another name. I would suggest "pgCENTURY" and "pgMILLENNIUM";-)

IMO, if someone may use the options, it means that postgresql is used for
historical data, so it make sense to have an historical definition. Also,
I just want to divide the year by 100 or 1000, I can do that quite easily.

BACKWARD INCOMPATIBLE CHANGE

Fabien Coelho - coelho@cri.ensmp.fr
2004-04-10 18:02:59 +00:00
Bruce Momjian
296f485492 Remove libpgeasy and odbc doc reference in filelist.sgml --- removed to
gborg.
2004-04-09 18:03:13 +00:00
Bruce Momjian
14bd7a0181 Add SQL 2003 standards. 2004-04-07 23:32:30 +00:00
Bruce Momjian
9fa14b1ea0 Remove bad URL. 2004-04-07 22:02:03 +00:00
Bruce Momjian
d17c92b24f Update:
< * Allow LOCALE on a per-column basis, default to ASCII
> * Allow locale to be set at database creation
> * Allow locale on a per-column basis, default to ASCII
> * Optimize locale to have minimal performance impact when not used (Peter E)
105d106
< * Optimize locale to have minimal performance impact when not used (Peter E)
111d111
< * Allow locale to be set at database creation
2004-04-07 19:14:21 +00:00
Bruce Momjian
75688a27d2 Add:
> * Allow locale to be set at database creation
2004-04-07 18:34:44 +00:00
Bruce Momjian
f1d0269861 Done:
> * -Allow logging of only data definition(DDL), or DDL and modification statements

Add:
> * Add a session mode to warn about non-standard SQL usage
2004-04-07 17:04:45 +00:00
Bruce Momjian
58a1cb1024 Update FAQ_DEV. 2004-04-07 14:23:32 +00:00
Bruce Momjian
6a25c6e1d1 > >>1. change the type of "log_statement" option from boolean to string,
> >>with allowed values of "all, mod, ddl, none" with default "none".

OK, here is a patch that implements #1.  Here is sample output:

        test=> set client_min_messages = 'log';
        SET
        test=> set log_statement = 'mod';
        SET
        test=> select 1;
         ?column?
        ----------
                1
        (1 row)

        test=> update test set x=1;
        LOG:  statement: update test set x=1;
        ERROR:  relation "test" does not exist
        test=> update test set x=1;
        LOG:  statement: update test set x=1;
        ERROR:  relation "test" does not exist
        test=> copy test from '/tmp/x';
        LOG:  statement: copy test from '/tmp/x';
        ERROR:  relation "test" does not exist
        test=> copy test to  '/tmp/x';
        ERROR:  relation "test" does not exist
        test=> prepare xx as select 1;
        PREPARE
        test=> prepare xx as update x set y=1;
        LOG:  statement: prepare xx as update x set y=1;
        ERROR:  relation "x" does not exist
        test=> explain analyze select 1;;
                                             QUERY PLAN
        ------------------------------------------------------------------------------------
         Result  (cost=0.00..0.01 rows=1 width=0) (actual time=0.006..0.007 rows=1 loops=1)
         Total runtime: 0.046 ms
        (2 rows)

        test=> explain analyze update test set x=1;
        LOG:  statement: explain analyze update test set x=1;
        ERROR:  relation "test" does not exist
        test=> explain update test set x=1;
        ERROR:  relation "test" does not exist

It checks PREPARE and EXECUTE ANALYZE too.  The log_statement values are
'none', 'mod', 'ddl', and 'all'.  For 'all', it prints before the query
is parsed, and for ddl/mod, it does it right after parsing using the
node tag (or command tag for CREATE/ALTER/DROP), so any non-parse errors
will print after the log line.
2004-04-07 05:05:50 +00:00
Bruce Momjian
6165bbab8c Remove 'syslog' GUC variable, and add more logical 'log_destination'
variable to control logoutput location on Unix and Win32.

Magnus Hagander
2004-04-05 03:02:11 +00:00
Tom Lane
375369acd1 Replace TupleTableSlot convention for whole-row variables and function
results with tuples as ordinary varlena Datums.  This commit does not
in itself do much for us, except eliminate the horrid memory leak
associated with evaluation of whole-row variables.  However, it lays the
groundwork for allowing composite types as table columns, and perhaps
some other useful features as well.  Per my proposal of a few days ago.
2004-04-01 21:28:47 +00:00
Bruce Momjian
076055ed10 Add description of log_statement_stats's function (total statement stats
rather than per-stage stats).
2004-03-31 19:59:22 +00:00
Bruce Momjian
a302b8e150 Back out tutorial changes:
---------------------------------------------------------------------------

1.  In keeping with the recent discussion that there should be more
said about views, stored procedures, and triggers, in the tutorial, I
have added a bit of verbiage to that end.

2.  Some formatting changes to the datetime discussion, as well as
addition of a citation of a relevant book on calendars.

Christopher Browne
2004-03-31 16:20:53 +00:00
Bruce Momjian
7d15b90e5b Add psql backslash command discussion. 2004-03-31 01:05:54 +00:00
Bruce Momjian
b5db560c7a Add:
* Move psql backslash database information into the backend, use
nmumonic commands? [psql]
2004-03-31 01:04:49 +00:00
Bruce Momjian
07ff3afa2a Remove:
* Prevent unneeded quoting in psql \d output using fmtId()
2004-03-31 01:01:38 +00:00
Bruce Momjian
7b43450931 Fix markup errors from recent patch. 2004-03-30 22:08:50 +00:00
Bruce Momjian
aaad011940 1. In keeping with the recent discussion that there should be more
said about views, stored procedures, and triggers, in the tutorial, I
have added a bit of verbiage to that end.

2.  Some formatting changes to the datetime discussion, as well as
addition of a citation of a relevant book on calendars.

Christopher Browne
2004-03-30 21:58:20 +00:00
Bruce Momjian
cf9c2be7e8 Add:
> * Add GUC variable to allow output of interval values in ISO8601 format
2004-03-30 21:51:41 +00:00
Bruce Momjian
45edc20283 Add mention of how to use \df to find functions using/returning specific
data types.
2004-03-30 15:54:33 +00:00
Bruce Momjian
fd071bd478 Fix to_char for 1 BC. Previously it returned 1 AD.
Fix to_char(year) for BC dates.  Previously it returned one less than
the current year.

Add documentation mentioning that there is no 0 AD.
2004-03-30 15:53:18 +00:00
Bruce Momjian
80683f2a07 Update FAQ from Robert Treat 2004-03-29 05:07:20 +00:00
Neil Conway
1090aa8cc7 More cross-reference work, other minor SGML fixes and improvements. 2004-03-26 03:18:28 +00:00
Tom Lane
7a944e41b4 Convert some GUC variable references to links. 2004-03-25 18:57:57 +00:00
Tom Lane
8899a2aba9 Replace max_expr_depth parameter with a max_stack_depth parameter that
is measured in kilobytes and checked against actual physical execution
stack depth, as per my proposal of 30-Dec.  This gives us a fairly
bulletproof defense against crashing due to runaway recursive functions.
2004-03-24 22:40:29 +00:00
Bruce Momjian
a09b9a36d3 Add:
* Have pg_dump use multi-statement transactions for INSERT dumps
2004-03-24 18:15:56 +00:00
Neil Conway
ce5273757b Make a cross-reference in the ALTER TABLE ref page into a <xref>. 2004-03-24 09:49:20 +00:00
Neil Conway
d6bc5944a0 Fix a minor typo in the log_line_prefix docs and make a couple other
tiny improvements.
2004-03-24 03:48:41 +00:00
Bruce Momjian
6daf396879 Add thread locking to SSL and Kerberos connections.
I have removed the docs mentioning that SSL and Kerberos are not
thread-safe.

Manfred Spraul
2004-03-24 03:45:00 +00:00
Bruce Momjian
fcfa2c790a Document fallback to tcp/ip localhost connection from psql on ports
without unix domain sockets (win32).
2004-03-24 03:27:46 +00:00
Tom Lane
1c4da387ad PQresult should be PGresult. 2004-03-23 23:37:17 +00:00
Tom Lane
8ed89773c5 Fix small typo. 2004-03-23 22:57:09 +00:00
Tom Lane
121cf2b904 Repair misleading description of MOVE's command tag result. 2004-03-23 22:39:22 +00:00