Commit Graph

5851 Commits

Author SHA1 Message Date
Tom Lane a2fb7b8a1f Adjust lo_open() so that specifying INV_READ without INV_WRITE creates
a descriptor that uses the current transaction snapshot, rather than
SnapshotNow as it did before (and still does if INV_WRITE is set).
This means pg_dump will now dump a consistent snapshot of large object
contents, as it never could do before.  Also, add a lo_create() function
that is similar to lo_creat() but allows the desired OID of the large
object to be specified.  This will simplify pg_restore considerably
(but I'll fix that in a separate commit).
2005-06-13 02:26:53 +00:00
Tom Lane f52a34229b Document the --enable-integer-datetimes configure option where the other
configure options are documented.  Per Michael Glaesemann.
2005-06-12 15:51:50 +00:00
Neil Conway 72a5db15d1 libpq was not consistently checking for memory allocation failures. This
patch adds missing checks to the call sites of malloc(), strdup(),
PQmakeEmptyPGresult(), pqResultAlloc(), and pqResultStrdup(), and updates
the documentation. Per original report from Volkan Yazici about
PQmakeEmptyPGresult() not checking for malloc() failure.
2005-06-12 00:00:21 +00:00
Bruce Momjian e4c76191a9 Add space before :DBNAME for proper \set expansion.
Andreas Seltenreich
2005-06-10 16:31:48 +00:00
Neil Conway a89c109e30 Minor cleanup of documentation for recently-added HISTFILE psql variable. 2005-06-10 16:26:59 +00:00
Neil Conway d46bc444ac Implement two new special variables in PL/PgSQL: SQLSTATE and SQLERRM.
These contain the SQLSTATE and error message of the current exception,
respectively. They are scope-local variables that are only defined
in exception handlers (so attempting to reference them outside an
exception handler is an error). Update the regression tests and the
documentation.

Also, do some minor related cleanup: export an unpack_sql_state()
function from the backend and use it to unpack a SQLSTATE into a
string, and add a free_var() function to pl_exec.c

Original patch from Pavel Stehule, review by Neil Conway.
2005-06-10 16:23:11 +00:00
Bruce Momjian ea88824a3e the following patch makes the filename used to store the readline
history customizable through a variable named HISTFILE, analogous to
psql's already implemented HISTCONTROL and HISTSIZE variables, and
bash's HISTFILE-Variable.

The motivation was to be able to get psql to maintain separate
histories for separate databases.  This is now easily achievable
through a line like the following in ~/.psqlrc:

\set HISTFILE ~/.psql_history-:DBNAME

Andreas Seltenreich
2005-06-10 15:34:26 +00:00
Bruce Momjian 453d74b99c Add the "PGPASSFILE" environment variable to specify to the password
file.

Andrew Dunstan
2005-06-10 03:02:30 +00:00
Bruce Momjian 3572e531ca Mention prefix %t has no milliseconds. 2005-06-09 22:35:23 +00:00
Bruce Momjian 6c2ba14d8d This patch against 8.0.0beta1 source adds log_line_prefix options for
millisecond timestamps (%m) and remote host (%h). The milliseconds are
useful for QPS measurements.

Ed L.
2005-06-09 22:29:52 +00:00
Tom Lane 0b8e46e49b Repair error in description of nonblocking usage of PQgetCopyData().
Per Volkan Yazici.
2005-06-09 19:08:28 +00:00
Peter Eisentraut 65d27324c3 Add example for pg_config --configure. 2005-06-09 18:15:05 +00:00
Bruce Momjian ebc8649892 Since I needed this feature badly, I added the -n / --schema switch to
pg_restore. It restores the given schemaname only. It can be used in
conjunction with the -t and other switches to make the selection very
fine grained.

Richard van den Bergg, CISSP
2005-06-09 17:56:51 +00:00
Bruce Momjian 4d0e7b4aac Please find attached a patch (diff -c against cvs HEAD) to add a
function that accepts a double precision argument assumed to be a Unix
epoch timestamp and returns timestamp with time zone, and accompanying
documentation.

Usage:

test=# select to_timestamp(200120400);
       to_timestamp
------------------------
  1976-05-05 14:00:00+09
(1 row)

Michael Glaesemann
2005-06-09 16:35:09 +00:00
Bruce Momjian 4a5cda7bba I've created a patch which adds support for troff "-ms" output to
psql.  i.e. "\pset format troff-ms".  The patch also corrects some
problems with the "latex" format, notably defining an extra column in
the output table, and correcting some alignment issues; it also
changes the output to match the border setting as documented in the
manual page and as shown with the "aligned" format.

The troff-ms output is mostly identical to the latex output allowing
for the differences between the two typesetters.

The output should be saved in a file and piped as follows:

  cat file | tbl | troff -T ps -ms > file.ps
or
  tbl file | troff -T ps -ms > file.ps

Because it contains tabs, you'll need to redirect psql output or use
"script", rather than pasting from a terminal window, due to the tabs
which can be replaced with spaces.

Roger Leigh
2005-06-09 15:27:27 +00:00
Bruce Momjian c51815afed Remove idea of schema 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.
<
> 	o Allow databases to be moved to different tablespaces
484c480
< 	  schema. Global system tables can never be moved.
> 	  tablespace. Global system tables can never be moved.
2005-06-09 03:00:43 +00:00
Tom Lane 77c168a836 Remove grammar productions for prefix and postfix % and ^ operators,
as well as the existing pg_catalog entries for prefix and postfix %.
These have never been documented, though they did appear in one old
regression test.  This avoids surprising behavior in cases like
"SELECT -25 % -10".  Per recent discussion.
Note: although there is a catalog change here, I did not force initdb
since there's no harm in leaving the inaccessible entries in one's
copy of pg_operator.
2005-06-08 21:15:29 +00:00
Tom Lane f5b2f60bd1 Change WAL-logging scheme for multixacts to be more like regular
transaction IDs, rather than like subtrans; in particular, the information
now survives a database restart.  Per previous discussion, this is
essential for PITR log shipping and for 2PC.
2005-06-08 15:50:28 +00:00
Bruce Momjian b3e798d750 Fix word wrap:
<   changes made by the interface driver for its internal use.  One idea is
<   for this to be a protocol-only feature.  Another approach is to notify
<   the protocol when a RESET CONNECTION command is used.
>   changes made by the interface driver for its internal use.  One idea
>   is for this to be a protocol-only feature.  Another approach is to
>   notify the protocol when a RESET CONNECTION command is used.
2005-06-07 14:12:07 +00:00
Neil Conway 657c098e41 Add a function lastval(), which returns the value returned by the
last nextval() or setval() performed by the current session. Update the
docs, add regression tests, and bump the catalog version. Patch from
Dennis Björklund, various improvements by Neil Conway.
2005-06-07 07:08:35 +00:00
Neil Conway c59887f916 Add support for an optional INTO clause to PL/PgSQL's EXECUTE command.
This allows the result of executing a SELECT to be assigned to a row
variable, record variable, or list of scalars. Docs and regression tests
updated. Per Pavel Stehule, improvements and cleanup by Neil Conway.
2005-06-07 02:47:23 +00:00
Bruce Momjian 0f011f6daa Update text for RESET CONNECTION:
<   all temporary tables, removal of any NOTIFYs, cursors, prepared
<   queries(?), currval()s, etc.  This could be used for connection pooling.
<   We could also change RESET ALL to have this functionality.
>   temporary tables, removing any NOTIFYs, cursors, open transactions,
>   prepared queries, currval()s, etc.  This could be used  for connection
>   pooling.  We could also change RESET ALL to have this functionality.
>   The difficult of this features is allowing RESET ALL to not affect
>   changes made by the interface driver for its internal use.  One idea is
>   for this to be a protocol-only feature.  Another approach is to notify
>   the protocol when a RESET CONNECTION command is used.
2005-06-07 01:59:39 +00:00
Bruce Momjian d714560658 Add rtee box index discussion. 2005-06-06 22:12:00 +00:00
Bruce Momjian 5859215015 Add:
> * Fix incorrect rtree results due to wrong assumptions about "over"
>   operator semantics [rtree]
2005-06-06 22:03:44 +00:00
Bruce Momjian 928b06a6cc Update Hungarian FAQ and add an HTML version.
Laszlo Hornyak
2005-06-06 16:30:42 +00:00
Tom Lane 128c25b52f Trivial markup improvement. 2005-06-06 16:29:01 +00:00
Tom Lane 9ab4d98168 Remove planner's private fields from Query struct, and put them into
a new PlannerInfo struct, which is passed around instead of the bare
Query in all the planning code.  This commit is essentially just a
code-beautification exercise, but it does open the door to making
larger changes to the planner data structures without having to muck
with the widely-known Query struct.
2005-06-05 22:32:58 +00:00
Bruce Momjian 22dbd54047 Add description for backend termination:
<   cleaned up properly.  A new signal is needed for safe termination.
>   cleaned up properly.  A new signal is needed for safe termination
>   because backends must first do a query cancel, then exit once they
>   have run the query cancel cleanup routine.
2005-06-05 03:39:54 +00:00
Bruce Momjian bebe7c5600 Here's a patch to do the following:
1. Rename spi_return_next to return_next.
2. Add a new test for return_next.
3. Update the expected output.
4. Update the documentation.

Abhijit Menon-Sen
2005-06-05 03:16:42 +00:00
Bruce Momjian 82468b428b Add 2phase TODO.detail. 2005-06-05 00:46:13 +00:00
Bruce Momjian ec480a5277 Add TODO.detail for 2phase commit:
> * Add two-phase commit [2phase]
2005-06-05 00:45:22 +00:00
Bruce Momjian efe0d0808b Add TODO.detail.
<   logs
>   logs [pitr]
130c130
< * Allow a warm standby system to also allow read-only queries
> * Allow a warm standby system to also allow read-only queries [pitr]
2005-06-05 00:28:36 +00:00
Bruce Momjian 8805c835c8 Remove duplicate emails. 2005-06-05 00:22:35 +00:00
Bruce Momjian 3a272cf032 Add TODO.detail for timezone:
<   information, either zone name or offset from UTC
>   information, either zone name or offset from UTC [timezone]
2005-06-05 00:20:02 +00:00
Bruce Momjian 32f4ae568c Add TODO.detail of standard timezone data type. 2005-06-05 00:18:42 +00:00
Bruce Momjian f54f142a61 Add pg_upgrade TODO.detail. 2005-06-04 23:33:17 +00:00
Bruce Momjian 581a8c9f6d Add TODO.detail:
> * Allow major upgrades without dump/reload, perhaps using pg_upgrade
>   [pg_upgrade]
2005-06-04 23:32:34 +00:00
Bruce Momjian d95fad64d4 Add pg_dump TODO.detail for multiple -t / -n flags. 2005-06-04 23:07:15 +00:00
Bruce Momjian 249880ffae Add pg_dump to TODO.detail. 2005-06-04 23:06:29 +00:00
Bruce Momjian 72c53ac3a7 Allow kerberos name and username case sensitivity to be specified from
postgresql.conf.

---------------------------------------------------------------------------


Here's an updated version of the patch, with the following changes:

1) No longer uses "service name" as "application version". It's instead
hardcoded as "postgres". It could be argued that this part should be
backpatched to 8.0, but it doesn't make a big difference until you can
start changing it with GUC / connection parameters. This change only
affects kerberos 5, not 4.

