summaryrefslogtreecommitdiff
path: root/doc/src/sgml/ref
AgeCommit message (Collapse)Author
2008-08-21Mention that pg_dump does not dump ALTER DATABASE ... SET commands;Bruce Momjian
backpatch to 8.3.X. Also fix markup that had just one bullet.
2008-07-31Require superuser privilege to create base types (but not composites, enums,Tom Lane
or domains). This was already effectively required because you had to own the I/O functions, and the I/O functions pretty much have to be written in C since we don't let PL functions take or return cstring. But given the possible security consequences of a malicious type definition, it seems prudent to enforce superuser requirement directly. Per recent discussion.
2008-07-30Allow I/O conversion casts to be applied to or from any type that is a memberTom Lane
of the STRING type category, thereby opening up the mechanism for user-defined types. This is mainly for the benefit of citext, though; there aren't likely to be a lot of types that are all general-purpose character strings. Per discussion with David Wheeler.
2008-07-30Flip the default typispreferred setting from true to false. This affectsTom Lane
only type categories in which the previous coding made *every* type preferred; so there is no change in effective behavior, because the function resolution rules only do something different when faced with a choice between preferred and non-preferred types in the same category. It just seems safer and less surprising to have CREATE TYPE default to non-preferred status ...
2008-07-30Replace the hard-wired type knowledge in TypeCategory() and IsPreferredType()Tom Lane
with system catalog lookups, as was foreseen to be necessary almost since their creation. Instead put the information into two new pg_type columns, typcategory and typispreferred. Add support for setting these when creating a user-defined base type. The category column is just a "char" (i.e. a poor man's enum), allowing a crude form of user extensibility of the category list: just use an otherwise-unused character. This seems sufficient for foreseen uses, but we could upgrade to having an actual category catalog someday, if there proves to be a huge demand for custom type categories. In this patch I have attempted to hew exactly to the behavior of the previous hardwired logic, except for introducing new type categories for arrays, composites, and enums. In particular the default preferred state for user-defined types remains TRUE. That seems worth revisiting, but it should be done as a separate patch from introducing the infrastructure. Likewise, any adjustment of the standard set of categories should be done separately.
2008-07-20Add a pg_dump option --lock-wait-timeout to allow failing the dump if unableTom Lane
to acquire shared table locks within a specified amount of time. David Gould
2008-07-18Implement SQL-spec RETURNS TABLE syntax for functions.Tom Lane
(Unlike the original submission, this patch treats TABLE output parameters as being entirely equivalent to OUT parameters -- tgl) Pavel Stehule
2008-07-16Support "variadic" functions, which can accept a variable number of argumentsTom Lane
so long as all the trailing arguments are of the same (non-array) type. The function receives them as a single array argument (which is why they have to all be the same type). It might be useful to extend this facility to aggregates, but this patch doesn't do that. This patch imposes a noticeable slowdown on function lookup --- a follow-on patch will fix that by adding a redundant column to pg_proc. Pavel Stehule
2008-07-12Fix a couple of stray misuses of "binary compatible".Tom Lane
2008-07-11Multi-column GIN indexes. Teodor SigaevTom Lane
2008-07-11Allow binary-coercible types for cast function arguments and return types.Peter Eisentraut
Document return type of cast functions. Also change documentation to prefer the term "binary coercible" in its present sense instead of the previous term "binary compatible".
2008-07-03Don't print the name of the database in psql \z.Peter Eisentraut
2008-07-03Fix psql's \d and allied commands to work with all server versions back to 7.4.Tom Lane
Guillaume Lelarge, with some additional fixes by me.
2008-06-26Remove use of postmaster.opts.default by pg_ctl.Bruce Momjian
2008-06-15Rearrange ALTER TABLE syntax processing as per my recent proposal: theTom Lane
grammar allows ALTER TABLE/INDEX/SEQUENCE/VIEW interchangeably for all subforms of those commands, and then we sort out what's really legal at execution time. This allows the ALTER SEQUENCE/VIEW reference pages to fully document all the ALTER forms available for sequences and views respectively, and eliminates a longstanding cause of confusion for users. The net effect is that the following forms are allowed that weren't before: ALTER SEQUENCE OWNER TO ALTER VIEW ALTER COLUMN SET/DROP DEFAULT ALTER VIEW OWNER TO ALTER VIEW SET SCHEMA (There's no actual functionality gain here, but formerly you had to say ALTER TABLE instead.) Interestingly, the grammar tables actually get smaller, probably because there are fewer special cases to keep track of. I did not disallow using ALTER TABLE for these operations. Perhaps we should, but there's a backwards-compatibility issue if we do; in fact it would break existing pg_dump scripts. I did however tighten up ALTER SEQUENCE and ALTER VIEW to reject non-sequences and non-views in the new cases as well as a couple of cases where they didn't before. The patch doesn't change pg_dump to use the new syntaxes, either.
2008-06-11Add optional on/off argument to \timing.Heikki Linnakangas
David Fetter.
2008-06-01Marginal improvements to the documentation for PGOPTIONS.Tom Lane
2008-05-28Improve GRANT documentation to point out that UPDATE and DELETE typicallyTom Lane
require SELECT privilege as well, since you normally need to read existing column values within such commands. This behavior is according to spec, but we'd never documented it before. Per gripe from Volkan Yazici.
2008-05-27Clarify description of typmod input function, per Jeff Davis.Tom Lane
2008-05-17Rewrite the warning about non-transaction-safety of TRUNCATE ... RESTARTTom Lane
IDENTITY to be more explicit about the possible hazards. Per gripe from Neil and subsequent discussion. Eventually we may be able to get rid of this warning, but for now it had better be there.
2008-05-17Allow ALTER SEQUENCE START WITH to change the recorded start_value of aTom Lane
sequence. This seems an obvious extension to the recent patch, and it makes the code noticeably cleaner and more orthogonal.
2008-05-16Add a RESTART (without parameter) option to ALTER SEQUENCE, allowing aTom Lane
sequence to be reset to its original starting value. This requires adding the original start value to the set of parameters (columns) of a sequence object, which is a user-visible change with potential compatibility implications; it also forces initdb. Also add hopefully-SQL-compatible RESTART/CONTINUE IDENTITY options to TRUNCATE TABLE. RESTART IDENTITY executes ALTER SEQUENCE RESTART for all sequences "owned by" any of the truncated relations. CONTINUE IDENTITY is a no-op option. Zoltan Boszormenyi
2008-05-16Update psql startup banner to be shorter, suggest "help" for help.Bruce Momjian
Add a few "help" entries. Move \g help entry into "General". Update psql version mismatch warning text. Joshua D. Drake
2008-05-16Add detection of psql pager to trigger on wide output. Also add pagerBruce Momjian
detection for wrapped lines or lines with newlines that need pager to display.
2008-05-14Remove odd duplicate wording in psql pager section.Bruce Momjian
2008-05-12Document that "ROLLBACK TO savepoint" does not un-close cursors.Alvaro Herrera
2008-05-09Change the rules for inherited CHECK constraints to be essentially the sameTom Lane
as those for inherited columns; that is, it's no longer allowed for a child table to not have a check constraint matching one that exists on a parent. This satisfies the principle of least surprise (rows selected from the parent will always appear to meet its check constraints) and eliminates some longstanding bogosity in pg_dump, which formerly had to guess about whether check constraints were really inherited or not. The implementation involves adding conislocal and coninhcount columns to pg_constraint (paralleling attislocal and attinhcount in pg_attribute) and refactoring various ALTER TABLE actions to be more like those for columns. Alex Hunsaker, Nikhil Sontakke, Tom Lane
2008-05-08Add psql '\pset format wrapped' mode to wrap output to screen width, orBruce Momjian
file/pipe output too if \pset columns' is set. Bryce Nesbitt
2008-05-08Remove OID/foreign key mention in psql variable interpolation docs.Bruce Momjian
2008-05-05Document extra information provided by psql's \dT+ (not \dt+ as per recent ↵Andrew Dunstan
commit).
2008-05-05Display ACLS using multiple lines for psql's \z. Brendan Jurd.Andrew Dunstan
2008-05-02Update documentation for psql relation-size-in-\dt+ patch.Tom Lane
2008-04-30Add example showing how to remove a password from a role.Alvaro Herrera
Andreas Scherbaum
2008-04-23Prevent shutdown in normal mode if online backup is running, andMagnus Hagander
have pg_ctl warn about this. Cancel running online backups (by renaming the backup_label file, thus rendering the backup useless) when shutting down in fast mode. Laurenz Albe
2008-04-18Cause EXPLAIN's VERBOSE option to print the target list (output column list)Tom Lane
of each plan node, instead of its former behavior of dumping the internal representation of the plan tree. The latter display is still available for those who really want it (see debug_print_plan), but uses for it are certainly few and and far between. Per discussion. This patch also removes the explain_pretty_print GUC, which is obsoleted by the change.
2008-04-14Push index operator lossiness determination down to GIST/GIN opclassTom Lane
"consistent" functions, and remove pg_amop.opreqcheck, as per recent discussion. The main immediate benefit of this is that we no longer need 8.3's ugly hack of requiring @@@ rather than @@ to test weight-using tsquery searches on GIN indexes. In future it should be possible to optimize some other queries better than is done now, by detecting at runtime whether the index match is exact or not. Tom Lane, after an idea of Heikki's, and with some help from Teodor.
2008-04-13Turn the -i/--ignore-version options of pg_dump and pg_dumpall into no-ops:Tom Lane
the server version check is now always enforced. Relax the version check to allow a server that is of pg_dump's own major version but a later minor version; this is the only case that -i was at all safe to use in. pg_restore already enforced only a very weak version check, so this is really just a documentation change for it. Per discussion.
2008-03-30Show database access privileges in psql's \l command. For \l+, also showTom Lane
database size, when available to the current user. Andrew Gilligan
2008-03-28Support statement-level ON TRUNCATE triggers. Simon RiggsTom Lane
2008-03-27Remove ipcclean utility command --- didn't work on all Unixes and onBruce Momjian
Windows. Users should use their operating system tools instead.
2008-03-26Fix bad spelling and worse grammar in recent doc commits. PropagateTom Lane
pg_dump --ignore-version comments into pg_dumpall and pg_restore pages.
2008-03-26Strengthen warnings about using pg_dump's -i option.Bruce Momjian
2008-03-20Support a --no-tablespaces option in pg_dump/pg_dumpall/pg_restore, so thatTom Lane
dumps can be loaded into databases without the same tablespaces that the source had. The option acts by suppressing all "SET default_tablespace" commands, and also CREATE TABLESPACE commands in pg_dumpall's case. Gavin Roy, with documentation and minor fixes by me.
2008-03-19Support ALTER TYPE RENAME. Petr JelinekTom Lane
2008-03-16Add a note to the CREATE INDEX reference page about the impact ofTom Lane
maintenance_work_mem and effective_cache_size on index creation speed.
2008-03-12Fix LISTEN/NOTIFY race condition reported by Laurent Birtz, by postponingTom Lane
pg_listener modifications commanded by LISTEN and UNLISTEN until the end of the current transaction. This allows us to hold the ExclusiveLock on pg_listener until after commit, with no greater risk of deadlock than there was before. Aside from fixing the race condition, this gets rid of a truly ugly kludge that was there before, namely having to ignore HeapTupleBeingUpdated failures during NOTIFY. There is a small potential incompatibility, which is that if a transaction issues LISTEN or UNLISTEN and then looks into pg_listener before committing, it won't see any resulting row insertion or deletion, where before it would have. It seems unlikely that anyone would be depending on that, though. This patch also disallows LISTEN and UNLISTEN inside a prepared transaction. That case had some pretty undesirable properties already, such as possibly allowing pg_listener entries to be made for PIDs no longer present, so disallowing it seems like a better idea than trying to maintain the behavior.
2008-03-10Document and enforce that the usable range of setseed() arguments isTom Lane
-1 to 1, not 0 to 1. The actual behavior for values within this range does not change. Kris Jurka
2008-03-03Document that REVOKE doesn't remove all permissions if PUBLIC has permissions.Bruce Momjian
2008-02-18Added --htmldir option to pg_config, equivalent to the new configure option.Peter Eisentraut
2008-02-15Allow AS to be omitted when specifying an output column name in SELECTTom Lane
(or RETURNING), but only when the output name is not any SQL keyword. This seems as close as we can get to the standard's syntax without a great deal of thrashing. Original patch by Hiroshi Saito, amended by me.