2) Now downcases kerberos usernames when the client is running on win32.

3) Adds guc option for "krb_caseins_users" to make the server ignore
case mismatch which is required by some KDCs such as Active Directory.
Off by default, per discussion with Tom. This change only affects
kerberos 5, not 4.

4) Updated so it doesn't conflict with the rendevouz/bonjour patch
already in ;-)

Magnus Hagander
2005-06-04 20:42:43 +00:00
Bruce Momjian 3360bc1351 Add:
> * Allow pg_ctl to work properly with configuration files located outside
>   the PGDATA directory
>
>   pg_ctl can not read the pid file because it isn't located in the
>   config directory but in the PGDATA directory.  The solution is to
>   allow pg_ctl to read and understand postgresql.conf to find the
>   data_directory value.
>
2005-06-04 18:12:38 +00:00
Bruce Momjian 487990e1f1 Add description:
>
>   O_DIRECT doesn't have the same media write guarantees as fsync, so it
>   is in addition to the fsync method, not in place of it.
>
2005-06-04 16:53:48 +00:00
Bruce Momjian a76606454c Update Chinese FAQ to fix XHTML format.
Weiping (Laser)
2005-06-04 03:28:57 +00:00
Bruce Momjian 7e209f6ce3 Put back WAL TODO.detail entries. 2005-06-03 21:46:02 +00:00
Bruce Momjian bace84cca1 Remove because it is partly done and we might not want to go farther:
< * -Compress WAL entries [wal]
2005-06-03 21:42:21 +00:00
Bruce Momjian 1bdec3424b Update Russian FAQ.
Viktor Vislobokov
2005-06-03 18:17:07 +00:00
Bruce Momjian 97e455c9b9 Trim TODO.detail for wal completed items. 2005-06-03 17:14:17 +00:00
Bruce Momjian 2a61c090a9 Done:
> * -Compress WAL entries [wal]
2005-06-03 16:38:02 +00:00
Bruce Momjian a14fb14f7f Done:
> * -Change WAL to use 32-bit CRC, for performance reasons
2005-06-03 16:36:50 +00:00
Bruce Momjian c196c7ae8b Completed:
< 	o Allow COPY to understand \x as a hex byte
> 	o -Allow COPY to understand \x as a hex byte
2005-06-02 01:27:58 +00:00
Bruce Momjian b51366396b Add support for \x hex strings in psql variables. 2005-06-02 01:23:48 +00:00
Bruce Momjian 65537ac1b4 Add support for \x hex escapes in backend strings. Octal was already
supported.  This follows the C standard escapes.
2005-06-02 01:23:08 +00:00
Bruce Momjian 202e6e73e6 Add support for \x hex escapes in COPY.
Sergey Ten
2005-06-02 01:21:22 +00:00
Bruce Momjian 5b3625f1b7 Tab cleanup for SGML.
Robert Treat
2005-05-31 14:48:47 +00:00
Tom Lane 978129f28e Document get_call_result_type() and friends; mark TypeGetTupleDesc()
and RelationNameGetTupleDesc() as deprecated; remove uses of the
latter in the contrib library.  Along the way, clean up crosstab()
code and documentation a little.
2005-05-30 23:09:07 +00:00
Bruce Momjian b215fae891 Move to ALTER section:
< * Prevent child tables from altering constraints like CHECK that were
<   inherited from the parent table
470a469,471
>
> 	o Prevent child tables from altering constraints like CHECK that were
> 	  inherited from the parent table
2005-05-30 21:12:23 +00:00
Bruce Momjian 09439e212e Add:
> * Prevent child tables from altering constraints like CHECK that were
>   inherited from the parent table
2005-05-30 21:08:27 +00:00
Bruce Momjian a54c21a59c Wording improvement (may -> can) 2005-05-30 19:32:44 +00:00
Bruce Momjian a2cce84349 Update psql docs for recent octal-only string behavior. 2005-05-30 15:24:23 +00:00
Bruce Momjian 6616e23264 Add missing <P>. 2005-05-30 13:11:06 +00:00
Bruce Momjian ecd70d7526 Add reference to libpq environment variables for client applications. 2005-05-29 03:32:18 +00:00
Bruce Momjian 70f320495f Remove:
<
< * Add XML output to pg_dump and COPY
<
<   We already allow XML to be stored in the database, and XPath queries
<   can be used on that data using /contrib/xml2. It also supports XSLT
<   transformations.
2005-05-28 04:12:13 +00:00
Bruce Momjian dd67cf365a Update Farsi FAQ.
Mahmoud Taghizadeh
2005-05-27 22:09:42 +00:00
Bruce Momjian 42319310dc Add:
> * Consider sorting hash buckets so entries can be found using a binary
>   search, rather than a linear scan
> * In hash indexes, consider storing the hash value with or instead
>   of the key itself
2005-05-27 22:07:26 +00:00
Bruce Momjian 770156e157 Add:
> * Add the features of packages
> 	o  Make private objects accessable only to objects in the same schema
> 	o  Allow current_schema.objname to access current schema objects
> 	o  Add session variables
> 	o  Allow nested schemas
2005-05-27 22:01:18 +00:00
Tom Lane 357ea45b57 Document that utility commands such as DROP FUNCTION allow argument names
and modes to be included when naming an existing function.
2005-05-26 20:05:03 +00:00
Bruce Momjian dabde323b2 Back out SQLSTATE and SQLERRM support. 2005-05-26 04:08:32 +00:00
Bruce Momjian 38af680ad5 Add PL/pgSQL SQLSTATE and SQLERRM support which sets these values on
error.

Pavel Stehule
2005-05-26 00:16:31 +00:00
Neil Conway 13b729ca52 Editing for the new "Encryption Options" section of the manual. 2005-05-25 02:56:15 +00:00
Neil Conway 1b41965d5d Remove some verbiage describing how min() and max() are slow when applied
to the entire table: as of current sources, they are no longer slow
provided there is an index on the column.
2005-05-23 01:50:01 +00:00
Neil Conway dd2894dfd6 Consistently do not include a terminating period in single-sentence
function descriptions in func.sgml; other minor SGML tweaks.
2005-05-23 01:29:54 +00:00
Bruce Momjian c61207b091 INT4 is probably enough:
< * Allow INET + INT4/INT8 to increment the host part of the address, or
> * Allow INET + INT4 to increment the host part of the address, or
2005-05-21 21:31:26 +00:00
Bruce Momjian 2e9c04eedb Mention overflow:
<   throw an error
>   throw an error on overflow
2005-05-21 03:12:44 +00:00
Bruce Momjian 6dab58a643 Add:
> * Allow INET + INT4/INT8 to increment the host part of the address, or
>   throw an error
2005-05-21 03:11:27 +00:00
Bruce Momjian e954cd2bc2 Remove 2-phase description, because it isn't accurate anymore:
<
<   This will involve adding a way to respond to commit failure by either
<   taking the server into offline/readonly mode or notifying the
<   administrator
2005-05-20 19:18:15 +00:00
Bruce Momjian 6e85414647 Update Japanese FAQ.
Jun Kuwamura
2005-05-20 15:53:06 +00:00
Bruce Momjian 6dc7760ac3 Add support for wal_fsync_writethrough for Darwin, and restructure the
code to better handle writethrough.

Chris Campbell
2005-05-20 14:53:26 +00:00
Neil Conway e9b33ed6cd Fix typo in ECPG docs, per Andreas Seltenreich. 2005-05-20 12:36:48 +00:00
Neil Conway 4de23092d0 Add some links to the CREATE FUNCTION reference page when describing
function definition for particular PLs. Original patch from David
Fetter, editorializing by Neil Conway.
2005-05-20 01:52:25 +00:00
Neil Conway ee85870e23 Make the CREATE RULE syntax description in rules.sgml more consistent
with the syntax description in the CREATE RULE reference page. From
Kris Jurka.
2005-05-20 01:37:08 +00:00
Neil Conway f3567eeaf2 Implement md5(bytea), update regression tests and documentation. Patch
from Abhijit Menon-Sen, minor editorialization from Neil Conway. Also,
improve md5(text) to allocate a constant-sized buffer on the stack
rather than via palloc.

Catalog version bumped.
2005-05-20 01:29:56 +00:00
Tom Lane a9c4c9cd52 Extend the pg_locks system view so that it can fully display all lock
types, as per recent discussion.
2005-05-17 21:46:11 +00:00
Bruce Momjian 5185cc8eae Update:
< * All ability to monitor the use of temporary sort files
> * Add ability to monitor the use of temporary sort files
2005-05-17 04:18:20 +00:00
Bruce Momjian 5e1bfa82dd Convert Chinese FAQ to valid XHTML, finally. 2005-05-17 04:17:47 +00:00
Bruce Momjian 472f9be471 Fix Chinese markup some more. 2005-05-17 03:40:35 +00:00
Neil Conway eda6dd32d1 GiST improvements:
- make sure we always invoke user-supplied GiST methods in a short-lived
  memory context. This means the backend isn't exposed to any memory leaks
  that be in those methods (in fact, it is probably a net loss for most
  GiST methods to bother manually freeing memory now). This also means
  we can do away with a lot of ugly manual memory management in the
  GiST code itself.

- keep the current page of a GiST index scan pinned, rather than doing a
  ReadBuffer() for each tuple produced by the scan. Since ReadBuffer() is
  expensive, this is a perf. win

- implement dead tuple killing for GiST indexes (which is easy to do, now
  that we keep a pin on the current scan page). Now all the builtin indexes
  implement dead tuple killing.

- cleanup a lot of ugly code in GiST
2005-05-17 00:59:30 +00:00
Bruce Momjian 818bfda1e2 Fix markup:
< 	* Add internationalized message strings
> 	o Add internationalized message strings
2005-05-17 00:51:58 +00:00
Bruce Momjian ce1b3065c3 Update italics. 2005-05-17 00:51:10 +00:00
Bruce Momjian e90df66269 Update italics on web site. 2005-05-17 00:24:22 +00:00
Bruce Momjian 343af94255 Update italics on web site. 2005-05-16 23:35:42 +00:00
Bruce Momjian c31a05e819 Update Chinese FAQ to validate properly. 2005-05-16 22:27:54 +00:00
Bruce Momjian e336635c5b Update Chinese FAQ to xhtml. 2005-05-16 02:50:20 +00:00
Bruce Momjian c9a382b2ed Rename Rendezvous to Bonjour to match OS/X renaming. 2005-05-15 00:26:19 +00:00
Bruce Momjian 1ea069b1f6 Re-order items, add mention of how to propose working on a TODO item. 2005-05-14 16:26:17 +00:00
Tom Lane 5e6bbc21f4 Add missing quote, per Dave Page. 2005-05-13 16:48:14 +00:00
Tom Lane f81a77d5ef Update createuser examples to match the current program behavior,
and add an example showing assignment of a password.  Per suggestion
from Jari Aalto (via Martin Pitt).
2005-05-13 16:31:43 +00:00
Tom Lane 3a3804da80 Fix broken markup. 2005-05-13 15:21:59 +00:00
Bruce Momjian 9029129bf3 Update chinese encoding specification. 2005-05-13 13:47:18 +00:00
Bruce Momjian 7b3bf60277 Update FAQ URLs.
Robert Treat
2005-05-11 16:13:20 +00:00
Bruce Momjian b1c42137a3 Document where to download free Microsoft and Borland development tools. 2005-05-11 16:02:12 +00:00