diff --git a/doc/src/sgml/ecpg.sgml b/doc/src/sgml/ecpg.sgml index c88b0c2fb35..716a101838a 100644 --- a/doc/src/sgml/ecpg.sgml +++ b/doc/src/sgml/ecpg.sgml @@ -507,7 +507,7 @@ EXEC SQL COMMIT; - EXEC SQL PREPARE TRANSACTION transaction_id + EXEC SQL PREPARE TRANSACTION transaction_id Prepare the current transaction for two-phase commit. @@ -516,7 +516,7 @@ EXEC SQL COMMIT; - EXEC SQL COMMIT PREPARED transaction_id + EXEC SQL COMMIT PREPARED transaction_id Commit a transaction that is in prepared state. @@ -525,7 +525,7 @@ EXEC SQL COMMIT; - EXEC SQL ROLLBACK PREPARED transaction_id + EXEC SQL ROLLBACK PREPARED transaction_id Roll back a transaction that is in prepared state. @@ -6264,7 +6264,7 @@ c++ test_cpp.o test_mod.o -lecpg -o test_cpp -ALLOCATE DESCRIPTOR name +ALLOCATE DESCRIPTOR name @@ -6288,7 +6288,7 @@ ALLOCATE DESCRIPTOR name - name + name A name of SQL descriptor, case sensitive. This can be an SQL @@ -6356,10 +6356,10 @@ DATABASE connection_target - connection_target + connection_target - connection_target + connection_target specifies the target server of the connection on one of several forms. @@ -6416,7 +6416,7 @@ DATABASE connection_target - connection_object + connection_object An optional identifier for the connection, so that it can be @@ -6427,7 +6427,7 @@ DATABASE connection_target - connection_user + connection_user The user name for the database connection. @@ -6553,7 +6553,7 @@ EXEC SQL END DECLARE SECTION; -DEALLOCATE DESCRIPTOR name +DEALLOCATE DESCRIPTOR name @@ -6571,7 +6571,7 @@ DEALLOCATE DESCRIPTOR name - name + name The name of the descriptor which is going to be deallocated. @@ -6619,8 +6619,8 @@ EXEC SQL DEALLOCATE DESCRIPTOR mydesc; -DECLARE cursor_name [ BINARY ] [ INSENSITIVE ] [ [ NO ] SCROLL ] CURSOR [ { WITH | WITHOUT } HOLD ] FOR prepared_name -DECLARE cursor_name [ BINARY ] [ INSENSITIVE ] [ [ NO ] SCROLL ] CURSOR [ { WITH | WITHOUT } HOLD ] FOR query +DECLARE cursor_name [ BINARY ] [ INSENSITIVE ] [ [ NO ] SCROLL ] CURSOR [ { WITH | WITHOUT } HOLD ] FOR prepared_name +DECLARE cursor_name [ BINARY ] [ INSENSITIVE ] [ [ NO ] SCROLL ] CURSOR [ { WITH | WITHOUT } HOLD ] FOR query @@ -6645,7 +6645,7 @@ DECLARE cursor_name [ BINARY ] [ IN - cursor_name + cursor_name A cursor name, case sensitive. This can be an SQL identifier @@ -6655,7 +6655,7 @@ DECLARE cursor_name [ BINARY ] [ IN - prepared_name + prepared_name The name of a prepared query, either as an SQL identifier or a @@ -6730,9 +6730,9 @@ EXEC SQL DECLARE cur1 CURSOR FOR stmt1; -DESCRIBE [ OUTPUT ] prepared_name USING [ SQL ] DESCRIPTOR descriptor_name -DESCRIBE [ OUTPUT ] prepared_name INTO [ SQL ] DESCRIPTOR descriptor_name -DESCRIBE [ OUTPUT ] prepared_name INTO sqlda_name +DESCRIBE [ OUTPUT ] prepared_name USING [ SQL ] DESCRIPTOR descriptor_name +DESCRIBE [ OUTPUT ] prepared_name INTO [ SQL ] DESCRIPTOR descriptor_name +DESCRIBE [ OUTPUT ] prepared_name INTO sqlda_name @@ -6751,7 +6751,7 @@ DESCRIBE [ OUTPUT ] prepared_name I - prepared_name + prepared_name The name of a prepared statement. This can be an SQL @@ -6761,7 +6761,7 @@ DESCRIBE [ OUTPUT ] prepared_name I - descriptor_name + descriptor_name A descriptor name. It is case sensitive. It can be an SQL @@ -6771,7 +6771,7 @@ DESCRIBE [ OUTPUT ] prepared_name I - sqlda_name + sqlda_name The name of an SQLDA variable. @@ -6819,7 +6819,7 @@ EXEC SQL DEALLOCATE DESCRIPTOR mydesc; -DISCONNECT connection_name +DISCONNECT connection_name DISCONNECT [ CURRENT ] DISCONNECT DEFAULT DISCONNECT ALL @@ -6840,7 +6840,7 @@ DISCONNECT ALL - connection_name + connection_name A database connection name established by @@ -6929,7 +6929,7 @@ main(void) -EXECUTE IMMEDIATE string +EXECUTE IMMEDIATE string @@ -6948,7 +6948,7 @@ EXECUTE IMMEDIATE string - string + string A literal C string or a host variable containing the SQL @@ -6990,8 +6990,8 @@ EXEC SQL EXECUTE IMMEDIATE :command; -GET DESCRIPTOR descriptor_name :cvariable = descriptor_header_item [, ... ] -GET DESCRIPTOR descriptor_name VALUE column_number :cvariable = descriptor_item [, ... ] +GET DESCRIPTOR descriptor_name :cvariable = descriptor_header_item [, ... ] +GET DESCRIPTOR descriptor_name VALUE column_number :cvariable = descriptor_item [, ... ] @@ -7022,7 +7022,7 @@ GET DESCRIPTOR descriptor_name VALU - descriptor_name + descriptor_name A descriptor name. @@ -7031,7 +7031,7 @@ GET DESCRIPTOR descriptor_name VALU - descriptor_header_item + descriptor_header_item A token identifying which header information item to retrieve. @@ -7042,7 +7042,7 @@ GET DESCRIPTOR descriptor_name VALU - column_number + column_number The number of the column about which information is to be @@ -7052,7 +7052,7 @@ GET DESCRIPTOR descriptor_name VALU - descriptor_item + descriptor_item A token identifying which item of information about a column @@ -7063,7 +7063,7 @@ GET DESCRIPTOR descriptor_name VALU - cvariable + cvariable A host variable that will receive the data retrieved from the @@ -7178,9 +7178,9 @@ d_data = testdb -OPEN cursor_name -OPEN cursor_name USING value [, ... ] -OPEN cursor_name USING SQL DESCRIPTOR descriptor_name +OPEN cursor_name +OPEN cursor_name USING value [, ... ] +OPEN cursor_name USING SQL DESCRIPTOR descriptor_name @@ -7202,7 +7202,7 @@ OPEN cursor_name USING SQL DESCRIPT - cursor_name + cursor_name The name of the cursor to be opened. This can be an SQL @@ -7212,7 +7212,7 @@ OPEN cursor_name USING SQL DESCRIPT - value + value A value to be bound to a placeholder in the cursor. This can @@ -7223,7 +7223,7 @@ OPEN cursor_name USING SQL DESCRIPT - descriptor_name + descriptor_name The name of a descriptor containing values to be bound to the @@ -7272,7 +7272,7 @@ EXEC SQL OPEN :curname1; -PREPARE name FROM string +PREPARE name FROM string @@ -7293,7 +7293,7 @@ PREPARE name FROM - prepared_name + prepared_name An identifier for the prepared query. @@ -7302,7 +7302,7 @@ PREPARE name FROM - string + string A literal C string or a host variable containing a preparable @@ -7385,7 +7385,7 @@ SET AUTOCOMMIT { = | TO } { ON | OFF } -SET CONNECTION [ TO | = ] connection_name +SET CONNECTION [ TO | = ] connection_name @@ -7404,7 +7404,7 @@ SET CONNECTION [ TO | = ] connection_name - connection_name + connection_name A database connection name established by @@ -7459,8 +7459,8 @@ EXEC SQL SET CONNECTION = con1; -SET DESCRIPTOR descriptor_name descriptor_header_item = value [, ... ] -SET DESCRIPTOR descriptor_name VALUE number descriptor_item = value [, ...] +SET DESCRIPTOR descriptor_name descriptor_header_item = value [, ... ] +SET DESCRIPTOR descriptor_name VALUE number descriptor_item = value [, ...] @@ -7486,7 +7486,7 @@ SET DESCRIPTOR descriptor_name VALU - descriptor_name + descriptor_name A descriptor name. @@ -7495,7 +7495,7 @@ SET DESCRIPTOR descriptor_name VALU - descriptor_header_item + descriptor_header_item A token identifying which header information item to set. @@ -7506,7 +7506,7 @@ SET DESCRIPTOR descriptor_name VALU - number + number The number of the descriptor item to set. The count starts at @@ -7516,7 +7516,7 @@ SET DESCRIPTOR descriptor_name VALU - descriptor_item + descriptor_item A token identifying which item of information to set in the @@ -7527,7 +7527,7 @@ SET DESCRIPTOR descriptor_name VALU - value + value A value to store into the descriptor item. This can be an SQL @@ -7575,7 +7575,7 @@ EXEC SQL SET DESCRIPTOR indesc VALUE 2 INDICATOR = :val2null, DATA = :val2; -TYPE type_name IS ctype +TYPE type_name IS ctype @@ -7599,7 +7599,7 @@ TYPE type_name IS - type_name + type_name The name for the new type. It must be a valid C type name. @@ -7608,7 +7608,7 @@ TYPE type_name IS - ctype + ctype A C type specification. @@ -7732,7 +7732,7 @@ VAR varname IS ctype - varname + varname A C variable name. @@ -7741,7 +7741,7 @@ VAR varname IS ctype - ctype + ctype A C type specification. @@ -7779,7 +7779,7 @@ EXEC SQL VAR a IS int; -WHENEVER { NOT FOUND | SQLERROR | SQLWARNING } action +WHENEVER { NOT FOUND | SQLERROR | SQLWARNING } action diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml index 1839bddceb5..b52407822dd 100644 --- a/doc/src/sgml/func.sgml +++ b/doc/src/sgml/func.sgml @@ -9491,7 +9491,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple plainto_tsquery - plainto_tsquery( config regconfig , query text) + plainto_tsquery( config regconfig , query text) tsquery produce tsquery ignoring punctuation @@ -9503,7 +9503,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple phraseto_tsquery - phraseto_tsquery( config regconfig , query text) + phraseto_tsquery( config regconfig , query text) tsquery produce tsquery that searches for a phrase, @@ -9516,7 +9516,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple querytree - querytree(query tsquery) + querytree(query tsquery) text get indexable part of a tsquery @@ -9528,10 +9528,10 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple setweight - setweight(vector tsvector, weight "char") + setweight(vector tsvector, weight "char") tsvector - assign weight to each element of vector + assign weight to each element of vector setweight('fat:2,4 cat:3 rat:5B'::tsvector, 'A') 'cat':3A 'fat':2A,4A 'rat':5A @@ -9541,10 +9541,10 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple setweight setweight for specific lexeme(s) - setweight(vector tsvector, weight "char", lexemes text[]) + setweight(vector tsvector, weight "char", lexemes text[]) tsvector - assign weight to elements of vector that are listed in lexemes + assign weight to elements of vector that are listed in lexemes setweight('fat:2,4 cat:3 rat:5B'::tsvector, 'A', '{cat,rat}') 'cat':3A 'fat':2,4 'rat':5A @@ -9565,7 +9565,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple to_tsquery - to_tsquery( config regconfig , query text) + to_tsquery( config regconfig , query text) tsquery normalize words and convert to tsquery @@ -9577,7 +9577,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple to_tsvector - to_tsvector( config regconfig , document text) + to_tsvector( config regconfig , document text) tsvector reduce document text to tsvector @@ -9586,7 +9586,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple - to_tsvector( config regconfig , document json(b)) + to_tsvector( config regconfig , document json(b)) tsvector @@ -9601,20 +9601,20 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple ts_delete - ts_delete(vector tsvector, lexeme text) + ts_delete(vector tsvector, lexeme text) tsvector - remove given lexeme from vector + remove given lexeme from vector ts_delete('fat:2,4 cat:3 rat:5A'::tsvector, 'fat') 'cat':3 'rat':5A - ts_delete(vector tsvector, lexemes text[]) + ts_delete(vector tsvector, lexemes text[]) tsvector - remove any occurrence of lexemes in lexemes from vector + remove any occurrence of lexemes in lexemes from vector ts_delete('fat:2,4 cat:3 rat:5A'::tsvector, ARRAY['fat','rat']) 'cat':3 @@ -9623,10 +9623,10 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple ts_filter - ts_filter(vector tsvector, weights "char"[]) + ts_filter(vector tsvector, weights "char"[]) tsvector - select only elements with given weights from vector + select only elements with given weights from vector ts_filter('fat:2,4 cat:3b rat:5A'::tsvector, '{a,b}') 'cat':3B 'rat':5A @@ -9635,7 +9635,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple ts_headline - ts_headline( config regconfig, document text, query tsquery , options text ) + ts_headline( config regconfig, document text, query tsquery , options text ) text display a query match @@ -9644,7 +9644,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple - ts_headline( config regconfig, document json(b), query tsquery , options text ) + ts_headline( config regconfig, document json(b), query tsquery , options text ) text display a query match @@ -9656,7 +9656,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple ts_rank - ts_rank( weights float4[], vector tsvector, query tsquery , normalization integer ) + ts_rank( weights float4[], vector tsvector, query tsquery , normalization integer ) float4 rank document for query @@ -9668,7 +9668,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple ts_rank_cd - ts_rank_cd( weights float4[], vector tsvector, query tsquery , normalization integer ) + ts_rank_cd( weights float4[], vector tsvector, query tsquery , normalization integer ) float4 rank document for query using cover density @@ -9680,7 +9680,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple ts_rewrite - ts_rewrite(query tsquery, target tsquery, substitute tsquery) + ts_rewrite(query tsquery, target tsquery, substitute tsquery) tsquery replace target with substitute @@ -9689,7 +9689,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple 'b' & ( 'foo' | 'bar' ) - ts_rewrite(query tsquery, select text) + ts_rewrite(query tsquery, select text) tsquery replace using targets and substitutes from a SELECT command SELECT ts_rewrite('a & b'::tsquery, 'SELECT t,s FROM aliases') @@ -9700,7 +9700,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple tsquery_phrase - tsquery_phrase(query1 tsquery, query2 tsquery) + tsquery_phrase(query1 tsquery, query2 tsquery) tsquery make query that searches for query1 followed @@ -9711,7 +9711,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple - tsquery_phrase(query1 tsquery, query2 tsquery, distance integer) + tsquery_phrase(query1 tsquery, query2 tsquery, distance integer) tsquery make query that searches for query1 followed by @@ -9761,7 +9761,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple unnest for tsvector - unnest(tsvector, OUT lexeme text, OUT positions smallint[], OUT weights text) + unnest(tsvector, OUT lexeme text, OUT positions smallint[], OUT weights text) setof record expand a tsvector to a set of rows @@ -9807,7 +9807,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple ts_debug - ts_debug( config regconfig, document text, OUT alias text, OUT description text, OUT token text, OUT dictionaries regdictionary[], OUT dictionary regdictionary, OUT lexemes text[]) + ts_debug( config regconfig, document text, OUT alias text, OUT description text, OUT token text, OUT dictionaries regdictionary[], OUT dictionary regdictionary, OUT lexemes text[]) setof record test a configuration @@ -9819,7 +9819,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple ts_lexize - ts_lexize(dict regdictionary, token text) + ts_lexize(dict regdictionary, token text) text[] test a dictionary @@ -9831,7 +9831,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple ts_parse - ts_parse(parser_name text, document text, OUT tokid integer, OUT token text) + ts_parse(parser_name text, document text, OUT tokid integer, OUT token text) setof record test a parser @@ -9839,7 +9839,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple (1,foo) ... - ts_parse(parser_oid oid, document text, OUT tokid integer, OUT token text) + ts_parse(parser_oid oid, document text, OUT tokid integer, OUT token text) setof record test a parser ts_parse(3722, 'foo - bar') @@ -9850,7 +9850,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple ts_token_type - ts_token_type(parser_name text, OUT tokid integer, OUT alias text, OUT description text) + ts_token_type(parser_name text, OUT tokid integer, OUT alias text, OUT description text) setof record get token types defined by parser @@ -9858,7 +9858,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple (1,asciiword,"Word, all ASCII") ... - ts_token_type(parser_oid oid, OUT tokid integer, OUT alias text, OUT description text) + ts_token_type(parser_oid oid, OUT tokid integer, OUT alias text, OUT description text) setof record get token types defined by parser ts_token_type(3722) @@ -9869,7 +9869,7 @@ CREATE TYPE rainbow AS ENUM ('red', 'orange', 'yellow', 'green', 'blue', 'purple ts_stat - ts_stat(sqlquery text, weights text, OUT word text, OUT ndoc integer, OUT nentry integer) + ts_stat(sqlquery text, weights text, OUT word text, OUT ndoc integer, OUT nentry integer) setof record get statistics of a tsvector column diff --git a/doc/src/sgml/queries.sgml b/doc/src/sgml/queries.sgml index 0588da2912c..11a4bf4e418 100644 --- a/doc/src/sgml/queries.sgml +++ b/doc/src/sgml/queries.sgml @@ -1854,7 +1854,7 @@ SELECT select_list that can be used in a query without having to actually create and populate a table on-disk. The syntax is -VALUES ( expression [, ...] ) [, ...] +VALUES ( expression [, ...] ) [, ...] Each parenthesized list of expressions generates a row in the table. The lists must all have the same number of elements (i.e., the number diff --git a/doc/src/sgml/ref/alter_database.sgml b/doc/src/sgml/ref/alter_database.sgml index 9ab86127afa..59639d37291 100644 --- a/doc/src/sgml/ref/alter_database.sgml +++ b/doc/src/sgml/ref/alter_database.sgml @@ -21,24 +21,24 @@ PostgreSQL documentation -ALTER DATABASE name [ [ WITH ] option [ ... ] ] +ALTER DATABASE name [ [ WITH ] option [ ... ] ] -where option can be: +where option can be: - ALLOW_CONNECTIONS allowconn - CONNECTION LIMIT connlimit - IS_TEMPLATE istemplate + ALLOW_CONNECTIONS allowconn + CONNECTION LIMIT connlimit + IS_TEMPLATE istemplate -ALTER DATABASE name RENAME TO new_name +ALTER DATABASE name RENAME TO new_name -ALTER DATABASE name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } +ALTER DATABASE name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } -ALTER DATABASE name SET TABLESPACE new_tablespace +ALTER DATABASE name SET TABLESPACE new_tablespace -ALTER DATABASE name SET configuration_parameter { TO | = } { value | DEFAULT } -ALTER DATABASE name SET configuration_parameter FROM CURRENT -ALTER DATABASE name RESET configuration_parameter -ALTER DATABASE name RESET ALL +ALTER DATABASE name SET configuration_parameter { TO | = } { value | DEFAULT } +ALTER DATABASE name SET configuration_parameter FROM CURRENT +ALTER DATABASE name RESET configuration_parameter +ALTER DATABASE name RESET ALL @@ -102,7 +102,7 @@ ALTER DATABASE name RESET ALL - name + name The name of the database whose attributes are to be altered. diff --git a/doc/src/sgml/ref/alter_default_privileges.sgml b/doc/src/sgml/ref/alter_default_privileges.sgml index e3363f868a4..09eabda68ac 100644 --- a/doc/src/sgml/ref/alter_default_privileges.sgml +++ b/doc/src/sgml/ref/alter_default_privileges.sgml @@ -31,55 +31,55 @@ ALTER DEFAULT PRIVILEGES GRANT { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER } [, ...] | ALL [ PRIVILEGES ] } ON TABLES - TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ] + TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ] GRANT { { USAGE | SELECT | UPDATE } [, ...] | ALL [ PRIVILEGES ] } ON SEQUENCES - TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ] + TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ] GRANT { EXECUTE | ALL [ PRIVILEGES ] } ON FUNCTIONS - TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ] + TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ] GRANT { USAGE | ALL [ PRIVILEGES ] } ON TYPES - TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ] + TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ] GRANT { USAGE | CREATE | ALL [ PRIVILEGES ] } ON SCHEMAS - TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ] + TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ] REVOKE [ GRANT OPTION FOR ] { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER } [, ...] | ALL [ PRIVILEGES ] } ON TABLES - FROM { [ GROUP ] role_name | PUBLIC } [, ...] + FROM { [ GROUP ] role_name | PUBLIC } [, ...] [ CASCADE | RESTRICT ] REVOKE [ GRANT OPTION FOR ] { { USAGE | SELECT | UPDATE } [, ...] | ALL [ PRIVILEGES ] } ON SEQUENCES - FROM { [ GROUP ] role_name | PUBLIC } [, ...] + FROM { [ GROUP ] role_name | PUBLIC } [, ...] [ CASCADE | RESTRICT ] REVOKE [ GRANT OPTION FOR ] { EXECUTE | ALL [ PRIVILEGES ] } ON FUNCTIONS - FROM { [ GROUP ] role_name | PUBLIC } [, ...] + FROM { [ GROUP ] role_name | PUBLIC } [, ...] [ CASCADE | RESTRICT ] REVOKE [ GRANT OPTION FOR ] { USAGE | ALL [ PRIVILEGES ] } ON TYPES - FROM { [ GROUP ] role_name | PUBLIC } [, ...] + FROM { [ GROUP ] role_name | PUBLIC } [, ...] [ CASCADE | RESTRICT ] REVOKE [ GRANT OPTION FOR ] { USAGE | CREATE | ALL [ PRIVILEGES ] } ON SCHEMAS - FROM { [ GROUP ] role_name | PUBLIC } [, ...] + FROM { [ GROUP ] role_name | PUBLIC } [, ...] [ CASCADE | RESTRICT ] diff --git a/doc/src/sgml/ref/alter_domain.sgml b/doc/src/sgml/ref/alter_domain.sgml index 95a822aef62..827a1c7d20e 100644 --- a/doc/src/sgml/ref/alter_domain.sgml +++ b/doc/src/sgml/ref/alter_domain.sgml @@ -23,24 +23,24 @@ PostgreSQL documentation -ALTER DOMAIN name - { SET DEFAULT expression | DROP DEFAULT } -ALTER DOMAIN name +ALTER DOMAIN name + { SET DEFAULT expression | DROP DEFAULT } +ALTER DOMAIN name { SET | DROP } NOT NULL -ALTER DOMAIN name - ADD domain_constraint [ NOT VALID ] -ALTER DOMAIN name - DROP CONSTRAINT [ IF EXISTS ] constraint_name [ RESTRICT | CASCADE ] -ALTER DOMAIN name - RENAME CONSTRAINT constraint_name TO new_constraint_name -ALTER DOMAIN name - VALIDATE CONSTRAINT constraint_name -ALTER DOMAIN name - OWNER TO { new_owner | CURRENT_USER | SESSION_USER } -ALTER DOMAIN name - RENAME TO new_name -ALTER DOMAIN name - SET SCHEMA new_schema +ALTER DOMAIN name + ADD domain_constraint [ NOT VALID ] +ALTER DOMAIN name + DROP CONSTRAINT [ IF EXISTS ] constraint_name [ RESTRICT | CASCADE ] +ALTER DOMAIN name + RENAME CONSTRAINT constraint_name TO new_constraint_name +ALTER DOMAIN name + VALIDATE CONSTRAINT constraint_name +ALTER DOMAIN name + OWNER TO { new_owner | CURRENT_USER | SESSION_USER } +ALTER DOMAIN name + RENAME TO new_name +ALTER DOMAIN name + SET SCHEMA new_schema @@ -76,7 +76,7 @@ ALTER DOMAIN name - ADD domain_constraint [ NOT VALID ] + ADD domain_constraint [ NOT VALID ] This form adds a new constraint to a domain using the same syntax as @@ -171,7 +171,7 @@ ALTER DOMAIN name - name + name The name (possibly schema-qualified) of an existing domain to @@ -181,7 +181,7 @@ ALTER DOMAIN name - domain_constraint + domain_constraint New domain constraint for the domain. @@ -190,7 +190,7 @@ ALTER DOMAIN name - constraint_name + constraint_name Name of an existing constraint to drop or rename. @@ -199,7 +199,7 @@ ALTER DOMAIN name - NOT VALID + NOT VALID Do not verify existing column data for constraint validity. @@ -230,7 +230,7 @@ ALTER DOMAIN name - new_name + new_name The new name for the domain. @@ -239,7 +239,7 @@ ALTER DOMAIN name - new_constraint_name + new_constraint_name The new name for the constraint. @@ -248,7 +248,7 @@ ALTER DOMAIN name - new_owner + new_owner The user name of the new owner of the domain. @@ -257,7 +257,7 @@ ALTER DOMAIN name - new_schema + new_schema The new schema for the domain. diff --git a/doc/src/sgml/ref/alter_event_trigger.sgml b/doc/src/sgml/ref/alter_event_trigger.sgml index 9d6c64ad529..38b971fb08a 100644 --- a/doc/src/sgml/ref/alter_event_trigger.sgml +++ b/doc/src/sgml/ref/alter_event_trigger.sgml @@ -21,10 +21,10 @@ PostgreSQL documentation -ALTER EVENT TRIGGER name DISABLE -ALTER EVENT TRIGGER name ENABLE [ REPLICA | ALWAYS ] -ALTER EVENT TRIGGER name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } -ALTER EVENT TRIGGER name RENAME TO new_name +ALTER EVENT TRIGGER name DISABLE +ALTER EVENT TRIGGER name ENABLE [ REPLICA | ALWAYS ] +ALTER EVENT TRIGGER name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } +ALTER EVENT TRIGGER name RENAME TO new_name @@ -46,7 +46,7 @@ ALTER EVENT TRIGGER name RENAME TO - name + name The name of an existing trigger to alter. @@ -55,7 +55,7 @@ ALTER EVENT TRIGGER name RENAME TO - new_owner + new_owner The user name of the new owner of the event trigger. @@ -64,7 +64,7 @@ ALTER EVENT TRIGGER name RENAME TO - new_name + new_name The new name of the event trigger. diff --git a/doc/src/sgml/ref/alter_extension.sgml b/doc/src/sgml/ref/alter_extension.sgml index a7c0927d1c9..ae84e98e49a 100644 --- a/doc/src/sgml/ref/alter_extension.sgml +++ b/doc/src/sgml/ref/alter_extension.sgml @@ -23,39 +23,39 @@ PostgreSQL documentation -ALTER EXTENSION name UPDATE [ TO new_version ] -ALTER EXTENSION name SET SCHEMA new_schema -ALTER EXTENSION name ADD member_object -ALTER EXTENSION name DROP member_object +ALTER EXTENSION name UPDATE [ TO new_version ] +ALTER EXTENSION name SET SCHEMA new_schema +ALTER EXTENSION name ADD member_object +ALTER EXTENSION name DROP member_object -where member_object is: +where member_object is: - ACCESS METHOD object_name | - AGGREGATE aggregate_name ( aggregate_signature ) | + ACCESS METHOD object_name | + AGGREGATE aggregate_name ( aggregate_signature ) | CAST (source_type AS target_type) | - COLLATION object_name | - CONVERSION object_name | - DOMAIN object_name | - EVENT TRIGGER object_name | - FOREIGN DATA WRAPPER object_name | - FOREIGN TABLE object_name | - FUNCTION function_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] | - MATERIALIZED VIEW object_name | - OPERATOR operator_name (left_type, right_type) | - OPERATOR CLASS object_name USING index_method | - OPERATOR FAMILY object_name USING index_method | - [ PROCEDURAL ] LANGUAGE object_name | - SCHEMA object_name | - SEQUENCE object_name | - SERVER object_name | - TABLE object_name | - TEXT SEARCH CONFIGURATION object_name | - TEXT SEARCH DICTIONARY object_name | - TEXT SEARCH PARSER object_name | - TEXT SEARCH TEMPLATE object_name | + COLLATION object_name | + CONVERSION object_name | + DOMAIN object_name | + EVENT TRIGGER object_name | + FOREIGN DATA WRAPPER object_name | + FOREIGN TABLE object_name | + FUNCTION function_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] | + MATERIALIZED VIEW object_name | + OPERATOR operator_name (left_type, right_type) | + OPERATOR CLASS object_name USING index_method | + OPERATOR FAMILY object_name USING index_method | + [ PROCEDURAL ] LANGUAGE object_name | + SCHEMA object_name | + SEQUENCE object_name | + SERVER object_name | + TABLE object_name | + TEXT SEARCH CONFIGURATION object_name | + TEXT SEARCH DICTIONARY object_name | + TEXT SEARCH PARSER object_name | + TEXT SEARCH TEMPLATE object_name | TRANSFORM FOR type_name LANGUAGE lang_name | - TYPE object_name | - VIEW object_name + TYPE object_name | + VIEW object_name and aggregate_signature is: @@ -96,7 +96,7 @@ ALTER EXTENSION name DROP - ADD member_object + ADD member_object This form adds an existing object to the extension. This is mainly @@ -108,7 +108,7 @@ ALTER EXTENSION name DROP - DROP member_object + DROP member_object This form removes a member object from the extension. This is mainly @@ -136,7 +136,7 @@ ALTER EXTENSION name DROP - name + name The name of an installed extension. @@ -145,7 +145,7 @@ ALTER EXTENSION name DROP - new_version + new_version The desired new version of the extension. This can be written as @@ -157,7 +157,7 @@ ALTER EXTENSION name DROP - new_schema + new_schema The new schema for the extension. diff --git a/doc/src/sgml/ref/alter_foreign_data_wrapper.sgml b/doc/src/sgml/ref/alter_foreign_data_wrapper.sgml index 3f5fb0f77ea..9c5b84fe64d 100644 --- a/doc/src/sgml/ref/alter_foreign_data_wrapper.sgml +++ b/doc/src/sgml/ref/alter_foreign_data_wrapper.sgml @@ -24,7 +24,7 @@ PostgreSQL documentation ALTER FOREIGN DATA WRAPPER name [ HANDLER handler_function | NO HANDLER ] [ VALIDATOR validator_function | NO VALIDATOR ] - [ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ]) ] + [ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ]) ] ALTER FOREIGN DATA WRAPPER name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } ALTER FOREIGN DATA WRAPPER name RENAME TO new_name @@ -113,7 +113,7 @@ ALTER FOREIGN DATA WRAPPER name REN - OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) + OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) Change options for the foreign-data @@ -127,7 +127,7 @@ ALTER FOREIGN DATA WRAPPER name REN - new_owner + new_owner The user name of the new owner of the foreign-data wrapper. diff --git a/doc/src/sgml/ref/alter_foreign_table.sgml b/doc/src/sgml/ref/alter_foreign_table.sgml index b1692842b26..cb4e7044fbd 100644 --- a/doc/src/sgml/ref/alter_foreign_table.sgml +++ b/doc/src/sgml/ref/alter_foreign_table.sgml @@ -21,41 +21,41 @@ PostgreSQL documentation -ALTER FOREIGN TABLE [ IF EXISTS ] [ ONLY ] name [ * ] - action [, ... ] -ALTER FOREIGN TABLE [ IF EXISTS ] [ ONLY ] name [ * ] - RENAME [ COLUMN ] column_name TO new_column_name -ALTER FOREIGN TABLE [ IF EXISTS ] name - RENAME TO new_name -ALTER FOREIGN TABLE [ IF EXISTS ] name - SET SCHEMA new_schema +ALTER FOREIGN TABLE [ IF EXISTS ] [ ONLY ] name [ * ] + action [, ... ] +ALTER FOREIGN TABLE [ IF EXISTS ] [ ONLY ] name [ * ] + RENAME [ COLUMN ] column_name TO new_column_name +ALTER FOREIGN TABLE [ IF EXISTS ] name + RENAME TO new_name +ALTER FOREIGN TABLE [ IF EXISTS ] name + SET SCHEMA new_schema -where action is one of: +where action is one of: - ADD [ COLUMN ] column_name data_type [ COLLATE collation ] [ column_constraint [ ... ] ] - DROP [ COLUMN ] [ IF EXISTS ] column_name [ RESTRICT | CASCADE ] - ALTER [ COLUMN ] column_name [ SET DATA ] TYPE data_type [ COLLATE collation ] - ALTER [ COLUMN ] column_name SET DEFAULT expression - ALTER [ COLUMN ] column_name DROP DEFAULT - ALTER [ COLUMN ] column_name { SET | DROP } NOT NULL - ALTER [ COLUMN ] column_name SET STATISTICS integer - ALTER [ COLUMN ] column_name SET ( attribute_option = value [, ... ] ) - ALTER [ COLUMN ] column_name RESET ( attribute_option [, ... ] ) - ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } - ALTER [ COLUMN ] column_name OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ]) - ADD table_constraint [ NOT VALID ] - VALIDATE CONSTRAINT constraint_name - DROP CONSTRAINT [ IF EXISTS ] constraint_name [ RESTRICT | CASCADE ] - DISABLE TRIGGER [ trigger_name | ALL | USER ] - ENABLE TRIGGER [ trigger_name | ALL | USER ] - ENABLE REPLICA TRIGGER trigger_name - ENABLE ALWAYS TRIGGER trigger_name + ADD [ COLUMN ] column_name data_type [ COLLATE collation ] [ column_constraint [ ... ] ] + DROP [ COLUMN ] [ IF EXISTS ] column_name [ RESTRICT | CASCADE ] + ALTER [ COLUMN ] column_name [ SET DATA ] TYPE data_type [ COLLATE collation ] + ALTER [ COLUMN ] column_name SET DEFAULT expression + ALTER [ COLUMN ] column_name DROP DEFAULT + ALTER [ COLUMN ] column_name { SET | DROP } NOT NULL + ALTER [ COLUMN ] column_name SET STATISTICS integer + ALTER [ COLUMN ] column_name SET ( attribute_option = value [, ... ] ) + ALTER [ COLUMN ] column_name RESET ( attribute_option [, ... ] ) + ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } + ALTER [ COLUMN ] column_name OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ]) + ADD table_constraint [ NOT VALID ] + VALIDATE CONSTRAINT constraint_name + DROP CONSTRAINT [ IF EXISTS ] constraint_name [ RESTRICT | CASCADE ] + DISABLE TRIGGER [ trigger_name | ALL | USER ] + ENABLE TRIGGER [ trigger_name | ALL | USER ] + ENABLE REPLICA TRIGGER trigger_name + ENABLE ALWAYS TRIGGER trigger_name SET WITH OIDS SET WITHOUT OIDS - INHERIT parent_table - NO INHERIT parent_table - OWNER TO { new_owner | CURRENT_USER | SESSION_USER } - OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ]) + INHERIT parent_table + NO INHERIT parent_table + OWNER TO { new_owner | CURRENT_USER | SESSION_USER } + OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ]) @@ -142,8 +142,8 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - SET ( attribute_option = value [, ... ] ) - RESET ( attribute_option [, ... ] ) + SET ( attribute_option = value [, ... ] ) + RESET ( attribute_option [, ... ] ) This form sets or resets per-attribute options. @@ -169,7 +169,7 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - ADD table_constraint [ NOT VALID ] + ADD table_constraint [ NOT VALID ] This form adds a new constraint to a foreign table, using the same @@ -256,7 +256,7 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - INHERIT parent_table + INHERIT parent_table This form adds the target foreign table as a new child of the specified @@ -268,7 +268,7 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - NO INHERIT parent_table + NO INHERIT parent_table This form removes the target foreign table from the list of children of @@ -288,7 +288,7 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) + OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) Change options for the foreign table or one of its columns. @@ -358,7 +358,7 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - name + name The name (possibly schema-qualified) of an existing foreign table to @@ -372,7 +372,7 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - column_name + column_name Name of a new or existing column. @@ -381,7 +381,7 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - new_column_name + new_column_name New name for an existing column. @@ -390,7 +390,7 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - new_name + new_name New name for the table. @@ -399,7 +399,7 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - data_type + data_type Data type of the new column, or new data type for an existing @@ -409,7 +409,7 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - table_constraint + table_constraint New table constraint for the foreign table. @@ -418,7 +418,7 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - constraint_name + constraint_name Name of an existing constraint to drop. @@ -449,7 +449,7 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - trigger_name + trigger_name Name of a single trigger to disable or enable. @@ -480,7 +480,7 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - parent_table + parent_table A parent table to associate or de-associate with this foreign table. @@ -489,7 +489,7 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - new_owner + new_owner The user name of the new owner of the table. @@ -498,7 +498,7 @@ ALTER FOREIGN TABLE [ IF EXISTS ] name - new_schema + new_schema The name of the schema to which the table will be moved. diff --git a/doc/src/sgml/ref/alter_function.sgml b/doc/src/sgml/ref/alter_function.sgml index 168eeb7c526..8d9fec6005a 100644 --- a/doc/src/sgml/ref/alter_function.sgml +++ b/doc/src/sgml/ref/alter_function.sgml @@ -22,7 +22,7 @@ PostgreSQL documentation ALTER FUNCTION name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] - action [ ... ] [ RESTRICT ] + action [ ... ] [ RESTRICT ] ALTER FUNCTION name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] RENAME TO new_name ALTER FUNCTION name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] @@ -32,7 +32,7 @@ ALTER FUNCTION name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] DEPENDS ON EXTENSION extension_name -where action is one of: +where action is one of: CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT IMMUTABLE | STABLE | VOLATILE | [ NOT ] LEAKPROOF diff --git a/doc/src/sgml/ref/alter_group.sgml b/doc/src/sgml/ref/alter_group.sgml index adf6f7e9323..f7136c773a7 100644 --- a/doc/src/sgml/ref/alter_group.sgml +++ b/doc/src/sgml/ref/alter_group.sgml @@ -21,16 +21,16 @@ PostgreSQL documentation -ALTER GROUP role_specification ADD USER user_name [, ... ] -ALTER GROUP role_specification DROP USER user_name [, ... ] +ALTER GROUP role_specification ADD USER user_name [, ... ] +ALTER GROUP role_specification DROP USER user_name [, ... ] -where role_specification can be: +where role_specification can be: - role_name + role_name | CURRENT_USER | SESSION_USER -ALTER GROUP group_name RENAME TO new_name +ALTER GROUP group_name RENAME TO new_name @@ -66,7 +66,7 @@ ALTER GROUP group_name RENAME TO - group_name + group_name The name of the group (role) to modify. @@ -75,7 +75,7 @@ ALTER GROUP group_name RENAME TO - user_name + user_name Users (roles) that are to be added to or removed from the group. diff --git a/doc/src/sgml/ref/alter_index.sgml b/doc/src/sgml/ref/alter_index.sgml index 7d6553d2db1..4c777f86752 100644 --- a/doc/src/sgml/ref/alter_index.sgml +++ b/doc/src/sgml/ref/alter_index.sgml @@ -21,15 +21,15 @@ PostgreSQL documentation -ALTER INDEX [ IF EXISTS ] name RENAME TO new_name -ALTER INDEX [ IF EXISTS ] name SET TABLESPACE tablespace_name -ALTER INDEX name DEPENDS ON EXTENSION extension_name -ALTER INDEX [ IF EXISTS ] name SET ( storage_parameter = value [, ... ] ) -ALTER INDEX [ IF EXISTS ] name RESET ( storage_parameter [, ... ] ) -ALTER INDEX [ IF EXISTS ] name ALTER [ COLUMN ] column_number - SET STATISTICS integer -ALTER INDEX ALL IN TABLESPACE name [ OWNED BY role_name [, ... ] ] - SET TABLESPACE new_tablespace [ NOWAIT ] +ALTER INDEX [ IF EXISTS ] name RENAME TO new_name +ALTER INDEX [ IF EXISTS ] name SET TABLESPACE tablespace_name +ALTER INDEX name DEPENDS ON EXTENSION extension_name +ALTER INDEX [ IF EXISTS ] name SET ( storage_parameter = value [, ... ] ) +ALTER INDEX [ IF EXISTS ] name RESET ( storage_parameter [, ... ] ) +ALTER INDEX [ IF EXISTS ] name ALTER [ COLUMN ] column_number + SET STATISTICS integer +ALTER INDEX ALL IN TABLESPACE name [ OWNED BY role_name [, ... ] ] + SET TABLESPACE new_tablespace [ NOWAIT ] @@ -86,7 +86,7 @@ ALTER INDEX ALL IN TABLESPACE name - SET ( storage_parameter = value [, ... ] ) + SET ( storage_parameter = value [, ... ] ) This form changes one or more index-method-specific storage parameters @@ -102,7 +102,7 @@ ALTER INDEX ALL IN TABLESPACE name - RESET ( storage_parameter [, ... ] ) + RESET ( storage_parameter [, ... ] ) This form resets one or more index-method-specific storage parameters to @@ -113,7 +113,7 @@ ALTER INDEX ALL IN TABLESPACE name - ALTER [ COLUMN ] column_number SET STATISTICS integer + ALTER [ COLUMN ] column_number SET STATISTICS integer This form sets the per-column statistics-gathering target for @@ -152,7 +152,7 @@ ALTER INDEX ALL IN TABLESPACE name - column_number + column_number The ordinal number refers to the ordinal (left-to-right) position @@ -162,7 +162,7 @@ ALTER INDEX ALL IN TABLESPACE name - name + name The name (possibly schema-qualified) of an existing index to @@ -172,7 +172,7 @@ ALTER INDEX ALL IN TABLESPACE name - new_name + new_name The new name for the index. @@ -181,7 +181,7 @@ ALTER INDEX ALL IN TABLESPACE name - tablespace_name + tablespace_name The tablespace to which the index will be moved. @@ -190,7 +190,7 @@ ALTER INDEX ALL IN TABLESPACE name - extension_name + extension_name The name of the extension that the index is to depend on. @@ -199,7 +199,7 @@ ALTER INDEX ALL IN TABLESPACE name - storage_parameter + storage_parameter The name of an index-method-specific storage parameter. @@ -208,7 +208,7 @@ ALTER INDEX ALL IN TABLESPACE name - value + value The new value for an index-method-specific storage parameter. diff --git a/doc/src/sgml/ref/alter_large_object.sgml b/doc/src/sgml/ref/alter_large_object.sgml index 5748d52db11..5e680f7720c 100644 --- a/doc/src/sgml/ref/alter_large_object.sgml +++ b/doc/src/sgml/ref/alter_large_object.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -ALTER LARGE OBJECT large_object_oid OWNER TO { new_owner | CURRENT_USER | SESSION_USER } +ALTER LARGE OBJECT large_object_oid OWNER TO { new_owner | CURRENT_USER | SESSION_USER } diff --git a/doc/src/sgml/ref/alter_materialized_view.sgml b/doc/src/sgml/ref/alter_materialized_view.sgml index b88f5ac00fb..a1cced1581c 100644 --- a/doc/src/sgml/ref/alter_materialized_view.sgml +++ b/doc/src/sgml/ref/alter_materialized_view.sgml @@ -21,30 +21,30 @@ PostgreSQL documentation -ALTER MATERIALIZED VIEW [ IF EXISTS ] name - action [, ... ] -ALTER MATERIALIZED VIEW name - DEPENDS ON EXTENSION extension_name -ALTER MATERIALIZED VIEW [ IF EXISTS ] name - RENAME [ COLUMN ] column_name TO new_column_name +ALTER MATERIALIZED VIEW [ IF EXISTS ] name + action [, ... ] +ALTER MATERIALIZED VIEW name + DEPENDS ON EXTENSION extension_name +ALTER MATERIALIZED VIEW [ IF EXISTS ] name + RENAME [ COLUMN ] column_name TO new_column_name ALTER MATERIALIZED VIEW [ IF EXISTS ] name RENAME TO new_name ALTER MATERIALIZED VIEW [ IF EXISTS ] name SET SCHEMA new_schema -ALTER MATERIALIZED VIEW ALL IN TABLESPACE name [ OWNED BY role_name [, ... ] ] - SET TABLESPACE new_tablespace [ NOWAIT ] +ALTER MATERIALIZED VIEW ALL IN TABLESPACE name [ OWNED BY role_name [, ... ] ] + SET TABLESPACE new_tablespace [ NOWAIT ] -where action is one of: +where action is one of: - ALTER [ COLUMN ] column_name SET STATISTICS integer - ALTER [ COLUMN ] column_name SET ( attribute_option = value [, ... ] ) - ALTER [ COLUMN ] column_name RESET ( attribute_option [, ... ] ) - ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } - CLUSTER ON index_name + ALTER [ COLUMN ] column_name SET STATISTICS integer + ALTER [ COLUMN ] column_name SET ( attribute_option = value [, ... ] ) + ALTER [ COLUMN ] column_name RESET ( attribute_option [, ... ] ) + ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } + CLUSTER ON index_name SET WITHOUT CLUSTER - SET ( storage_parameter = value [, ... ] ) - RESET ( storage_parameter [, ... ] ) - OWNER TO { new_owner | CURRENT_USER | SESSION_USER } + SET ( storage_parameter = value [, ... ] ) + RESET ( storage_parameter [, ... ] ) + OWNER TO { new_owner | CURRENT_USER | SESSION_USER } @@ -98,7 +98,7 @@ ALTER MATERIALIZED VIEW ALL IN TABLESPACE name - column_name + column_name Name of a new or existing column. @@ -107,7 +107,7 @@ ALTER MATERIALIZED VIEW ALL IN TABLESPACE name - extension_name + extension_name The name of the extension that the materialized view is to depend on. @@ -116,7 +116,7 @@ ALTER MATERIALIZED VIEW ALL IN TABLESPACE name - new_column_name + new_column_name New name for an existing column. @@ -125,7 +125,7 @@ ALTER MATERIALIZED VIEW ALL IN TABLESPACE name - new_owner + new_owner The user name of the new owner of the materialized view. diff --git a/doc/src/sgml/ref/alter_policy.sgml b/doc/src/sgml/ref/alter_policy.sgml index df347d180ea..3eb91556023 100644 --- a/doc/src/sgml/ref/alter_policy.sgml +++ b/doc/src/sgml/ref/alter_policy.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -ALTER POLICY name ON table_name RENAME TO new_name +ALTER POLICY name ON table_name RENAME TO new_name ALTER POLICY name ON table_name [ TO { role_name | PUBLIC | CURRENT_USER | SESSION_USER } [, ...] ] diff --git a/doc/src/sgml/ref/alter_publication.sgml b/doc/src/sgml/ref/alter_publication.sgml index f064ec5f320..7392e6f3de2 100644 --- a/doc/src/sgml/ref/alter_publication.sgml +++ b/doc/src/sgml/ref/alter_publication.sgml @@ -21,12 +21,12 @@ PostgreSQL documentation -ALTER PUBLICATION name ADD TABLE [ ONLY ] table_name [ * ] [, ...] -ALTER PUBLICATION name SET TABLE [ ONLY ] table_name [ * ] [, ...] -ALTER PUBLICATION name DROP TABLE [ ONLY ] table_name [ * ] [, ...] -ALTER PUBLICATION name SET ( publication_parameter [= value] [, ... ] ) -ALTER PUBLICATION name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } -ALTER PUBLICATION name RENAME TO new_name +ALTER PUBLICATION name ADD TABLE [ ONLY ] table_name [ * ] [, ...] +ALTER PUBLICATION name SET TABLE [ ONLY ] table_name [ * ] [, ...] +ALTER PUBLICATION name DROP TABLE [ ONLY ] table_name [ * ] [, ...] +ALTER PUBLICATION name SET ( publication_parameter [= value] [, ... ] ) +ALTER PUBLICATION name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } +ALTER PUBLICATION name RENAME TO new_name diff --git a/doc/src/sgml/ref/alter_role.sgml b/doc/src/sgml/ref/alter_role.sgml index ccdd5c107ca..607b25962f0 100644 --- a/doc/src/sgml/ref/alter_role.sgml +++ b/doc/src/sgml/ref/alter_role.sgml @@ -21,9 +21,9 @@ PostgreSQL documentation -ALTER ROLE role_specification [ WITH ] option [ ... ] +ALTER ROLE role_specification [ WITH ] option [ ... ] -where option can be: +where option can be: SUPERUSER | NOSUPERUSER | CREATEDB | NOCREATEDB @@ -32,20 +32,20 @@ ALTER ROLE role_specification [ WIT | LOGIN | NOLOGIN | REPLICATION | NOREPLICATION | BYPASSRLS | NOBYPASSRLS - | CONNECTION LIMIT connlimit - | [ ENCRYPTED ] PASSWORD 'password' - | VALID UNTIL 'timestamp' + | CONNECTION LIMIT connlimit + | [ ENCRYPTED ] PASSWORD 'password' + | VALID UNTIL 'timestamp' -ALTER ROLE name RENAME TO new_name +ALTER ROLE name RENAME TO new_name -ALTER ROLE { role_specification | ALL } [ IN DATABASE database_name ] SET configuration_parameter { TO | = } { value | DEFAULT } -ALTER ROLE { role_specification | ALL } [ IN DATABASE database_name ] SET configuration_parameter FROM CURRENT -ALTER ROLE { role_specification | ALL } [ IN DATABASE database_name ] RESET configuration_parameter -ALTER ROLE { role_specification | ALL } [ IN DATABASE database_name ] RESET ALL +ALTER ROLE { role_specification | ALL } [ IN DATABASE database_name ] SET configuration_parameter { TO | = } { value | DEFAULT } +ALTER ROLE { role_specification | ALL } [ IN DATABASE database_name ] SET configuration_parameter FROM CURRENT +ALTER ROLE { role_specification | ALL } [ IN DATABASE database_name ] RESET configuration_parameter +ALTER ROLE { role_specification | ALL } [ IN DATABASE database_name ] RESET ALL -where role_specification can be: +where role_specification can be: - role_name + role_name | CURRENT_USER | SESSION_USER @@ -125,7 +125,7 @@ ALTER ROLE { role_specification | A - name + name The name of the role whose attributes are to be altered. diff --git a/doc/src/sgml/ref/alter_rule.sgml b/doc/src/sgml/ref/alter_rule.sgml index 993a0ceb83f..26791b379bd 100644 --- a/doc/src/sgml/ref/alter_rule.sgml +++ b/doc/src/sgml/ref/alter_rule.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -ALTER RULE name ON table_name RENAME TO new_name +ALTER RULE name ON table_name RENAME TO new_name @@ -44,7 +44,7 @@ ALTER RULE name ON - name + name The name of an existing rule to alter. @@ -53,7 +53,7 @@ ALTER RULE name ON - table_name + table_name The name (optionally schema-qualified) of the table or view that the @@ -63,7 +63,7 @@ ALTER RULE name ON - new_name + new_name The new name for the rule. diff --git a/doc/src/sgml/ref/alter_sequence.sgml b/doc/src/sgml/ref/alter_sequence.sgml index 190c8d64855..c505935fcc2 100644 --- a/doc/src/sgml/ref/alter_sequence.sgml +++ b/doc/src/sgml/ref/alter_sequence.sgml @@ -31,7 +31,7 @@ ALTER SEQUENCE [ IF EXISTS ] name [ RESTART [ [ WITH ] restart ] ] [ CACHE cache ] [ [ NO ] CYCLE ] [ OWNED BY { table_name.column_name | NONE } ] -ALTER SEQUENCE [ IF EXISTS ] name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } +ALTER SEQUENCE [ IF EXISTS ] name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } ALTER SEQUENCE [ IF EXISTS ] name RENAME TO new_name ALTER SEQUENCE [ IF EXISTS ] name SET SCHEMA new_schema @@ -256,7 +256,7 @@ ALTER SEQUENCE [ IF EXISTS ] name S - new_owner + new_owner The user name of the new owner of the sequence. diff --git a/doc/src/sgml/ref/alter_server.sgml b/doc/src/sgml/ref/alter_server.sgml index e6cf511853f..7f5def30a40 100644 --- a/doc/src/sgml/ref/alter_server.sgml +++ b/doc/src/sgml/ref/alter_server.sgml @@ -22,9 +22,9 @@ PostgreSQL documentation ALTER SERVER name [ VERSION 'new_version' ] - [ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) ] -ALTER SERVER name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } -ALTER SERVER name RENAME TO new_name + [ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) ] +ALTER SERVER name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } +ALTER SERVER name RENAME TO new_name @@ -71,7 +71,7 @@ ALTER SERVER name RENAME TO - OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) + OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) Change options for the @@ -85,7 +85,7 @@ ALTER SERVER name RENAME TO - new_owner + new_owner The user name of the new owner of the foreign server. diff --git a/doc/src/sgml/ref/alter_statistics.sgml b/doc/src/sgml/ref/alter_statistics.sgml index 4f256698529..db4f2f0d523 100644 --- a/doc/src/sgml/ref/alter_statistics.sgml +++ b/doc/src/sgml/ref/alter_statistics.sgml @@ -23,7 +23,7 @@ PostgreSQL documentation -ALTER STATISTICS name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } +ALTER STATISTICS name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } ALTER STATISTICS name RENAME TO new_name ALTER STATISTICS name SET SCHEMA new_schema @@ -67,7 +67,7 @@ ALTER STATISTICS name SET SCHEMA - new_owner + new_owner The user name of the new owner of the statistics object. diff --git a/doc/src/sgml/ref/alter_subscription.sgml b/doc/src/sgml/ref/alter_subscription.sgml index b1b7765d76c..44c0b350692 100644 --- a/doc/src/sgml/ref/alter_subscription.sgml +++ b/doc/src/sgml/ref/alter_subscription.sgml @@ -21,14 +21,14 @@ PostgreSQL documentation -ALTER SUBSCRIPTION name CONNECTION 'conninfo' -ALTER SUBSCRIPTION name SET PUBLICATION publication_name [, ...] [ WITH ( set_publication_option [= value] [, ... ] ) ] -ALTER SUBSCRIPTION name REFRESH PUBLICATION [ WITH ( refresh_option [= value] [, ... ] ) ] -ALTER SUBSCRIPTION name ENABLE -ALTER SUBSCRIPTION name DISABLE -ALTER SUBSCRIPTION name SET ( subscription_parameter [= value] [, ... ] ) -ALTER SUBSCRIPTION name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } -ALTER SUBSCRIPTION name RENAME TO new_name +ALTER SUBSCRIPTION name CONNECTION 'conninfo' +ALTER SUBSCRIPTION name SET PUBLICATION publication_name [, ...] [ WITH ( set_publication_option [= value] [, ... ] ) ] +ALTER SUBSCRIPTION name REFRESH PUBLICATION [ WITH ( refresh_option [= value] [, ... ] ) ] +ALTER SUBSCRIPTION name ENABLE +ALTER SUBSCRIPTION name DISABLE +ALTER SUBSCRIPTION name SET ( subscription_parameter [= value] [, ... ] ) +ALTER SUBSCRIPTION name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } +ALTER SUBSCRIPTION name RENAME TO new_name diff --git a/doc/src/sgml/ref/alter_system.sgml b/doc/src/sgml/ref/alter_system.sgml index b234793f3e9..e3a4af4041f 100644 --- a/doc/src/sgml/ref/alter_system.sgml +++ b/doc/src/sgml/ref/alter_system.sgml @@ -21,9 +21,9 @@ PostgreSQL documentation -ALTER SYSTEM SET configuration_parameter { TO | = } { value | 'value' | DEFAULT } +ALTER SYSTEM SET configuration_parameter { TO | = } { value | 'value' | DEFAULT } -ALTER SYSTEM RESET configuration_parameter +ALTER SYSTEM RESET configuration_parameter ALTER SYSTEM RESET ALL diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml index 0fb385ece7a..0559f80549d 100644 --- a/doc/src/sgml/ref/alter_table.sgml +++ b/doc/src/sgml/ref/alter_table.sgml @@ -21,74 +21,74 @@ PostgreSQL documentation -ALTER TABLE [ IF EXISTS ] [ ONLY ] name [ * ] - action [, ... ] -ALTER TABLE [ IF EXISTS ] [ ONLY ] name [ * ] - RENAME [ COLUMN ] column_name TO new_column_name -ALTER TABLE [ IF EXISTS ] [ ONLY ] name [ * ] - RENAME CONSTRAINT constraint_name TO new_constraint_name -ALTER TABLE [ IF EXISTS ] name - RENAME TO new_name -ALTER TABLE [ IF EXISTS ] name - SET SCHEMA new_schema -ALTER TABLE ALL IN TABLESPACE name [ OWNED BY role_name [, ... ] ] - SET TABLESPACE new_tablespace [ NOWAIT ] -ALTER TABLE [ IF EXISTS ] name - ATTACH PARTITION partition_name { FOR VALUES partition_bound_spec | DEFAULT } -ALTER TABLE [ IF EXISTS ] name - DETACH PARTITION partition_name +ALTER TABLE [ IF EXISTS ] [ ONLY ] name [ * ] + action [, ... ] +ALTER TABLE [ IF EXISTS ] [ ONLY ] name [ * ] + RENAME [ COLUMN ] column_name TO new_column_name +ALTER TABLE [ IF EXISTS ] [ ONLY ] name [ * ] + RENAME CONSTRAINT constraint_name TO new_constraint_name +ALTER TABLE [ IF EXISTS ] name + RENAME TO new_name +ALTER TABLE [ IF EXISTS ] name + SET SCHEMA new_schema +ALTER TABLE ALL IN TABLESPACE name [ OWNED BY role_name [, ... ] ] + SET TABLESPACE new_tablespace [ NOWAIT ] +ALTER TABLE [ IF EXISTS ] name + ATTACH PARTITION partition_name { FOR VALUES partition_bound_spec | DEFAULT } +ALTER TABLE [ IF EXISTS ] name + DETACH PARTITION partition_name -where action is one of: +where action is one of: - ADD [ COLUMN ] [ IF NOT EXISTS ] column_name data_type [ COLLATE collation ] [ column_constraint [ ... ] ] - DROP [ COLUMN ] [ IF EXISTS ] column_name [ RESTRICT | CASCADE ] - ALTER [ COLUMN ] column_name [ SET DATA ] TYPE data_type [ COLLATE collation ] [ USING expression ] - ALTER [ COLUMN ] column_name SET DEFAULT expression - ALTER [ COLUMN ] column_name DROP DEFAULT - ALTER [ COLUMN ] column_name { SET | DROP } NOT NULL - ALTER [ COLUMN ] column_name ADD GENERATED { ALWAYS | BY DEFAULT } AS IDENTITY [ ( sequence_options ) ] - ALTER [ COLUMN ] column_name { SET GENERATED { ALWAYS | BY DEFAULT } | SET sequence_option | RESTART [ [ WITH ] restart ] } [...] - ALTER [ COLUMN ] column_name DROP IDENTITY [ IF EXISTS ] - ALTER [ COLUMN ] column_name SET STATISTICS integer - ALTER [ COLUMN ] column_name SET ( attribute_option = value [, ... ] ) - ALTER [ COLUMN ] column_name RESET ( attribute_option [, ... ] ) - ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } - ADD table_constraint [ NOT VALID ] - ADD table_constraint_using_index - ALTER CONSTRAINT constraint_name [ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ] - VALIDATE CONSTRAINT constraint_name - DROP CONSTRAINT [ IF EXISTS ] constraint_name [ RESTRICT | CASCADE ] - DISABLE TRIGGER [ trigger_name | ALL | USER ] - ENABLE TRIGGER [ trigger_name | ALL | USER ] - ENABLE REPLICA TRIGGER trigger_name - ENABLE ALWAYS TRIGGER trigger_name - DISABLE RULE rewrite_rule_name - ENABLE RULE rewrite_rule_name - ENABLE REPLICA RULE rewrite_rule_name - ENABLE ALWAYS RULE rewrite_rule_name + ADD [ COLUMN ] [ IF NOT EXISTS ] column_name data_type [ COLLATE collation ] [ column_constraint [ ... ] ] + DROP [ COLUMN ] [ IF EXISTS ] column_name [ RESTRICT | CASCADE ] + ALTER [ COLUMN ] column_name [ SET DATA ] TYPE data_type [ COLLATE collation ] [ USING expression ] + ALTER [ COLUMN ] column_name SET DEFAULT expression + ALTER [ COLUMN ] column_name DROP DEFAULT + ALTER [ COLUMN ] column_name { SET | DROP } NOT NULL + ALTER [ COLUMN ] column_name ADD GENERATED { ALWAYS | BY DEFAULT } AS IDENTITY [ ( sequence_options ) ] + ALTER [ COLUMN ] column_name { SET GENERATED { ALWAYS | BY DEFAULT } | SET sequence_option | RESTART [ [ WITH ] restart ] } [...] + ALTER [ COLUMN ] column_name DROP IDENTITY [ IF EXISTS ] + ALTER [ COLUMN ] column_name SET STATISTICS integer + ALTER [ COLUMN ] column_name SET ( attribute_option = value [, ... ] ) + ALTER [ COLUMN ] column_name RESET ( attribute_option [, ... ] ) + ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } + ADD table_constraint [ NOT VALID ] + ADD table_constraint_using_index + ALTER CONSTRAINT constraint_name [ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ] + VALIDATE CONSTRAINT constraint_name + DROP CONSTRAINT [ IF EXISTS ] constraint_name [ RESTRICT | CASCADE ] + DISABLE TRIGGER [ trigger_name | ALL | USER ] + ENABLE TRIGGER [ trigger_name | ALL | USER ] + ENABLE REPLICA TRIGGER trigger_name + ENABLE ALWAYS TRIGGER trigger_name + DISABLE RULE rewrite_rule_name + ENABLE RULE rewrite_rule_name + ENABLE REPLICA RULE rewrite_rule_name + ENABLE ALWAYS RULE rewrite_rule_name DISABLE ROW LEVEL SECURITY ENABLE ROW LEVEL SECURITY FORCE ROW LEVEL SECURITY NO FORCE ROW LEVEL SECURITY - CLUSTER ON index_name + CLUSTER ON index_name SET WITHOUT CLUSTER SET WITH OIDS SET WITHOUT OIDS - SET TABLESPACE new_tablespace + SET TABLESPACE new_tablespace SET { LOGGED | UNLOGGED } - SET ( storage_parameter = value [, ... ] ) - RESET ( storage_parameter [, ... ] ) - INHERIT parent_table - NO INHERIT parent_table - OF type_name + SET ( storage_parameter = value [, ... ] ) + RESET ( storage_parameter [, ... ] ) + INHERIT parent_table + NO INHERIT parent_table + OF type_name NOT OF - OWNER TO { new_owner | CURRENT_USER | SESSION_USER } - REPLICA IDENTITY { DEFAULT | USING INDEX index_name | FULL | NOTHING } + OWNER TO { new_owner | CURRENT_USER | SESSION_USER } + REPLICA IDENTITY { DEFAULT | USING INDEX index_name | FULL | NOTHING } -and table_constraint_using_index is: +and table_constraint_using_index is: - [ CONSTRAINT constraint_name ] - { UNIQUE | PRIMARY KEY } USING INDEX index_name + [ CONSTRAINT constraint_name ] + { UNIQUE | PRIMARY KEY } USING INDEX index_name [ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ] @@ -244,8 +244,8 @@ ALTER TABLE [ IF EXISTS ] name - SET ( attribute_option = value [, ... ] ) - RESET ( attribute_option [, ... ] ) + SET ( attribute_option = value [, ... ] ) + RESET ( attribute_option [, ... ] ) This form sets or resets per-attribute options. Currently, the only @@ -310,7 +310,7 @@ ALTER TABLE [ IF EXISTS ] name - ADD table_constraint [ NOT VALID ] + ADD table_constraint [ NOT VALID ] This form adds a new constraint to a table using the same syntax as @@ -332,7 +332,7 @@ ALTER TABLE [ IF EXISTS ] name - ADD table_constraint_using_index + ADD table_constraint_using_index This form adds a new PRIMARY KEY or UNIQUE @@ -599,7 +599,7 @@ ALTER TABLE [ IF EXISTS ] name - SET ( storage_parameter = value [, ... ] ) + SET ( storage_parameter = value [, ... ] ) This form changes one or more storage parameters for the table. See @@ -628,7 +628,7 @@ ALTER TABLE [ IF EXISTS ] name While CREATE TABLE allows OIDS to be specified in the WITH (storage_parameter) syntax, + class="parameter">storage_parameter) syntax, ALTER TABLE does not treat OIDS as a storage parameter. Instead use the SET WITH OIDS and SET WITHOUT OIDS forms to change OID status. @@ -638,7 +638,7 @@ ALTER TABLE [ IF EXISTS ] name - RESET ( storage_parameter [, ... ] ) + RESET ( storage_parameter [, ... ] ) This form resets one or more storage parameters to their @@ -649,7 +649,7 @@ ALTER TABLE [ IF EXISTS ] name - INHERIT parent_table + INHERIT parent_table This form adds the target table as a new child of the specified parent @@ -677,7 +677,7 @@ ALTER TABLE [ IF EXISTS ] name - NO INHERIT parent_table + NO INHERIT parent_table This form removes the target table from the list of children of the @@ -689,7 +689,7 @@ ALTER TABLE [ IF EXISTS ] name - OF type_name + OF type_name This form links the table to a composite type as though CREATE @@ -765,7 +765,7 @@ ALTER TABLE [ IF EXISTS ] name - ATTACH PARTITION partition_name { FOR VALUES partition_bound_spec | DEFAULT } + ATTACH PARTITION partition_name { FOR VALUES partition_bound_spec | DEFAULT } This form attaches an existing table (which might itself be partitioned) @@ -777,7 +777,7 @@ ALTER TABLE [ IF EXISTS ] name A partition using FOR VALUES uses same syntax for - partition_bound_spec as + partition_bound_spec as . The partition bound specification must correspond to the partitioning strategy and partition key of the target table. The table to be attached must have all the same columns @@ -828,7 +828,7 @@ ALTER TABLE [ IF EXISTS ] name - DETACH PARTITION partition_name + DETACH PARTITION partition_name This form detaches specified partition of the target table. The detached @@ -886,7 +886,7 @@ ALTER TABLE [ IF EXISTS ] name - name + name The name (optionally schema-qualified) of an existing table to @@ -900,7 +900,7 @@ ALTER TABLE [ IF EXISTS ] name - column_name + column_name Name of a new or existing column. @@ -909,7 +909,7 @@ ALTER TABLE [ IF EXISTS ] name - new_column_name + new_column_name New name for an existing column. @@ -918,7 +918,7 @@ ALTER TABLE [ IF EXISTS ] name - new_name + new_name New name for the table. @@ -927,7 +927,7 @@ ALTER TABLE [ IF EXISTS ] name - data_type + data_type Data type of the new column, or new data type for an existing @@ -937,7 +937,7 @@ ALTER TABLE [ IF EXISTS ] name - table_constraint + table_constraint New table constraint for the table. @@ -946,7 +946,7 @@ ALTER TABLE [ IF EXISTS ] name - constraint_name + constraint_name Name of a new or existing constraint. @@ -977,7 +977,7 @@ ALTER TABLE [ IF EXISTS ] name - trigger_name + trigger_name Name of a single trigger to disable or enable. @@ -1011,7 +1011,7 @@ ALTER TABLE [ IF EXISTS ] name - index_name + index_name The name of an existing index. @@ -1020,7 +1020,7 @@ ALTER TABLE [ IF EXISTS ] name - storage_parameter + storage_parameter The name of a table storage parameter. @@ -1029,7 +1029,7 @@ ALTER TABLE [ IF EXISTS ] name - value + value The new value for a table storage parameter. @@ -1039,7 +1039,7 @@ ALTER TABLE [ IF EXISTS ] name - parent_table + parent_table A parent table to associate or de-associate with this table. @@ -1048,7 +1048,7 @@ ALTER TABLE [ IF EXISTS ] name - new_owner + new_owner The user name of the new owner of the table. @@ -1057,7 +1057,7 @@ ALTER TABLE [ IF EXISTS ] name - new_tablespace + new_tablespace The name of the tablespace to which the table will be moved. @@ -1066,7 +1066,7 @@ ALTER TABLE [ IF EXISTS ] name - new_schema + new_schema The name of the schema to which the table will be moved. @@ -1075,7 +1075,7 @@ ALTER TABLE [ IF EXISTS ] name - partition_name + partition_name The name of the table to attach as a new partition or to detach from this table. @@ -1084,7 +1084,7 @@ ALTER TABLE [ IF EXISTS ] name - partition_bound_spec + partition_bound_spec The partition bound specification for a new partition. Refer to diff --git a/doc/src/sgml/ref/alter_tablespace.sgml b/doc/src/sgml/ref/alter_tablespace.sgml index 2f411050012..4542bd90a21 100644 --- a/doc/src/sgml/ref/alter_tablespace.sgml +++ b/doc/src/sgml/ref/alter_tablespace.sgml @@ -23,8 +23,8 @@ PostgreSQL documentation ALTER TABLESPACE name RENAME TO new_name ALTER TABLESPACE name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } -ALTER TABLESPACE name SET ( tablespace_option = value [, ... ] ) -ALTER TABLESPACE name RESET ( tablespace_option [, ... ] ) +ALTER TABLESPACE name SET ( tablespace_option = value [, ... ] ) +ALTER TABLESPACE name RESET ( tablespace_option [, ... ] ) diff --git a/doc/src/sgml/ref/alter_trigger.sgml b/doc/src/sgml/ref/alter_trigger.sgml index 47eef6e5e88..3e48d159e27 100644 --- a/doc/src/sgml/ref/alter_trigger.sgml +++ b/doc/src/sgml/ref/alter_trigger.sgml @@ -21,8 +21,8 @@ PostgreSQL documentation -ALTER TRIGGER name ON table_name RENAME TO new_name -ALTER TRIGGER name ON table_name DEPENDS ON EXTENSION extension_name +ALTER TRIGGER name ON table_name RENAME TO new_name +ALTER TRIGGER name ON table_name DEPENDS ON EXTENSION extension_name @@ -48,7 +48,7 @@ ALTER TRIGGER name ON - name + name The name of an existing trigger to alter. @@ -57,7 +57,7 @@ ALTER TRIGGER name ON - table_name + table_name The name of the table on which this trigger acts. @@ -66,7 +66,7 @@ ALTER TRIGGER name ON - new_name + new_name The new name for the trigger. @@ -75,7 +75,7 @@ ALTER TRIGGER name ON - extension_name + extension_name The name of the extension that the trigger is to depend on. diff --git a/doc/src/sgml/ref/alter_type.sgml b/doc/src/sgml/ref/alter_type.sgml index 4027c1b8f7d..6c5201ccb59 100644 --- a/doc/src/sgml/ref/alter_type.sgml +++ b/doc/src/sgml/ref/alter_type.sgml @@ -23,19 +23,19 @@ PostgreSQL documentation -ALTER TYPE name action [, ... ] -ALTER TYPE name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } -ALTER TYPE name RENAME ATTRIBUTE attribute_name TO new_attribute_name [ CASCADE | RESTRICT ] -ALTER TYPE name RENAME TO new_name -ALTER TYPE name SET SCHEMA new_schema -ALTER TYPE name ADD VALUE [ IF NOT EXISTS ] new_enum_value [ { BEFORE | AFTER } neighbor_enum_value ] -ALTER TYPE name RENAME VALUE existing_enum_value TO new_enum_value +ALTER TYPE name action [, ... ] +ALTER TYPE name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } +ALTER TYPE name RENAME ATTRIBUTE attribute_name TO new_attribute_name [ CASCADE | RESTRICT ] +ALTER TYPE name RENAME TO new_name +ALTER TYPE name SET SCHEMA new_schema +ALTER TYPE name ADD VALUE [ IF NOT EXISTS ] new_enum_value [ { BEFORE | AFTER } neighbor_enum_value ] +ALTER TYPE name RENAME VALUE existing_enum_value TO new_enum_value -where action is one of: +where action is one of: - ADD ATTRIBUTE attribute_name data_type [ COLLATE collation ] [ CASCADE | RESTRICT ] - DROP ATTRIBUTE [ IF EXISTS ] attribute_name [ CASCADE | RESTRICT ] - ALTER ATTRIBUTE attribute_name [ SET DATA ] TYPE data_type [ COLLATE collation ] [ CASCADE | RESTRICT ] + ADD ATTRIBUTE attribute_name data_type [ COLLATE collation ] [ CASCADE | RESTRICT ] + DROP ATTRIBUTE [ IF EXISTS ] attribute_name [ CASCADE | RESTRICT ] + ALTER ATTRIBUTE attribute_name [ SET DATA ] TYPE data_type [ COLLATE collation ] [ CASCADE | RESTRICT ] @@ -166,7 +166,7 @@ ALTER TYPE name RENAME VALUE - name + name The name (possibly schema-qualified) of an existing type to @@ -176,7 +176,7 @@ ALTER TYPE name RENAME VALUE - new_name + new_name The new name for the type. @@ -185,7 +185,7 @@ ALTER TYPE name RENAME VALUE - new_owner + new_owner The user name of the new owner of the type. @@ -194,7 +194,7 @@ ALTER TYPE name RENAME VALUE - new_schema + new_schema The new schema for the type. @@ -203,7 +203,7 @@ ALTER TYPE name RENAME VALUE - attribute_name + attribute_name The name of the attribute to add, alter, or drop. @@ -212,7 +212,7 @@ ALTER TYPE name RENAME VALUE - new_attribute_name + new_attribute_name The new name of the attribute to be renamed. @@ -221,7 +221,7 @@ ALTER TYPE name RENAME VALUE - data_type + data_type The data type of the attribute to add, or the new type of the @@ -231,7 +231,7 @@ ALTER TYPE name RENAME VALUE - new_enum_value + new_enum_value The new value to be added to an enum type's list of values, @@ -242,7 +242,7 @@ ALTER TYPE name RENAME VALUE - neighbor_enum_value + neighbor_enum_value The existing enum value that the new value should be added immediately @@ -253,7 +253,7 @@ ALTER TYPE name RENAME VALUE - existing_enum_value + existing_enum_value The existing enum value that should be renamed. diff --git a/doc/src/sgml/ref/alter_user.sgml b/doc/src/sgml/ref/alter_user.sgml index c26d264de5c..1a240ff4301 100644 --- a/doc/src/sgml/ref/alter_user.sgml +++ b/doc/src/sgml/ref/alter_user.sgml @@ -21,9 +21,9 @@ PostgreSQL documentation -ALTER USER role_specification [ WITH ] option [ ... ] +ALTER USER role_specification [ WITH ] option [ ... ] -where option can be: +where option can be: SUPERUSER | NOSUPERUSER | CREATEDB | NOCREATEDB @@ -32,20 +32,20 @@ ALTER USER role_specification [ WIT | LOGIN | NOLOGIN | REPLICATION | NOREPLICATION | BYPASSRLS | NOBYPASSRLS - | CONNECTION LIMIT connlimit - | [ ENCRYPTED ] PASSWORD 'password' - | VALID UNTIL 'timestamp' + | CONNECTION LIMIT connlimit + | [ ENCRYPTED ] PASSWORD 'password' + | VALID UNTIL 'timestamp' -ALTER USER name RENAME TO new_name +ALTER USER name RENAME TO new_name -ALTER USER { role_specification | ALL } [ IN DATABASE database_name ] SET configuration_parameter { TO | = } { value | DEFAULT } -ALTER USER { role_specification | ALL } [ IN DATABASE database_name ] SET configuration_parameter FROM CURRENT -ALTER USER { role_specification | ALL } [ IN DATABASE database_name ] RESET configuration_parameter -ALTER USER { role_specification | ALL } [ IN DATABASE database_name ] RESET ALL +ALTER USER { role_specification | ALL } [ IN DATABASE database_name ] SET configuration_parameter { TO | = } { value | DEFAULT } +ALTER USER { role_specification | ALL } [ IN DATABASE database_name ] SET configuration_parameter FROM CURRENT +ALTER USER { role_specification | ALL } [ IN DATABASE database_name ] RESET configuration_parameter +ALTER USER { role_specification | ALL } [ IN DATABASE database_name ] RESET ALL -where role_specification can be: +where role_specification can be: - role_name + role_name | CURRENT_USER | SESSION_USER diff --git a/doc/src/sgml/ref/alter_user_mapping.sgml b/doc/src/sgml/ref/alter_user_mapping.sgml index 3be54afee55..5cc49210edb 100644 --- a/doc/src/sgml/ref/alter_user_mapping.sgml +++ b/doc/src/sgml/ref/alter_user_mapping.sgml @@ -23,7 +23,7 @@ PostgreSQL documentation ALTER USER MAPPING FOR { user_name | USER | CURRENT_USER | SESSION_USER | PUBLIC } SERVER server_name - OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) + OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) @@ -69,7 +69,7 @@ ALTER USER MAPPING FOR { user_name - OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) + OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) Change options for the user mapping. The new options override diff --git a/doc/src/sgml/ref/alter_view.sgml b/doc/src/sgml/ref/alter_view.sgml index 00f4ecb9b1a..788eda5d58e 100644 --- a/doc/src/sgml/ref/alter_view.sgml +++ b/doc/src/sgml/ref/alter_view.sgml @@ -21,9 +21,9 @@ PostgreSQL documentation -ALTER VIEW [ IF EXISTS ] name ALTER [ COLUMN ] column_name SET DEFAULT expression -ALTER VIEW [ IF EXISTS ] name ALTER [ COLUMN ] column_name DROP DEFAULT -ALTER VIEW [ IF EXISTS ] name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } +ALTER VIEW [ IF EXISTS ] name ALTER [ COLUMN ] column_name SET DEFAULT expression +ALTER VIEW [ IF EXISTS ] name ALTER [ COLUMN ] column_name DROP DEFAULT +ALTER VIEW [ IF EXISTS ] name OWNER TO { new_owner | CURRENT_USER | SESSION_USER } ALTER VIEW [ IF EXISTS ] name RENAME TO new_name ALTER VIEW [ IF EXISTS ] name SET SCHEMA new_schema ALTER VIEW [ IF EXISTS ] name SET ( view_option_name [= view_option_value] [, ... ] ) @@ -90,7 +90,7 @@ ALTER VIEW [ IF EXISTS ] name RESET - new_owner + new_owner The user name of the new owner of the view. diff --git a/doc/src/sgml/ref/analyze.sgml b/doc/src/sgml/ref/analyze.sgml index ba429730226..eae7fe92e09 100644 --- a/doc/src/sgml/ref/analyze.sgml +++ b/doc/src/sgml/ref/analyze.sgml @@ -21,11 +21,11 @@ PostgreSQL documentation -ANALYZE [ VERBOSE ] [ table_and_columns [, ...] ] +ANALYZE [ VERBOSE ] [ table_and_columns [, ...] ] -where table_and_columns is: +where table_and_columns is: - table_name [ ( column_name [, ...] ) ] + table_name [ ( column_name [, ...] ) ] @@ -42,7 +42,7 @@ ANALYZE [ VERBOSE ] [ table_and_columns - Without a table_and_columns + Without a table_and_columns list, ANALYZE processes every table and materialized view in the current database that the current user has permission to analyze. With a list, ANALYZE processes only those table(s). @@ -65,7 +65,7 @@ ANALYZE [ VERBOSE ] [ table_and_columns - table_name + table_name The name (possibly schema-qualified) of a specific table to @@ -79,7 +79,7 @@ ANALYZE [ VERBOSE ] [ table_and_columns - column_name + column_name The name of a specific column to analyze. Defaults to all columns. diff --git a/doc/src/sgml/ref/close.sgml b/doc/src/sgml/ref/close.sgml index aacc667144b..aaa2f89a30f 100644 --- a/doc/src/sgml/ref/close.sgml +++ b/doc/src/sgml/ref/close.sgml @@ -26,7 +26,7 @@ PostgreSQL documentation -CLOSE { name | ALL } +CLOSE { name | ALL } @@ -57,7 +57,7 @@ CLOSE { name | ALL } - name + name The name of an open cursor to close. diff --git a/doc/src/sgml/ref/cluster.sgml b/doc/src/sgml/ref/cluster.sgml index e6a77095ec3..b55734d35c9 100644 --- a/doc/src/sgml/ref/cluster.sgml +++ b/doc/src/sgml/ref/cluster.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -CLUSTER [VERBOSE] table_name [ USING index_name ] +CLUSTER [VERBOSE] table_name [ USING index_name ] CLUSTER [VERBOSE] @@ -82,7 +82,7 @@ CLUSTER [VERBOSE] - table_name + table_name The name (possibly schema-qualified) of a table. @@ -91,7 +91,7 @@ CLUSTER [VERBOSE] - index_name + index_name The name of an index. @@ -210,7 +210,7 @@ CLUSTER; The syntax -CLUSTER index_name ON table_name +CLUSTER index_name ON table_name is also supported for compatibility with pre-8.3 PostgreSQL versions. diff --git a/doc/src/sgml/ref/comment.sgml b/doc/src/sgml/ref/comment.sgml index df328117f1d..059d6f41d81 100644 --- a/doc/src/sgml/ref/comment.sgml +++ b/doc/src/sgml/ref/comment.sgml @@ -23,48 +23,48 @@ PostgreSQL documentation COMMENT ON { - ACCESS METHOD object_name | - AGGREGATE aggregate_name ( aggregate_signature ) | + ACCESS METHOD object_name | + AGGREGATE aggregate_name ( aggregate_signature ) | CAST (source_type AS target_type) | - COLLATION object_name | - COLUMN relation_name.column_name | - CONSTRAINT constraint_name ON table_name | - CONSTRAINT constraint_name ON DOMAIN domain_name | - CONVERSION object_name | - DATABASE object_name | - DOMAIN object_name | - EXTENSION object_name | - EVENT TRIGGER object_name | - FOREIGN DATA WRAPPER object_name | - FOREIGN TABLE object_name | - FUNCTION function_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] | - INDEX object_name | - LARGE OBJECT large_object_oid | - MATERIALIZED VIEW object_name | - OPERATOR operator_name (left_type, right_type) | - OPERATOR CLASS object_name USING index_method | - OPERATOR FAMILY object_name USING index_method | - POLICY policy_name ON table_name | - [ PROCEDURAL ] LANGUAGE object_name | - PUBLICATION object_name | - ROLE object_name | - RULE rule_name ON table_name | - SCHEMA object_name | - SEQUENCE object_name | - SERVER object_name | - STATISTICS object_name | - SUBSCRIPTION object_name | - TABLE object_name | - TABLESPACE object_name | - TEXT SEARCH CONFIGURATION object_name | - TEXT SEARCH DICTIONARY object_name | - TEXT SEARCH PARSER object_name | - TEXT SEARCH TEMPLATE object_name | + COLLATION object_name | + COLUMN relation_name.column_name | + CONSTRAINT constraint_name ON table_name | + CONSTRAINT constraint_name ON DOMAIN domain_name | + CONVERSION object_name | + DATABASE object_name | + DOMAIN object_name | + EXTENSION object_name | + EVENT TRIGGER object_name | + FOREIGN DATA WRAPPER object_name | + FOREIGN TABLE object_name | + FUNCTION function_name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] | + INDEX object_name | + LARGE OBJECT large_object_oid | + MATERIALIZED VIEW object_name | + OPERATOR operator_name (left_type, right_type) | + OPERATOR CLASS object_name USING index_method | + OPERATOR FAMILY object_name USING index_method | + POLICY policy_name ON table_name | + [ PROCEDURAL ] LANGUAGE object_name | + PUBLICATION object_name | + ROLE object_name | + RULE rule_name ON table_name | + SCHEMA object_name | + SEQUENCE object_name | + SERVER object_name | + STATISTICS object_name | + SUBSCRIPTION object_name | + TABLE object_name | + TABLESPACE object_name | + TEXT SEARCH CONFIGURATION object_name | + TEXT SEARCH DICTIONARY object_name | + TEXT SEARCH PARSER object_name | + TEXT SEARCH TEMPLATE object_name | TRANSFORM FOR type_name LANGUAGE lang_name | - TRIGGER trigger_name ON table_name | - TYPE object_name | - VIEW object_name -} IS 'text' + TRIGGER trigger_name ON table_name | + TYPE object_name | + VIEW object_name +} IS 'text' where aggregate_signature is: diff --git a/doc/src/sgml/ref/commit_prepared.sgml b/doc/src/sgml/ref/commit_prepared.sgml index e1988ad318b..716aed3ac22 100644 --- a/doc/src/sgml/ref/commit_prepared.sgml +++ b/doc/src/sgml/ref/commit_prepared.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -COMMIT PREPARED transaction_id +COMMIT PREPARED transaction_id @@ -39,7 +39,7 @@ COMMIT PREPARED transaction_id - transaction_id + transaction_id The transaction identifier of the transaction that is to be diff --git a/doc/src/sgml/ref/create_aggregate.sgml b/doc/src/sgml/ref/create_aggregate.sgml index 6a8acfb4f9c..c96e4faba7b 100644 --- a/doc/src/sgml/ref/create_aggregate.sgml +++ b/doc/src/sgml/ref/create_aggregate.sgml @@ -22,59 +22,59 @@ PostgreSQL documentation CREATE AGGREGATE name ( [ argmode ] [ argname ] arg_data_type [ , ... ] ) ( - SFUNC = sfunc, - STYPE = state_data_type - [ , SSPACE = state_data_size ] - [ , FINALFUNC = ffunc ] + SFUNC = sfunc, + STYPE = state_data_type + [ , SSPACE = state_data_size ] + [ , FINALFUNC = ffunc ] [ , FINALFUNC_EXTRA ] - [ , COMBINEFUNC = combinefunc ] - [ , SERIALFUNC = serialfunc ] - [ , DESERIALFUNC = deserialfunc ] - [ , INITCOND = initial_condition ] - [ , MSFUNC = msfunc ] - [ , MINVFUNC = minvfunc ] - [ , MSTYPE = mstate_data_type ] - [ , MSSPACE = mstate_data_size ] - [ , MFINALFUNC = mffunc ] + [ , COMBINEFUNC = combinefunc ] + [ , SERIALFUNC = serialfunc ] + [ , DESERIALFUNC = deserialfunc ] + [ , INITCOND = initial_condition ] + [ , MSFUNC = msfunc ] + [ , MINVFUNC = minvfunc ] + [ , MSTYPE = mstate_data_type ] + [ , MSSPACE = mstate_data_size ] + [ , MFINALFUNC = mffunc ] [ , MFINALFUNC_EXTRA ] - [ , MINITCOND = minitial_condition ] - [ , SORTOP = sort_operator ] + [ , MINITCOND = minitial_condition ] + [ , SORTOP = sort_operator ] [ , PARALLEL = { SAFE | RESTRICTED | UNSAFE } ] ) CREATE AGGREGATE name ( [ [ argmode ] [ argname ] arg_data_type [ , ... ] ] ORDER BY [ argmode ] [ argname ] arg_data_type [ , ... ] ) ( - SFUNC = sfunc, - STYPE = state_data_type - [ , SSPACE = state_data_size ] - [ , FINALFUNC = ffunc ] + SFUNC = sfunc, + STYPE = state_data_type + [ , SSPACE = state_data_size ] + [ , FINALFUNC = ffunc ] [ , FINALFUNC_EXTRA ] - [ , INITCOND = initial_condition ] + [ , INITCOND = initial_condition ] [ , PARALLEL = { SAFE | RESTRICTED | UNSAFE } ] [ , HYPOTHETICAL ] ) or the old syntax -CREATE AGGREGATE name ( - BASETYPE = base_type, - SFUNC = sfunc, - STYPE = state_data_type - [ , SSPACE = state_data_size ] - [ , FINALFUNC = ffunc ] +CREATE AGGREGATE name ( + BASETYPE = base_type, + SFUNC = sfunc, + STYPE = state_data_type + [ , SSPACE = state_data_size ] + [ , FINALFUNC = ffunc ] [ , FINALFUNC_EXTRA ] - [ , COMBINEFUNC = combinefunc ] - [ , SERIALFUNC = serialfunc ] - [ , DESERIALFUNC = deserialfunc ] - [ , INITCOND = initial_condition ] - [ , MSFUNC = msfunc ] - [ , MINVFUNC = minvfunc ] - [ , MSTYPE = mstate_data_type ] - [ , MSSPACE = mstate_data_size ] - [ , MFINALFUNC = mffunc ] + [ , COMBINEFUNC = combinefunc ] + [ , SERIALFUNC = serialfunc ] + [ , DESERIALFUNC = deserialfunc ] + [ , INITCOND = initial_condition ] + [ , MSFUNC = msfunc ] + [ , MINVFUNC = minvfunc ] + [ , MSTYPE = mstate_data_type ] + [ , MSSPACE = mstate_data_size ] + [ , MFINALFUNC = mffunc ] [ , MFINALFUNC_EXTRA ] - [ , MINITCOND = minitial_condition ] - [ , SORTOP = sort_operator ] + [ , MINITCOND = minitial_condition ] + [ , SORTOP = sort_operator ] ) @@ -112,19 +112,19 @@ CREATE AGGREGATE name ( A simple aggregate function is made from one or two ordinary functions: a state transition function - sfunc, + sfunc, and an optional final calculation function - ffunc. + ffunc. These are used as follows: -sfunc( internal-state, next-data-values ) ---> next-internal-state -ffunc( internal-state ) ---> aggregate-value +sfunc( internal-state, next-data-values ) ---> next-internal-state +ffunc( internal-state ) ---> aggregate-value PostgreSQL creates a temporary variable - of data type stype + of data type stype to hold the current internal state of the aggregate. At each input row, the aggregate argument value(s) are calculated and the state transition function is invoked with the current state value @@ -155,9 +155,9 @@ CREATE AGGREGATE name ( all-nonnull input values. This is handy for implementing aggregates like max. Note that this behavior is only available when - state_data_type + state_data_type is the same as the first - arg_data_type. + arg_data_type. When these types are different, you must supply a nonnull initial condition or use a nonstrict transition function. @@ -224,7 +224,7 @@ CREATE AGGREGATE name ( An aggregate can optionally support partial aggregation, as described in . This requires specifying the COMBINEFUNC parameter. - If the state_data_type + If the state_data_type is internal, it's usually also appropriate to provide the SERIALFUNC and DESERIALFUNC parameters so that parallel aggregation is possible. Note that the aggregate must also be @@ -268,7 +268,7 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - name + name The name (optionally schema-qualified) of the aggregate function @@ -302,7 +302,7 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - arg_data_type + arg_data_type An input data type on which this aggregate function operates. @@ -314,7 +314,7 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - base_type + base_type In the old syntax for CREATE AGGREGATE, the input data type @@ -329,18 +329,18 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - sfunc + sfunc The name of the state transition function to be called for each - input row. For a normal N-argument - aggregate function, the sfunc - must take N+1 arguments, + input row. For a normal N-argument + aggregate function, the sfunc + must take N+1 arguments, the first being of type state_data_type and the rest + class="parameter">state_data_type and the rest matching the declared input data type(s) of the aggregate. The function must return a value of type state_data_type. This function + class="parameter">state_data_type. This function takes the current state value and the current input data value(s), and returns the next state value. @@ -355,7 +355,7 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - state_data_type + state_data_type The data type for the aggregate's state value. @@ -364,7 +364,7 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - state_data_size + state_data_size The approximate average size (in bytes) of the aggregate's state value. @@ -380,19 +380,19 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - ffunc + ffunc The name of the final function called to compute the aggregate's result after all input rows have been traversed. For a normal aggregate, this function must take a single argument of type state_data_type. The return + class="parameter">state_data_type. The return data type of the aggregate is defined as the return type of this - function. If ffunc + function. If ffunc is not specified, then the ending state value is used as the aggregate's result, and the return type is state_data_type. + class="parameter">state_data_type. @@ -413,30 +413,30 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - combinefunc + combinefunc - The combinefunc function + The combinefunc function may optionally be specified to allow the aggregate function to support partial aggregation. If provided, - the combinefunc must - combine two state_data_type + the combinefunc must + combine two state_data_type values, each containing the result of aggregation over some subset of the input values, to produce a - new state_data_type that + new state_data_type that represents the result of aggregating over both sets of inputs. This function can be thought of as - an sfunc, where instead of + an sfunc, where instead of acting upon an individual input row and adding it to the running aggregate state, it adds another aggregate state to the running state. - The combinefunc must be + The combinefunc must be declared as taking two arguments of - the state_data_type and + the state_data_type and returning a value of - the state_data_type. + the state_data_type. Optionally this function may be strict. In this case the function will not be called when either of the input states are null; the other state will be taken as the correct result. @@ -444,11 +444,11 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; For aggregate functions - whose state_data_type + whose state_data_type is internal, - the combinefunc must not + the combinefunc must not be strict. In this case - the combinefunc must + the combinefunc must ensure that null states are handled correctly and that the state being returned is properly stored in the aggregate memory context. @@ -456,28 +456,28 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - serialfunc + serialfunc An aggregate function - whose state_data_type + whose state_data_type is internal can participate in parallel aggregation only if it - has a serialfunc function, + has a serialfunc function, which must serialize the aggregate state into a bytea value for transmission to another process. This function must take a single argument of type internal and return type bytea. A - corresponding deserialfunc + corresponding deserialfunc is also required. - deserialfunc + deserialfunc Deserialize a previously serialized aggregate state back into - state_data_type. This + state_data_type. This function must take two arguments of types bytea and internal, and produce a result of type internal. (Note: the second, internal argument is unused, but is required @@ -487,19 +487,19 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - initial_condition + initial_condition The initial setting for the state value. This must be a string constant in the form accepted for the data type state_data_type. If not + class="parameter">state_data_type. If not specified, the state value starts out null. - msfunc + msfunc The name of the forward state transition function to be called for each @@ -512,7 +512,7 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - minvfunc + minvfunc The name of the inverse state transition function to be used in @@ -526,7 +526,7 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - mstate_data_type + mstate_data_type The data type for the aggregate's state value, when using @@ -536,7 +536,7 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - mstate_data_size + mstate_data_size The approximate average size (in bytes) of the aggregate's state @@ -547,7 +547,7 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - mffunc + mffunc The name of the final function called to compute the aggregate's @@ -564,7 +564,7 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - minitial_condition + minitial_condition The initial setting for the state value, when using moving-aggregate @@ -574,7 +574,7 @@ SELECT col FROM tab ORDER BY col USING sortop LIMIT 1; - sort_operator + sort_operator The associated sort operator for a MIN- or diff --git a/doc/src/sgml/ref/create_database.sgml b/doc/src/sgml/ref/create_database.sgml index 48386a29f92..8e2a73402f4 100644 --- a/doc/src/sgml/ref/create_database.sgml +++ b/doc/src/sgml/ref/create_database.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -CREATE DATABASE name +CREATE DATABASE name [ [ WITH ] [ OWNER [=] user_name ] [ TEMPLATE [=] template ] [ ENCODING [=] encoding ] diff --git a/doc/src/sgml/ref/create_domain.sgml b/doc/src/sgml/ref/create_domain.sgml index 3423bf9a328..85ed57dd088 100644 --- a/doc/src/sgml/ref/create_domain.sgml +++ b/doc/src/sgml/ref/create_domain.sgml @@ -24,12 +24,12 @@ PostgreSQL documentation CREATE DOMAIN name [ AS ] data_type [ COLLATE collation ] [ DEFAULT expression ] - [ constraint [ ... ] ] + [ constraint [ ... ] ] -where constraint is: +where constraint is: -[ CONSTRAINT constraint_name ] -{ NOT NULL | NULL | CHECK (expression) } +[ CONSTRAINT constraint_name ] +{ NOT NULL | NULL | CHECK (expression) } @@ -80,7 +80,7 @@ CREATE DOMAIN name [ AS ] - data_type + data_type The underlying data type of the domain. This can include array @@ -126,7 +126,7 @@ CREATE DOMAIN name [ AS ] - CONSTRAINT constraint_name + CONSTRAINT constraint_name An optional name for a constraint. If not specified, @@ -161,7 +161,7 @@ CREATE DOMAIN name [ AS ] - CHECK (expression) + CHECK (expression) CHECK clauses specify integrity constraints or tests which values of the domain must satisfy. diff --git a/doc/src/sgml/ref/create_event_trigger.sgml b/doc/src/sgml/ref/create_event_trigger.sgml index be18fc36e80..7decfbb983c 100644 --- a/doc/src/sgml/ref/create_event_trigger.sgml +++ b/doc/src/sgml/ref/create_event_trigger.sgml @@ -21,10 +21,10 @@ PostgreSQL documentation -CREATE EVENT TRIGGER name - ON event - [ WHEN filter_variable IN (filter_value [, ... ]) [ AND ... ] ] - EXECUTE PROCEDURE function_name() +CREATE EVENT TRIGGER name + ON event + [ WHEN filter_variable IN (filter_value [, ... ]) [ AND ... ] ] + EXECUTE PROCEDURE function_name() diff --git a/doc/src/sgml/ref/create_foreign_data_wrapper.sgml b/doc/src/sgml/ref/create_foreign_data_wrapper.sgml index a3811a3b636..1161e05d1c6 100644 --- a/doc/src/sgml/ref/create_foreign_data_wrapper.sgml +++ b/doc/src/sgml/ref/create_foreign_data_wrapper.sgml @@ -24,7 +24,7 @@ PostgreSQL documentation CREATE FOREIGN DATA WRAPPER name [ HANDLER handler_function | NO HANDLER ] [ VALIDATOR validator_function | NO VALIDATOR ] - [ OPTIONS ( option 'value' [, ... ] ) ] + [ OPTIONS ( option 'value' [, ... ] ) ] @@ -100,7 +100,7 @@ CREATE FOREIGN DATA WRAPPER name - OPTIONS ( option 'value' [, ... ] ) + OPTIONS ( option 'value' [, ... ] ) This clause specifies options for the new foreign-data wrapper. diff --git a/doc/src/sgml/ref/create_foreign_table.sgml b/doc/src/sgml/ref/create_foreign_table.sgml index 065c982082d..f514b2d59f3 100644 --- a/doc/src/sgml/ref/create_foreign_table.sgml +++ b/doc/src/sgml/ref/create_foreign_table.sgml @@ -18,36 +18,36 @@ -CREATE FOREIGN TABLE [ IF NOT EXISTS ] table_name ( [ - { column_name data_type [ OPTIONS ( option 'value' [, ... ] ) ] [ COLLATE collation ] [ column_constraint [ ... ] ] +CREATE FOREIGN TABLE [ IF NOT EXISTS ] table_name ( [ + { column_name data_type [ OPTIONS ( option 'value' [, ... ] ) ] [ COLLATE collation ] [ column_constraint [ ... ] ] | table_constraint } [, ... ] ] ) [ INHERITS ( parent_table [, ... ] ) ] SERVER server_name -[ OPTIONS ( option 'value' [, ... ] ) ] +[ OPTIONS ( option 'value' [, ... ] ) ] -CREATE FOREIGN TABLE [ IF NOT EXISTS ] table_name - PARTITION OF parent_table [ ( - { column_name [ WITH OPTIONS ] [ column_constraint [ ... ] ] +CREATE FOREIGN TABLE [ IF NOT EXISTS ] table_name + PARTITION OF parent_table [ ( + { column_name [ WITH OPTIONS ] [ column_constraint [ ... ] ] | table_constraint } [, ... ] -) ] partition_bound_spec +) ] partition_bound_spec SERVER server_name -[ OPTIONS ( option 'value' [, ... ] ) ] +[ OPTIONS ( option 'value' [, ... ] ) ] -where column_constraint is: +where column_constraint is: -[ CONSTRAINT constraint_name ] +[ CONSTRAINT constraint_name ] { NOT NULL | NULL | - CHECK ( expression ) [ NO INHERIT ] | + CHECK ( expression ) [ NO INHERIT ] | DEFAULT default_expr } -and table_constraint is: +and table_constraint is: -[ CONSTRAINT constraint_name ] -CHECK ( expression ) [ NO INHERIT ] +[ CONSTRAINT constraint_name ] +CHECK ( expression ) [ NO INHERIT ] @@ -107,7 +107,7 @@ CHECK ( expression ) [ NO INHERIT ] - table_name + table_name The name (optionally schema-qualified) of the table to be created. @@ -116,7 +116,7 @@ CHECK ( expression ) [ NO INHERIT ] - column_name + column_name The name of a column to be created in the new table. @@ -125,7 +125,7 @@ CHECK ( expression ) [ NO INHERIT ] - data_type + data_type The data type of the column. This can include array @@ -161,7 +161,7 @@ CHECK ( expression ) [ NO INHERIT ] - CONSTRAINT constraint_name + CONSTRAINT constraint_name An optional name for a column or table constraint. If the @@ -199,7 +199,7 @@ CHECK ( expression ) [ NO INHERIT ] - CHECK ( expression ) [ NO INHERIT ] + CHECK ( expression ) [ NO INHERIT ] The CHECK clause specifies an expression producing a @@ -247,7 +247,7 @@ CHECK ( expression ) [ NO INHERIT ] - server_name + server_name The name of an existing foreign server to use for the foreign table. @@ -258,7 +258,7 @@ CHECK ( expression ) [ NO INHERIT ] - OPTIONS ( option 'value' [, ...] ) + OPTIONS ( option 'value' [, ...] ) Options to be associated with the new foreign table or one of its diff --git a/doc/src/sgml/ref/create_group.sgml b/doc/src/sgml/ref/create_group.sgml index 158617cb939..7896043a116 100644 --- a/doc/src/sgml/ref/create_group.sgml +++ b/doc/src/sgml/ref/create_group.sgml @@ -21,23 +21,23 @@ PostgreSQL documentation -CREATE GROUP name [ [ WITH ] option [ ... ] ] +CREATE GROUP name [ [ WITH ] option [ ... ] ] -where option can be: +where option can be: SUPERUSER | NOSUPERUSER | CREATEDB | NOCREATEDB | CREATEROLE | NOCREATEROLE | INHERIT | NOINHERIT | LOGIN | NOLOGIN - | [ ENCRYPTED ] PASSWORD 'password' - | VALID UNTIL 'timestamp' - | IN ROLE role_name [, ...] - | IN GROUP role_name [, ...] - | ROLE role_name [, ...] - | ADMIN role_name [, ...] - | USER role_name [, ...] - | SYSID uid + | [ ENCRYPTED ] PASSWORD 'password' + | VALID UNTIL 'timestamp' + | IN ROLE role_name [, ...] + | IN GROUP role_name [, ...] + | ROLE role_name [, ...] + | ADMIN role_name [, ...] + | USER role_name [, ...] + | SYSID uid diff --git a/doc/src/sgml/ref/create_index.sgml b/doc/src/sgml/ref/create_index.sgml index 83ee7d3f252..a462be790f6 100644 --- a/doc/src/sgml/ref/create_index.sgml +++ b/doc/src/sgml/ref/create_index.sgml @@ -23,7 +23,7 @@ PostgreSQL documentation CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] name ] ON table_name [ USING method ] ( { column_name | ( expression ) } [ COLLATE collation ] [ opclass ] [ ASC | DESC ] [ NULLS { FIRST | LAST } ] [, ...] ) - [ WITH ( storage_parameter = value [, ... ] ) ] + [ WITH ( storage_parameter = value [, ... ] ) ] [ TABLESPACE tablespace_name ] [ WHERE predicate ] diff --git a/doc/src/sgml/ref/create_materialized_view.sgml b/doc/src/sgml/ref/create_materialized_view.sgml index a8fb84e7a73..577893fe929 100644 --- a/doc/src/sgml/ref/create_materialized_view.sgml +++ b/doc/src/sgml/ref/create_materialized_view.sgml @@ -23,8 +23,8 @@ PostgreSQL documentation CREATE MATERIALIZED VIEW [ IF NOT EXISTS ] table_name [ (column_name [, ...] ) ] - [ WITH ( storage_parameter [= value] [, ... ] ) ] - [ TABLESPACE tablespace_name ] + [ WITH ( storage_parameter [= value] [, ... ] ) ] + [ TABLESPACE tablespace_name ] AS query [ WITH [ NO ] DATA ] @@ -87,7 +87,7 @@ CREATE MATERIALIZED VIEW [ IF NOT EXISTS ] table_name - WITH ( storage_parameter [= value] [, ... ] ) + WITH ( storage_parameter [= value] [, ... ] ) This clause specifies optional storage parameters for the new @@ -102,10 +102,10 @@ CREATE MATERIALIZED VIEW [ IF NOT EXISTS ] table_name - TABLESPACE tablespace_name + TABLESPACE tablespace_name - The tablespace_name is the name + The tablespace_name is the name of the tablespace in which the new materialized view is to be created. If not specified, is consulted. diff --git a/doc/src/sgml/ref/create_role.sgml b/doc/src/sgml/ref/create_role.sgml index 36772b678a8..41670c4b059 100644 --- a/doc/src/sgml/ref/create_role.sgml +++ b/doc/src/sgml/ref/create_role.sgml @@ -21,9 +21,9 @@ PostgreSQL documentation -CREATE ROLE name [ [ WITH ] option [ ... ] ] +CREATE ROLE name [ [ WITH ] option [ ... ] ] -where option can be: +where option can be: SUPERUSER | NOSUPERUSER | CREATEDB | NOCREATEDB @@ -32,15 +32,15 @@ CREATE ROLE name [ [ WITH ] connlimit - | [ ENCRYPTED ] PASSWORD 'password' - | VALID UNTIL 'timestamp' - | IN ROLE role_name [, ...] - | IN GROUP role_name [, ...] - | ROLE role_name [, ...] - | ADMIN role_name [, ...] - | USER role_name [, ...] - | SYSID uid + | CONNECTION LIMIT connlimit + | [ ENCRYPTED ] PASSWORD 'password' + | VALID UNTIL 'timestamp' + | IN ROLE role_name [, ...] + | IN GROUP role_name [, ...] + | ROLE role_name [, ...] + | ADMIN role_name [, ...] + | USER role_name [, ...] + | SYSID uid @@ -453,7 +453,7 @@ CREATE ROLE admin WITH CREATEDB CREATEROLE; The CREATE ROLE statement is in the SQL standard, but the standard only requires the syntax -CREATE ROLE name [ WITH ADMIN role_name ] +CREATE ROLE name [ WITH ADMIN role_name ] Multiple initial administrators, and all the other options of CREATE ROLE, are diff --git a/doc/src/sgml/ref/create_schema.sgml b/doc/src/sgml/ref/create_schema.sgml index 5d29cd768ab..ce145f96a0b 100644 --- a/doc/src/sgml/ref/create_schema.sgml +++ b/doc/src/sgml/ref/create_schema.sgml @@ -21,14 +21,14 @@ PostgreSQL documentation -CREATE SCHEMA schema_name [ AUTHORIZATION role_specification ] [ schema_element [ ... ] ] -CREATE SCHEMA AUTHORIZATION role_specification [ schema_element [ ... ] ] -CREATE SCHEMA IF NOT EXISTS schema_name [ AUTHORIZATION role_specification ] -CREATE SCHEMA IF NOT EXISTS AUTHORIZATION role_specification +CREATE SCHEMA schema_name [ AUTHORIZATION role_specification ] [ schema_element [ ... ] ] +CREATE SCHEMA AUTHORIZATION role_specification [ schema_element [ ... ] ] +CREATE SCHEMA IF NOT EXISTS schema_name [ AUTHORIZATION role_specification ] +CREATE SCHEMA IF NOT EXISTS AUTHORIZATION role_specification -where role_specification can be: +where role_specification can be: - user_name + user_name | CURRENT_USER | SESSION_USER diff --git a/doc/src/sgml/ref/create_server.sgml b/doc/src/sgml/ref/create_server.sgml index 7318481487f..47b8a6291bb 100644 --- a/doc/src/sgml/ref/create_server.sgml +++ b/doc/src/sgml/ref/create_server.sgml @@ -23,7 +23,7 @@ PostgreSQL documentation CREATE SERVER [IF NOT EXISTS] server_name [ TYPE 'server_type' ] [ VERSION 'server_version' ] FOREIGN DATA WRAPPER fdw_name - [ OPTIONS ( option 'value' [, ... ] ) ] + [ OPTIONS ( option 'value' [, ... ] ) ] @@ -105,7 +105,7 @@ CREATE SERVER [IF NOT EXISTS] server_name - OPTIONS ( option 'value' [, ... ] ) + OPTIONS ( option 'value' [, ... ] ) This clause specifies the options for the server. The options diff --git a/doc/src/sgml/ref/create_statistics.sgml b/doc/src/sgml/ref/create_statistics.sgml index ef4e4852bd2..0d68ca06b72 100644 --- a/doc/src/sgml/ref/create_statistics.sgml +++ b/doc/src/sgml/ref/create_statistics.sgml @@ -21,10 +21,10 @@ PostgreSQL documentation -CREATE STATISTICS [ IF NOT EXISTS ] statistics_name - [ ( statistics_kind [, ... ] ) ] - ON column_name, column_name [, ...] - FROM table_name +CREATE STATISTICS [ IF NOT EXISTS ] statistics_name + [ ( statistics_kind [, ... ] ) ] + ON column_name, column_name [, ...] + FROM table_name @@ -66,7 +66,7 @@ CREATE STATISTICS [ IF NOT EXISTS ] statistics_na - statistics_name + statistics_name The name (optionally schema-qualified) of the statistics object to be @@ -76,7 +76,7 @@ CREATE STATISTICS [ IF NOT EXISTS ] statistics_na - statistics_kind + statistics_kind A statistics kind to be computed in this statistics object. @@ -93,7 +93,7 @@ CREATE STATISTICS [ IF NOT EXISTS ] statistics_na - column_name + column_name The name of a table column to be covered by the computed statistics. @@ -103,7 +103,7 @@ CREATE STATISTICS [ IF NOT EXISTS ] statistics_na - table_name + table_name The name (optionally schema-qualified) of the table containing the diff --git a/doc/src/sgml/ref/create_subscription.sgml b/doc/src/sgml/ref/create_subscription.sgml index de505ea8d37..bae9f839bd2 100644 --- a/doc/src/sgml/ref/create_subscription.sgml +++ b/doc/src/sgml/ref/create_subscription.sgml @@ -21,9 +21,9 @@ PostgreSQL documentation -CREATE SUBSCRIPTION subscription_name - CONNECTION 'conninfo' - PUBLICATION publication_name [, ...] +CREATE SUBSCRIPTION subscription_name + CONNECTION 'conninfo' + PUBLICATION publication_name [, ...] [ WITH ( subscription_parameter [= value] [, ... ] ) ] diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml index 14772888519..d15795857b1 100644 --- a/doc/src/sgml/ref/create_table.sgml +++ b/doc/src/sgml/ref/create_table.sgml @@ -21,81 +21,81 @@ PostgreSQL documentation -CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] table_name ( [ - { column_name data_type [ COLLATE collation ] [ column_constraint [ ... ] ] +CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] table_name ( [ + { column_name data_type [ COLLATE collation ] [ column_constraint [ ... ] ] | table_constraint | LIKE source_table [ like_option ... ] } [, ... ] ] ) [ INHERITS ( parent_table [, ... ] ) ] [ PARTITION BY { RANGE | LIST } ( { column_name | ( expression ) } [ COLLATE collation ] [ opclass ] [, ... ] ) ] -[ WITH ( storage_parameter [= value] [, ... ] ) | WITH OIDS | WITHOUT OIDS ] +[ WITH ( storage_parameter [= value] [, ... ] ) | WITH OIDS | WITHOUT OIDS ] [ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ] -[ TABLESPACE tablespace_name ] +[ TABLESPACE tablespace_name ] -CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] table_name - OF type_name [ ( - { column_name [ WITH OPTIONS ] [ column_constraint [ ... ] ] +CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] table_name + OF type_name [ ( + { column_name [ WITH OPTIONS ] [ column_constraint [ ... ] ] | table_constraint } [, ... ] ) ] [ PARTITION BY { RANGE | LIST } ( { column_name | ( expression ) } [ COLLATE collation ] [ opclass ] [, ... ] ) ] -[ WITH ( storage_parameter [= value] [, ... ] ) | WITH OIDS | WITHOUT OIDS ] +[ WITH ( storage_parameter [= value] [, ... ] ) | WITH OIDS | WITHOUT OIDS ] [ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ] -[ TABLESPACE tablespace_name ] +[ TABLESPACE tablespace_name ] -CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] table_name - PARTITION OF parent_table [ ( - { column_name [ WITH OPTIONS ] [ column_constraint [ ... ] ] +CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] table_name + PARTITION OF parent_table [ ( + { column_name [ WITH OPTIONS ] [ column_constraint [ ... ] ] | table_constraint } [, ... ] -) ] { FOR VALUES partition_bound_spec | DEFAULT } +) ] { FOR VALUES partition_bound_spec | DEFAULT } [ PARTITION BY { RANGE | LIST } ( { column_name | ( expression ) } [ COLLATE collation ] [ opclass ] [, ... ] ) ] -[ WITH ( storage_parameter [= value] [, ... ] ) | WITH OIDS | WITHOUT OIDS ] +[ WITH ( storage_parameter [= value] [, ... ] ) | WITH OIDS | WITHOUT OIDS ] [ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ] -[ TABLESPACE tablespace_name ] +[ TABLESPACE tablespace_name ] -where column_constraint is: +where column_constraint is: -[ CONSTRAINT constraint_name ] +[ CONSTRAINT constraint_name ] { NOT NULL | NULL | - CHECK ( expression ) [ NO INHERIT ] | + CHECK ( expression ) [ NO INHERIT ] | DEFAULT default_expr | GENERATED { ALWAYS | BY DEFAULT } AS IDENTITY [ ( sequence_options ) ] | - UNIQUE index_parameters | - PRIMARY KEY index_parameters | - REFERENCES reftable [ ( refcolumn ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] + UNIQUE index_parameters | + PRIMARY KEY index_parameters | + REFERENCES reftable [ ( refcolumn ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE action ] [ ON UPDATE action ] } [ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ] -and table_constraint is: +and table_constraint is: -[ CONSTRAINT constraint_name ] -{ CHECK ( expression ) [ NO INHERIT ] | - UNIQUE ( column_name [, ... ] ) index_parameters | - PRIMARY KEY ( column_name [, ... ] ) index_parameters | +[ CONSTRAINT constraint_name ] +{ CHECK ( expression ) [ NO INHERIT ] | + UNIQUE ( column_name [, ... ] ) index_parameters | + PRIMARY KEY ( column_name [, ... ] ) index_parameters | EXCLUDE [ USING index_method ] ( exclude_element WITH operator [, ... ] ) index_parameters [ WHERE ( predicate ) ] | - FOREIGN KEY ( column_name [, ... ] ) REFERENCES reftable [ ( refcolumn [, ... ] ) ] + FOREIGN KEY ( column_name [, ... ] ) REFERENCES reftable [ ( refcolumn [, ... ] ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE action ] [ ON UPDATE action ] } [ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ] -and like_option is: +and like_option is: { INCLUDING | EXCLUDING } { DEFAULTS | CONSTRAINTS | IDENTITY | INDEXES | STORAGE | COMMENTS | ALL } -and partition_bound_spec is: +and partition_bound_spec is: -IN ( { numeric_literal | string_literal | NULL } [, ...] ) | -FROM ( { numeric_literal | string_literal | MINVALUE | MAXVALUE } [, ...] ) - TO ( { numeric_literal | string_literal | MINVALUE | MAXVALUE } [, ...] ) +IN ( { numeric_literal | string_literal | NULL } [, ...] ) | +FROM ( { numeric_literal | string_literal | MINVALUE | MAXVALUE } [, ...] ) + TO ( { numeric_literal | string_literal | MINVALUE | MAXVALUE } [, ...] ) -index_parameters in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are: +index_parameters in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are: -[ WITH ( storage_parameter [= value] [, ... ] ) ] -[ USING INDEX TABLESPACE tablespace_name ] +[ WITH ( storage_parameter [= value] [, ... ] ) ] +[ USING INDEX TABLESPACE tablespace_name ] -exclude_element in an EXCLUDE constraint is: +exclude_element in an EXCLUDE constraint is: { column_name | ( expression ) } [ opclass ] [ ASC | DESC ] [ NULLS { FIRST | LAST } ] @@ -220,7 +220,7 @@ FROM ( { numeric_literal | - table_name + table_name The name (optionally schema-qualified) of the table to be created. @@ -229,7 +229,7 @@ FROM ( { numeric_literal | - OF type_name + OF type_name Creates a typed table, which takes its @@ -250,7 +250,7 @@ FROM ( { numeric_literal | - PARTITION OF parent_table { FOR VALUES partition_bound_spec | DEFAULT } + PARTITION OF parent_table { FOR VALUES partition_bound_spec | DEFAULT } Creates the table as a partition of the specified @@ -260,7 +260,7 @@ FROM ( { numeric_literal | - The partition_bound_spec + The partition_bound_spec must correspond to the partitioning method and partition key of the parent table, and must not overlap with any existing partition of that parent. The form with IN is used for list partitioning, @@ -270,7 +270,7 @@ FROM ( { numeric_literal | Each of the values specified in - the partition_bound_spec is + the partition_bound_spec is a literal, NULL, MINVALUE, or MAXVALUE. Each literal value must be either a numeric constant that is coercible to the corresponding partition key @@ -397,7 +397,7 @@ FROM ( { numeric_literal | - column_name + column_name The name of a column to be created in the new table. @@ -406,7 +406,7 @@ FROM ( { numeric_literal | - data_type + data_type The data type of the column. This can include array @@ -602,7 +602,7 @@ FROM ( { numeric_literal | - CONSTRAINT constraint_name + CONSTRAINT constraint_name An optional name for a column or table constraint. If the @@ -640,7 +640,7 @@ FROM ( { numeric_literal | - CHECK ( expression ) [ NO INHERIT ] + CHECK ( expression ) [ NO INHERIT ] The CHECK clause specifies an expression producing a @@ -730,7 +730,7 @@ FROM ( { numeric_literal | UNIQUE (column constraint) - UNIQUE ( column_name [, ... ] ) (table constraint) + UNIQUE ( column_name [, ... ] ) (table constraint) @@ -757,7 +757,7 @@ FROM ( { numeric_literal | PRIMARY KEY (column constraint) - PRIMARY KEY ( column_name [, ... ] ) (table constraint) + PRIMARY KEY ( column_name [, ... ] ) (table constraint) The PRIMARY KEY constraint specifies that a column or @@ -997,7 +997,7 @@ FROM ( { numeric_literal | - WITH ( storage_parameter [= value] [, ... ] ) + WITH ( storage_parameter [= value] [, ... ] ) This clause specifies optional storage parameters for a table or index; @@ -1092,10 +1092,10 @@ FROM ( { numeric_literal | - TABLESPACE tablespace_name + TABLESPACE tablespace_name - The tablespace_name is the name + The tablespace_name is the name of the tablespace in which the new table is to be created. If not specified, is consulted, or @@ -1105,7 +1105,7 @@ FROM ( { numeric_literal | - USING INDEX TABLESPACE tablespace_name + USING INDEX TABLESPACE tablespace_name This clause allows selection of the tablespace in which the index diff --git a/doc/src/sgml/ref/create_table_as.sgml b/doc/src/sgml/ref/create_table_as.sgml index 8e4ada794d4..0fa28a11fa7 100644 --- a/doc/src/sgml/ref/create_table_as.sgml +++ b/doc/src/sgml/ref/create_table_as.sgml @@ -23,9 +23,9 @@ PostgreSQL documentation CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] table_name [ (column_name [, ...] ) ] - [ WITH ( storage_parameter [= value] [, ... ] ) | WITH OIDS | WITHOUT OIDS ] + [ WITH ( storage_parameter [= value] [, ... ] ) | WITH OIDS | WITHOUT OIDS ] [ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ] - [ TABLESPACE tablespace_name ] + [ TABLESPACE tablespace_name ] AS query [ WITH [ NO ] DATA ] @@ -121,7 +121,7 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXI - WITH ( storage_parameter [= value] [, ... ] ) + WITH ( storage_parameter [= value] [, ... ] ) This clause specifies optional storage parameters for the new table; @@ -195,10 +195,10 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXI - TABLESPACE tablespace_name + TABLESPACE tablespace_name - The tablespace_name is the name + The tablespace_name is the name of the tablespace in which the new table is to be created. If not specified, is consulted, or diff --git a/doc/src/sgml/ref/create_tablespace.sgml b/doc/src/sgml/ref/create_tablespace.sgml index cf08408f961..2fed29ffaf3 100644 --- a/doc/src/sgml/ref/create_tablespace.sgml +++ b/doc/src/sgml/ref/create_tablespace.sgml @@ -24,7 +24,7 @@ PostgreSQL documentation CREATE TABLESPACE tablespace_name [ OWNER { new_owner | CURRENT_USER | SESSION_USER } ] LOCATION 'directory' - [ WITH ( tablespace_option = value [, ... ] ) ] + [ WITH ( tablespace_option = value [, ... ] ) ] diff --git a/doc/src/sgml/ref/create_trigger.sgml b/doc/src/sgml/ref/create_trigger.sgml index 2496250bed8..7fc481d9fcc 100644 --- a/doc/src/sgml/ref/create_trigger.sgml +++ b/doc/src/sgml/ref/create_trigger.sgml @@ -26,14 +26,14 @@ PostgreSQL documentation -CREATE [ CONSTRAINT ] TRIGGER name { BEFORE | AFTER | INSTEAD OF } { event [ OR ... ] } - ON table_name +CREATE [ CONSTRAINT ] TRIGGER name { BEFORE | AFTER | INSTEAD OF } { event [ OR ... ] } + ON table_name [ FROM referenced_table_name ] [ NOT DEFERRABLE | [ DEFERRABLE ] [ INITIALLY IMMEDIATE | INITIALLY DEFERRED ] ] - [ REFERENCING { { OLD | NEW } TABLE [ AS ] transition_relation_name } [ ... ] ] + [ REFERENCING { { OLD | NEW } TABLE [ AS ] transition_relation_name } [ ... ] ] [ FOR [ EACH ] { ROW | STATEMENT } ] [ WHEN ( condition ) ] - EXECUTE PROCEDURE function_name ( arguments ) + EXECUTE PROCEDURE function_name ( arguments ) where event can be one of: @@ -283,7 +283,7 @@ UPDATE OF column_name1 [, column_name2 - referenced_table_name + referenced_table_name The (possibly schema-qualified) name of another table referenced by the @@ -333,7 +333,7 @@ UPDATE OF column_name1 [, column_name2 - transition_relation_name + transition_relation_name The (unqualified) name to be used within the trigger for this diff --git a/doc/src/sgml/ref/create_type.sgml b/doc/src/sgml/ref/create_type.sgml index 7146c4a27b7..312bd050bc3 100644 --- a/doc/src/sgml/ref/create_type.sgml +++ b/doc/src/sgml/ref/create_type.sgml @@ -22,7 +22,7 @@ PostgreSQL documentation CREATE TYPE name AS - ( [ attribute_name data_type [ COLLATE collation ] [, ... ] ] ) + ( [ attribute_name data_type [ COLLATE collation ] [, ... ] ] ) CREATE TYPE name AS ENUM ( [ 'label' [, ... ] ] ) diff --git a/doc/src/sgml/ref/create_user.sgml b/doc/src/sgml/ref/create_user.sgml index 8a596eec9f2..480b6405e6b 100644 --- a/doc/src/sgml/ref/create_user.sgml +++ b/doc/src/sgml/ref/create_user.sgml @@ -21,9 +21,9 @@ PostgreSQL documentation -CREATE USER name [ [ WITH ] option [ ... ] ] +CREATE USER name [ [ WITH ] option [ ... ] ] -where option can be: +where option can be: SUPERUSER | NOSUPERUSER | CREATEDB | NOCREATEDB @@ -32,15 +32,15 @@ CREATE USER name [ [ WITH ] connlimit - | [ ENCRYPTED ] PASSWORD 'password' - | VALID UNTIL 'timestamp' - | IN ROLE role_name [, ...] - | IN GROUP role_name [, ...] - | ROLE role_name [, ...] - | ADMIN role_name [, ...] - | USER role_name [, ...] - | SYSID uid + | CONNECTION LIMIT connlimit + | [ ENCRYPTED ] PASSWORD 'password' + | VALID UNTIL 'timestamp' + | IN ROLE role_name [, ...] + | IN GROUP role_name [, ...] + | ROLE role_name [, ...] + | ADMIN role_name [, ...] + | USER role_name [, ...] + | SYSID uid diff --git a/doc/src/sgml/ref/create_user_mapping.sgml b/doc/src/sgml/ref/create_user_mapping.sgml index 1c44679a985..d6f29c94893 100644 --- a/doc/src/sgml/ref/create_user_mapping.sgml +++ b/doc/src/sgml/ref/create_user_mapping.sgml @@ -23,7 +23,7 @@ PostgreSQL documentation CREATE USER MAPPING [IF NOT EXISTS] FOR { user_name | USER | CURRENT_USER | PUBLIC } SERVER server_name - [ OPTIONS ( option 'value' [ , ... ] ) ] + [ OPTIONS ( option 'value' [ , ... ] ) ] @@ -86,7 +86,7 @@ CREATE USER MAPPING [IF NOT EXISTS] FOR { user_na - OPTIONS ( option 'value' [, ... ] ) + OPTIONS ( option 'value' [, ... ] ) This clause specifies the options of the user mapping. The diff --git a/doc/src/sgml/ref/create_view.sgml b/doc/src/sgml/ref/create_view.sgml index 319335051b3..695c7593120 100644 --- a/doc/src/sgml/ref/create_view.sgml +++ b/doc/src/sgml/ref/create_view.sgml @@ -21,9 +21,9 @@ PostgreSQL documentation -CREATE [ OR REPLACE ] [ TEMP | TEMPORARY ] [ RECURSIVE ] VIEW name [ ( column_name [, ...] ) ] - [ WITH ( view_option_name [= view_option_value] [, ... ] ) ] - AS query +CREATE [ OR REPLACE ] [ TEMP | TEMPORARY ] [ RECURSIVE ] VIEW name [ ( column_name [, ...] ) ] + [ WITH ( view_option_name [= view_option_value] [, ... ] ) ] + AS query [ WITH [ CASCADED | LOCAL ] CHECK OPTION ] @@ -118,7 +118,7 @@ CREATE VIEW [ schema . ] view_name AS WITH RECUR - WITH ( view_option_name [= view_option_value] [, ... ] ) + WITH ( view_option_name [= view_option_value] [, ... ] ) This clause specifies optional parameters for a view; the following diff --git a/doc/src/sgml/ref/delete.sgml b/doc/src/sgml/ref/delete.sgml index 20417a13919..8ced7de7be6 100644 --- a/doc/src/sgml/ref/delete.sgml +++ b/doc/src/sgml/ref/delete.sgml @@ -22,9 +22,9 @@ PostgreSQL documentation [ WITH [ RECURSIVE ] with_query [, ...] ] -DELETE FROM [ ONLY ] table_name [ * ] [ [ AS ] alias ] - [ USING using_list ] - [ WHERE condition | WHERE CURRENT OF cursor_name ] +DELETE FROM [ ONLY ] table_name [ * ] [ [ AS ] alias ] + [ USING using_list ] + [ WHERE condition | WHERE CURRENT OF cursor_name ] [ RETURNING * | output_expression [ [ AS ] output_name ] [, ...] ] @@ -117,7 +117,7 @@ DELETE FROM [ ONLY ] table_name [ * - using_list + using_list A list of table expressions, allowing columns from other tables @@ -126,7 +126,7 @@ DELETE FROM [ ONLY ] table_name [ * linkend="sql-from" endterm="sql-from-title"> of a SELECT statement; for example, an alias for the table name can be specified. Do not repeat the target table - in the using_list, + in the using_list, unless you wish to set up a self-join. @@ -144,7 +144,7 @@ DELETE FROM [ ONLY ] table_name [ * - cursor_name + cursor_name The name of the cursor to use in a WHERE CURRENT OF @@ -161,12 +161,12 @@ DELETE FROM [ ONLY ] table_name [ * - output_expression + output_expression An expression to be computed and returned by the DELETE command after each row is deleted. The expression can use any - column names of the table named by table_name + column names of the table named by table_name or table(s) listed in USING. Write * to return all columns. @@ -174,7 +174,7 @@ DELETE FROM [ ONLY ] table_name [ * - output_name + output_name A name to use for a returned column. diff --git a/doc/src/sgml/ref/do.sgml b/doc/src/sgml/ref/do.sgml index ed5e588ee71..d4da32c34dc 100644 --- a/doc/src/sgml/ref/do.sgml +++ b/doc/src/sgml/ref/do.sgml @@ -25,7 +25,7 @@ PostgreSQL documentation -DO [ LANGUAGE lang_name ] code +DO [ LANGUAGE lang_name ] code @@ -54,7 +54,7 @@ DO [ LANGUAGE lang_name ] - code + code The procedural language code to be executed. This must be specified @@ -65,7 +65,7 @@ DO [ LANGUAGE lang_name ] - lang_name + lang_name The name of the procedural language the code is written in. diff --git a/doc/src/sgml/ref/drop_database.sgml b/doc/src/sgml/ref/drop_database.sgml index 740aa319951..44436ad48db 100644 --- a/doc/src/sgml/ref/drop_database.sgml +++ b/doc/src/sgml/ref/drop_database.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP DATABASE [ IF EXISTS ] name +DROP DATABASE [ IF EXISTS ] name @@ -57,7 +57,7 @@ DROP DATABASE [ IF EXISTS ] name - name + name The name of the database to remove. diff --git a/doc/src/sgml/ref/drop_domain.sgml b/doc/src/sgml/ref/drop_domain.sgml index e14795e6a30..ba546165c20 100644 --- a/doc/src/sgml/ref/drop_domain.sgml +++ b/doc/src/sgml/ref/drop_domain.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP DOMAIN [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] +DROP DOMAIN [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] @@ -49,7 +49,7 @@ DROP DOMAIN [ IF EXISTS ] name [, . - name + name The name (optionally schema-qualified) of an existing domain. diff --git a/doc/src/sgml/ref/drop_event_trigger.sgml b/doc/src/sgml/ref/drop_event_trigger.sgml index 6e3ee22d7bb..583048dc0f4 100644 --- a/doc/src/sgml/ref/drop_event_trigger.sgml +++ b/doc/src/sgml/ref/drop_event_trigger.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP EVENT TRIGGER [ IF EXISTS ] name [ CASCADE | RESTRICT ] +DROP EVENT TRIGGER [ IF EXISTS ] name [ CASCADE | RESTRICT ] @@ -51,7 +51,7 @@ DROP EVENT TRIGGER [ IF EXISTS ] name - name + name The name of the event trigger to remove. diff --git a/doc/src/sgml/ref/drop_extension.sgml b/doc/src/sgml/ref/drop_extension.sgml index 7438a08bb36..ba529220135 100644 --- a/doc/src/sgml/ref/drop_extension.sgml +++ b/doc/src/sgml/ref/drop_extension.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP EXTENSION [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] +DROP EXTENSION [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] @@ -54,7 +54,7 @@ DROP EXTENSION [ IF EXISTS ] name [ - name + name The name of an installed extension. diff --git a/doc/src/sgml/ref/drop_foreign_table.sgml b/doc/src/sgml/ref/drop_foreign_table.sgml index 5a2b235d4e9..173eadadd36 100644 --- a/doc/src/sgml/ref/drop_foreign_table.sgml +++ b/doc/src/sgml/ref/drop_foreign_table.sgml @@ -18,7 +18,7 @@ -DROP FOREIGN TABLE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] +DROP FOREIGN TABLE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] @@ -46,7 +46,7 @@ DROP FOREIGN TABLE [ IF EXISTS ] name - name + name The name (optionally schema-qualified) of the foreign table to drop. diff --git a/doc/src/sgml/ref/drop_group.sgml b/doc/src/sgml/ref/drop_group.sgml index e601ff4172c..5987c5f760b 100644 --- a/doc/src/sgml/ref/drop_group.sgml +++ b/doc/src/sgml/ref/drop_group.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP GROUP [ IF EXISTS ] name [, ...] +DROP GROUP [ IF EXISTS ] name [, ...] diff --git a/doc/src/sgml/ref/drop_index.sgml b/doc/src/sgml/ref/drop_index.sgml index 6fe108ded25..4c838fffffb 100644 --- a/doc/src/sgml/ref/drop_index.sgml +++ b/doc/src/sgml/ref/drop_index.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP INDEX [ CONCURRENTLY ] [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] +DROP INDEX [ CONCURRENTLY ] [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] @@ -72,7 +72,7 @@ DROP INDEX [ CONCURRENTLY ] [ IF EXISTS ] name - name + name The name (optionally schema-qualified) of an index to remove. diff --git a/doc/src/sgml/ref/drop_language.sgml b/doc/src/sgml/ref/drop_language.sgml index f014a74d454..081bd5fe3ec 100644 --- a/doc/src/sgml/ref/drop_language.sgml +++ b/doc/src/sgml/ref/drop_language.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP [ PROCEDURAL ] LANGUAGE [ IF EXISTS ] name [ CASCADE | RESTRICT ] +DROP [ PROCEDURAL ] LANGUAGE [ IF EXISTS ] name [ CASCADE | RESTRICT ] @@ -60,7 +60,7 @@ DROP [ PROCEDURAL ] LANGUAGE [ IF EXISTS ] name - name + name The name of an existing procedural language. For backward diff --git a/doc/src/sgml/ref/drop_materialized_view.sgml b/doc/src/sgml/ref/drop_materialized_view.sgml index 36ec33ceb08..a898a1fc0af 100644 --- a/doc/src/sgml/ref/drop_materialized_view.sgml +++ b/doc/src/sgml/ref/drop_materialized_view.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP MATERIALIZED VIEW [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] +DROP MATERIALIZED VIEW [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] @@ -50,7 +50,7 @@ DROP MATERIALIZED VIEW [ IF EXISTS ] name - name + name The name (optionally schema-qualified) of the materialized view to diff --git a/doc/src/sgml/ref/drop_opclass.sgml b/doc/src/sgml/ref/drop_opclass.sgml index 187a9a4d1f7..423a211bcab 100644 --- a/doc/src/sgml/ref/drop_opclass.sgml +++ b/doc/src/sgml/ref/drop_opclass.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP OPERATOR CLASS [ IF EXISTS ] name USING index_method [ CASCADE | RESTRICT ] +DROP OPERATOR CLASS [ IF EXISTS ] name USING index_method [ CASCADE | RESTRICT ] diff --git a/doc/src/sgml/ref/drop_operator.sgml b/doc/src/sgml/ref/drop_operator.sgml index fc82c3e0e3f..5897c99a620 100644 --- a/doc/src/sgml/ref/drop_operator.sgml +++ b/doc/src/sgml/ref/drop_operator.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP OPERATOR [ IF EXISTS ] name ( { left_type | NONE } , { right_type | NONE } ) [, ...] [ CASCADE | RESTRICT ] +DROP OPERATOR [ IF EXISTS ] name ( { left_type | NONE } , { right_type | NONE } ) [, ...] [ CASCADE | RESTRICT ] diff --git a/doc/src/sgml/ref/drop_opfamily.sgml b/doc/src/sgml/ref/drop_opfamily.sgml index 53bce228837..a7b90f306c7 100644 --- a/doc/src/sgml/ref/drop_opfamily.sgml +++ b/doc/src/sgml/ref/drop_opfamily.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP OPERATOR FAMILY [ IF EXISTS ] name USING index_method [ CASCADE | RESTRICT ] +DROP OPERATOR FAMILY [ IF EXISTS ] name USING index_method [ CASCADE | RESTRICT ] diff --git a/doc/src/sgml/ref/drop_owned.sgml b/doc/src/sgml/ref/drop_owned.sgml index 81694b88e53..0426373d2de 100644 --- a/doc/src/sgml/ref/drop_owned.sgml +++ b/doc/src/sgml/ref/drop_owned.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP OWNED BY { name | CURRENT_USER | SESSION_USER } [, ...] [ CASCADE | RESTRICT ] +DROP OWNED BY { name | CURRENT_USER | SESSION_USER } [, ...] [ CASCADE | RESTRICT ] @@ -42,7 +42,7 @@ DROP OWNED BY { name | CURRENT_USER - name + name The name of a role whose objects will be dropped, and whose diff --git a/doc/src/sgml/ref/drop_publication.sgml b/doc/src/sgml/ref/drop_publication.sgml index 8e45a439820..bf43db3dac3 100644 --- a/doc/src/sgml/ref/drop_publication.sgml +++ b/doc/src/sgml/ref/drop_publication.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP PUBLICATION [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] +DROP PUBLICATION [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] diff --git a/doc/src/sgml/ref/drop_role.sgml b/doc/src/sgml/ref/drop_role.sgml index 75b48f94f9a..fcddfeb172c 100644 --- a/doc/src/sgml/ref/drop_role.sgml +++ b/doc/src/sgml/ref/drop_role.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP ROLE [ IF EXISTS ] name [, ...] +DROP ROLE [ IF EXISTS ] name [, ...] @@ -68,7 +68,7 @@ DROP ROLE [ IF EXISTS ] name [, ... - name + name The name of the role to remove. diff --git a/doc/src/sgml/ref/drop_rule.sgml b/doc/src/sgml/ref/drop_rule.sgml index d4905a69c9d..d3fdf55080c 100644 --- a/doc/src/sgml/ref/drop_rule.sgml +++ b/doc/src/sgml/ref/drop_rule.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP RULE [ IF EXISTS ] name ON table_name [ CASCADE | RESTRICT ] +DROP RULE [ IF EXISTS ] name ON table_name [ CASCADE | RESTRICT ] diff --git a/doc/src/sgml/ref/drop_schema.sgml b/doc/src/sgml/ref/drop_schema.sgml index 5b1697fff20..fd1fcd7e037 100644 --- a/doc/src/sgml/ref/drop_schema.sgml +++ b/doc/src/sgml/ref/drop_schema.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP SCHEMA [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] +DROP SCHEMA [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] @@ -54,7 +54,7 @@ DROP SCHEMA [ IF EXISTS ] name [, . - name + name The name of a schema. diff --git a/doc/src/sgml/ref/drop_sequence.sgml b/doc/src/sgml/ref/drop_sequence.sgml index f0e1edc81c5..9d827f0cb17 100644 --- a/doc/src/sgml/ref/drop_sequence.sgml +++ b/doc/src/sgml/ref/drop_sequence.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP SEQUENCE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] +DROP SEQUENCE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] @@ -49,7 +49,7 @@ DROP SEQUENCE [ IF EXISTS ] name [, - name + name The name (optionally schema-qualified) of a sequence. diff --git a/doc/src/sgml/ref/drop_statistics.sgml b/doc/src/sgml/ref/drop_statistics.sgml index 37fc4025891..fd2087db6a7 100644 --- a/doc/src/sgml/ref/drop_statistics.sgml +++ b/doc/src/sgml/ref/drop_statistics.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP STATISTICS [ IF EXISTS ] name [, ...] +DROP STATISTICS [ IF EXISTS ] name [, ...] @@ -51,7 +51,7 @@ DROP STATISTICS [ IF EXISTS ] name - name + name The name (optionally schema-qualified) of the statistics object to drop. diff --git a/doc/src/sgml/ref/drop_table.sgml b/doc/src/sgml/ref/drop_table.sgml index 94d28b06fbc..ae96cf06575 100644 --- a/doc/src/sgml/ref/drop_table.sgml +++ b/doc/src/sgml/ref/drop_table.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP TABLE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] +DROP TABLE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] @@ -62,7 +62,7 @@ DROP TABLE [ IF EXISTS ] name [, .. - name + name The name (optionally schema-qualified) of the table to drop. diff --git a/doc/src/sgml/ref/drop_tablespace.sgml b/doc/src/sgml/ref/drop_tablespace.sgml index d0a05af2e14..ee40cc6b0c3 100644 --- a/doc/src/sgml/ref/drop_tablespace.sgml +++ b/doc/src/sgml/ref/drop_tablespace.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP TABLESPACE [ IF EXISTS ] name +DROP TABLESPACE [ IF EXISTS ] name @@ -60,7 +60,7 @@ DROP TABLESPACE [ IF EXISTS ] name - name + name The name of a tablespace. diff --git a/doc/src/sgml/ref/drop_trigger.sgml b/doc/src/sgml/ref/drop_trigger.sgml index d400b8383f4..d44bf138a67 100644 --- a/doc/src/sgml/ref/drop_trigger.sgml +++ b/doc/src/sgml/ref/drop_trigger.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP TRIGGER [ IF EXISTS ] name ON table_name [ CASCADE | RESTRICT ] +DROP TRIGGER [ IF EXISTS ] name ON table_name [ CASCADE | RESTRICT ] @@ -51,7 +51,7 @@ DROP TRIGGER [ IF EXISTS ] name ON - name + name The name of the trigger to remove. @@ -60,7 +60,7 @@ DROP TRIGGER [ IF EXISTS ] name ON - table_name + table_name The name (optionally schema-qualified) of the table for which diff --git a/doc/src/sgml/ref/drop_tsconfig.sgml b/doc/src/sgml/ref/drop_tsconfig.sgml index 0096e0092d3..e4a1738baeb 100644 --- a/doc/src/sgml/ref/drop_tsconfig.sgml +++ b/doc/src/sgml/ref/drop_tsconfig.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP TEXT SEARCH CONFIGURATION [ IF EXISTS ] name [ CASCADE | RESTRICT ] +DROP TEXT SEARCH CONFIGURATION [ IF EXISTS ] name [ CASCADE | RESTRICT ] diff --git a/doc/src/sgml/ref/drop_tsdictionary.sgml b/doc/src/sgml/ref/drop_tsdictionary.sgml index 803abf8cba9..faa4b3a1e5d 100644 --- a/doc/src/sgml/ref/drop_tsdictionary.sgml +++ b/doc/src/sgml/ref/drop_tsdictionary.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP TEXT SEARCH DICTIONARY [ IF EXISTS ] name [ CASCADE | RESTRICT ] +DROP TEXT SEARCH DICTIONARY [ IF EXISTS ] name [ CASCADE | RESTRICT ] diff --git a/doc/src/sgml/ref/drop_tsparser.sgml b/doc/src/sgml/ref/drop_tsparser.sgml index fa997201610..bc9dae17a5e 100644 --- a/doc/src/sgml/ref/drop_tsparser.sgml +++ b/doc/src/sgml/ref/drop_tsparser.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP TEXT SEARCH PARSER [ IF EXISTS ] name [ CASCADE | RESTRICT ] +DROP TEXT SEARCH PARSER [ IF EXISTS ] name [ CASCADE | RESTRICT ] diff --git a/doc/src/sgml/ref/drop_tstemplate.sgml b/doc/src/sgml/ref/drop_tstemplate.sgml index 9d051eb6197..98f5523e513 100644 --- a/doc/src/sgml/ref/drop_tstemplate.sgml +++ b/doc/src/sgml/ref/drop_tstemplate.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP TEXT SEARCH TEMPLATE [ IF EXISTS ] name [ CASCADE | RESTRICT ] +DROP TEXT SEARCH TEMPLATE [ IF EXISTS ] name [ CASCADE | RESTRICT ] diff --git a/doc/src/sgml/ref/drop_type.sgml b/doc/src/sgml/ref/drop_type.sgml index 2c7b8fe9f6b..4ec1b92f329 100644 --- a/doc/src/sgml/ref/drop_type.sgml +++ b/doc/src/sgml/ref/drop_type.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP TYPE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] +DROP TYPE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] @@ -49,7 +49,7 @@ DROP TYPE [ IF EXISTS ] name [, ... - name + name The name (optionally schema-qualified) of the data type to remove. diff --git a/doc/src/sgml/ref/drop_user.sgml b/doc/src/sgml/ref/drop_user.sgml index 38e5418d078..3cb90522daa 100644 --- a/doc/src/sgml/ref/drop_user.sgml +++ b/doc/src/sgml/ref/drop_user.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP USER [ IF EXISTS ] name [, ...] +DROP USER [ IF EXISTS ] name [, ...] diff --git a/doc/src/sgml/ref/drop_view.sgml b/doc/src/sgml/ref/drop_view.sgml index 40f23561884..002d2c6dd65 100644 --- a/doc/src/sgml/ref/drop_view.sgml +++ b/doc/src/sgml/ref/drop_view.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -DROP VIEW [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] +DROP VIEW [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ] @@ -49,7 +49,7 @@ DROP VIEW [ IF EXISTS ] name [, ... - name + name The name (optionally schema-qualified) of the view to remove. diff --git a/doc/src/sgml/ref/execute.sgml b/doc/src/sgml/ref/execute.sgml index 76069c019ea..6ab5e54fa7e 100644 --- a/doc/src/sgml/ref/execute.sgml +++ b/doc/src/sgml/ref/execute.sgml @@ -26,7 +26,7 @@ PostgreSQL documentation -EXECUTE name [ ( parameter [, ...] ) ] +EXECUTE name [ ( parameter [, ...] ) ] @@ -61,7 +61,7 @@ EXECUTE name [ ( - name + name The name of the prepared statement to execute. @@ -70,7 +70,7 @@ EXECUTE name [ ( - parameter + parameter The actual value of a parameter to the prepared statement. This diff --git a/doc/src/sgml/ref/fetch.sgml b/doc/src/sgml/ref/fetch.sgml index 24c8c491569..7651dcd0f82 100644 --- a/doc/src/sgml/ref/fetch.sgml +++ b/doc/src/sgml/ref/fetch.sgml @@ -27,23 +27,23 @@ PostgreSQL documentation -FETCH [ direction [ FROM | IN ] ] cursor_name +FETCH [ direction [ FROM | IN ] ] cursor_name -where direction can be empty or one of: +where direction can be empty or one of: NEXT PRIOR FIRST LAST - ABSOLUTE count - RELATIVE count - count + ABSOLUTE count + RELATIVE count + count ALL FORWARD - FORWARD count + FORWARD count FORWARD ALL BACKWARD - BACKWARD count + BACKWARD count BACKWARD ALL @@ -82,7 +82,7 @@ FETCH [ direction [ FROM | IN ] ] < retrieve the indicated number of rows moving in the forward or backward direction, leaving the cursor positioned on the last-returned row (or after/before all rows, if the count exceeds the number of rows + class="parameter">count exceeds the number of rows available). @@ -109,9 +109,9 @@ FETCH [ direction [ FROM | IN ] ] < - direction + direction - direction defines + direction defines the fetch direction and number of rows to fetch. It can be one of the following: @@ -121,7 +121,7 @@ FETCH [ direction [ FROM | IN ] ] < Fetch the next row. This is the default if direction is omitted. + class="parameter">direction is omitted. @@ -154,17 +154,17 @@ FETCH [ direction [ FROM | IN ] ] < - ABSOLUTE count + ABSOLUTE count Fetch the count'th row of the query, + class="parameter">count'th row of the query, or the abs(count)'th row from + class="parameter">count)'th row from the end if count is negative. Position + class="parameter">count is negative. Position before first row or after last row if count is out of range; in + class="parameter">count is out of range; in particular, ABSOLUTE 0 positions before the first row. @@ -172,14 +172,14 @@ FETCH [ direction [ FROM | IN ] ] < - RELATIVE count + RELATIVE count Fetch the count'th succeeding row, or + class="parameter">count'th succeeding row, or the abs(count)'th prior - row if count is + class="parameter">count)'th prior + row if count is negative. RELATIVE 0 re-fetches the current row, if any. @@ -187,13 +187,13 @@ FETCH [ direction [ FROM | IN ] ] < - count + count Fetch the next count rows (same as + class="parameter">count rows (same as FORWARD count). + class="parameter">count). @@ -217,11 +217,11 @@ FETCH [ direction [ FROM | IN ] ] < - FORWARD count + FORWARD count Fetch the next count rows. + class="parameter">count rows. FORWARD 0 re-fetches the current row. @@ -246,11 +246,11 @@ FETCH [ direction [ FROM | IN ] ] < - BACKWARD count + BACKWARD count Fetch the prior count rows (scanning + class="parameter">count rows (scanning backwards). BACKWARD 0 re-fetches the current row. @@ -270,20 +270,20 @@ FETCH [ direction [ FROM | IN ] ] < - count + count - count is a + count is a possibly-signed integer constant, determining the location or number of rows to fetch. For FORWARD and BACKWARD cases, specifying a negative count is equivalent to changing + class="parameter">count is equivalent to changing the sense of FORWARD and BACKWARD. - cursor_name + cursor_name An open cursor's name. @@ -394,7 +394,7 @@ COMMIT WORK; The FETCH forms involving FORWARD and BACKWARD, as well as the forms FETCH count and FETCH + class="parameter">count and FETCH ALL, in which FORWARD is implicit, are PostgreSQL extensions. diff --git a/doc/src/sgml/ref/grant.sgml b/doc/src/sgml/ref/grant.sgml index c63252ca247..8f385f6bb75 100644 --- a/doc/src/sgml/ref/grant.sgml +++ b/doc/src/sgml/ref/grant.sgml @@ -23,70 +23,70 @@ PostgreSQL documentation GRANT { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER } [, ...] | ALL [ PRIVILEGES ] } - ON { [ TABLE ] table_name [, ...] - | ALL TABLES IN SCHEMA schema_name [, ...] } - TO role_specification [, ...] [ WITH GRANT OPTION ] + ON { [ TABLE ] table_name [, ...] + | ALL TABLES IN SCHEMA schema_name [, ...] } + TO role_specification [, ...] [ WITH GRANT OPTION ] -GRANT { { SELECT | INSERT | UPDATE | REFERENCES } ( column_name [, ...] ) - [, ...] | ALL [ PRIVILEGES ] ( column_name [, ...] ) } - ON [ TABLE ] table_name [, ...] - TO role_specification [, ...] [ WITH GRANT OPTION ] +GRANT { { SELECT | INSERT | UPDATE | REFERENCES } ( column_name [, ...] ) + [, ...] | ALL [ PRIVILEGES ] ( column_name [, ...] ) } + ON [ TABLE ] table_name [, ...] + TO role_specification [, ...] [ WITH GRANT OPTION ] GRANT { { USAGE | SELECT | UPDATE } [, ...] | ALL [ PRIVILEGES ] } - ON { SEQUENCE sequence_name [, ...] - | ALL SEQUENCES IN SCHEMA schema_name [, ...] } - TO role_specification [, ...] [ WITH GRANT OPTION ] + ON { SEQUENCE sequence_name [, ...] + | ALL SEQUENCES IN SCHEMA schema_name [, ...] } + TO role_specification [, ...] [ WITH GRANT OPTION ] GRANT { { CREATE | CONNECT | TEMPORARY | TEMP } [, ...] | ALL [ PRIVILEGES ] } ON DATABASE database_name [, ...] - TO role_specification [, ...] [ WITH GRANT OPTION ] + TO role_specification [, ...] [ WITH GRANT OPTION ] GRANT { USAGE | ALL [ PRIVILEGES ] } ON DOMAIN domain_name [, ...] - TO role_specification [, ...] [ WITH GRANT OPTION ] + TO role_specification [, ...] [ WITH GRANT OPTION ] GRANT { USAGE | ALL [ PRIVILEGES ] } ON FOREIGN DATA WRAPPER fdw_name [, ...] - TO role_specification [, ...] [ WITH GRANT OPTION ] + TO role_specification [, ...] [ WITH GRANT OPTION ] GRANT { USAGE | ALL [ PRIVILEGES ] } ON FOREIGN SERVER server_name [, ...] - TO role_specification [, ...] [ WITH GRANT OPTION ] + TO role_specification [, ...] [ WITH GRANT OPTION ] GRANT { EXECUTE | ALL [ PRIVILEGES ] } ON { FUNCTION function_name [ ( [ [ argmode ] [ arg_name ] arg_type [, ...] ] ) ] [, ...] - | ALL FUNCTIONS IN SCHEMA schema_name [, ...] } - TO role_specification [, ...] [ WITH GRANT OPTION ] + | ALL FUNCTIONS IN SCHEMA schema_name [, ...] } + TO role_specification [, ...] [ WITH GRANT OPTION ] GRANT { USAGE | ALL [ PRIVILEGES ] } ON LANGUAGE lang_name [, ...] - TO role_specification [, ...] [ WITH GRANT OPTION ] + TO role_specification [, ...] [ WITH GRANT OPTION ] GRANT { { SELECT | UPDATE } [, ...] | ALL [ PRIVILEGES ] } - ON LARGE OBJECT loid [, ...] - TO role_specification [, ...] [ WITH GRANT OPTION ] + ON LARGE OBJECT loid [, ...] + TO role_specification [, ...] [ WITH GRANT OPTION ] GRANT { { CREATE | USAGE } [, ...] | ALL [ PRIVILEGES ] } ON SCHEMA schema_name [, ...] - TO role_specification [, ...] [ WITH GRANT OPTION ] + TO role_specification [, ...] [ WITH GRANT OPTION ] GRANT { CREATE | ALL [ PRIVILEGES ] } ON TABLESPACE tablespace_name [, ...] - TO role_specification [, ...] [ WITH GRANT OPTION ] + TO role_specification [, ...] [ WITH GRANT OPTION ] GRANT { USAGE | ALL [ PRIVILEGES ] } ON TYPE type_name [, ...] - TO role_specification [, ...] [ WITH GRANT OPTION ] + TO role_specification [, ...] [ WITH GRANT OPTION ] -where role_specification can be: +where role_specification can be: - [ GROUP ] role_name + [ GROUP ] role_name | PUBLIC | CURRENT_USER | SESSION_USER -GRANT role_name [, ...] TO role_name [, ...] [ WITH ADMIN OPTION ] +GRANT role_name [, ...] TO role_name [, ...] [ WITH ADMIN OPTION ] diff --git a/doc/src/sgml/ref/import_foreign_schema.sgml b/doc/src/sgml/ref/import_foreign_schema.sgml index b73dee9439a..f22893f1373 100644 --- a/doc/src/sgml/ref/import_foreign_schema.sgml +++ b/doc/src/sgml/ref/import_foreign_schema.sgml @@ -21,11 +21,11 @@ PostgreSQL documentation -IMPORT FOREIGN SCHEMA remote_schema - [ { LIMIT TO | EXCEPT } ( table_name [, ...] ) ] - FROM SERVER server_name - INTO local_schema - [ OPTIONS ( option 'value' [, ... ] ) ] +IMPORT FOREIGN SCHEMA remote_schema + [ { LIMIT TO | EXCEPT } ( table_name [, ...] ) ] + FROM SERVER server_name + INTO local_schema + [ OPTIONS ( option 'value' [, ... ] ) ] @@ -59,7 +59,7 @@ IMPORT FOREIGN SCHEMA remote_schema - remote_schema + remote_schema The remote schema to import from. The specific meaning of a remote schema @@ -69,7 +69,7 @@ IMPORT FOREIGN SCHEMA remote_schema - LIMIT TO ( table_name [, ...] ) + LIMIT TO ( table_name [, ...] ) Import only foreign tables matching one of the given table names. @@ -79,7 +79,7 @@ IMPORT FOREIGN SCHEMA remote_schema - EXCEPT ( table_name [, ...] ) + EXCEPT ( table_name [, ...] ) Exclude specified foreign tables from the import. All tables @@ -90,7 +90,7 @@ IMPORT FOREIGN SCHEMA remote_schema - server_name + server_name The foreign server to import from. @@ -99,7 +99,7 @@ IMPORT FOREIGN SCHEMA remote_schema - local_schema + local_schema The schema in which the imported foreign tables will be created. @@ -108,7 +108,7 @@ IMPORT FOREIGN SCHEMA remote_schema - OPTIONS ( option 'value' [, ...] ) + OPTIONS ( option 'value' [, ...] ) Options to be used during the import. diff --git a/doc/src/sgml/ref/insert.sgml b/doc/src/sgml/ref/insert.sgml index cc9b94617e9..ce037e59027 100644 --- a/doc/src/sgml/ref/insert.sgml +++ b/doc/src/sgml/ref/insert.sgml @@ -22,25 +22,25 @@ PostgreSQL documentation [ WITH [ RECURSIVE ] with_query [, ...] ] -INSERT INTO table_name [ AS alias ] [ ( column_name [, ...] ) ] +INSERT INTO table_name [ AS alias ] [ ( column_name [, ...] ) ] [ OVERRIDING { SYSTEM | USER} VALUE ] - { DEFAULT VALUES | VALUES ( { expression | DEFAULT } [, ...] ) [, ...] | query } + { DEFAULT VALUES | VALUES ( { expression | DEFAULT } [, ...] ) [, ...] | query } [ ON CONFLICT [ conflict_target ] conflict_action ] [ RETURNING * | output_expression [ [ AS ] output_name ] [, ...] ] where conflict_target can be one of: - ( { index_column_name | ( index_expression ) } [ COLLATE collation ] [ opclass ] [, ...] ) [ WHERE index_predicate ] - ON CONSTRAINT constraint_name + ( { index_column_name | ( index_expression ) } [ COLLATE collation ] [ opclass ] [, ...] ) [ WHERE index_predicate ] + ON CONSTRAINT constraint_name and conflict_action is one of: DO NOTHING - DO UPDATE SET { column_name = { expression | DEFAULT } | - ( column_name [, ...] ) = [ ROW ] ( { expression | DEFAULT } [, ...] ) | - ( column_name [, ...] ) = ( sub-SELECT ) + DO UPDATE SET { column_name = { expression | DEFAULT } | + ( column_name [, ...] ) = [ ROW ] ( { expression | DEFAULT } [, ...] ) | + ( column_name [, ...] ) = ( sub-SELECT ) } [, ...] - [ WHERE condition ] + [ WHERE condition ] @@ -93,7 +93,7 @@ INSERT INTO table_name [ AS ON CONFLICT DO UPDATE ... WHERE clause condition was not satisfied, the + class="parameter">condition was not satisfied, the row will not be returned. @@ -119,7 +119,7 @@ INSERT INTO table_name [ AS RETURNING clause requires SELECT privilege on all columns mentioned in RETURNING. If you use the query clause to insert rows from a + class="parameter">query clause to insert rows from a query, you of course need to have SELECT privilege on any table or column used in the query. @@ -160,7 +160,7 @@ INSERT INTO table_name [ AS - table_name + table_name The name (optionally schema-qualified) of an existing table. @@ -173,7 +173,7 @@ INSERT INTO table_name [ AS A substitute name for table_name. When an alias is + class="parameter">table_name. When an alias is provided, it completely hides the actual name of the table. This is particularly useful when ON CONFLICT DO UPDATE targets a table named excluded, since that will otherwise @@ -185,11 +185,11 @@ INSERT INTO table_name [ AS - column_name + column_name The name of a column in the table named by table_name. The column name + class="parameter">table_name. The column name can be qualified with a subfield name or array subscript, if needed. (Inserting into only some fields of a composite column leaves the other fields null.) When referencing a @@ -246,7 +246,7 @@ INSERT INTO table_name [ AS - expression + expression An expression or value to assign to the corresponding column. @@ -265,7 +265,7 @@ INSERT INTO table_name [ AS - query + query A query (SELECT statement) that supplies the @@ -277,14 +277,14 @@ INSERT INTO table_name [ AS - output_expression + output_expression An expression to be computed and returned by the INSERT command after each row is inserted or updated. The expression can use any column names of the table named by table_name. Write + class="parameter">table_name. Write * to return all columns of the inserted or updated row(s). @@ -292,7 +292,7 @@ INSERT INTO table_name [ AS - output_name + output_name A name to use for a returned column. @@ -328,14 +328,14 @@ INSERT INTO table_name [ AS conflict_target can perform unique index inference. When performing inference, it consists of one or more index_column_name columns and/or - index_expression - expressions, and an optional index_predicate. All table_name unique indexes that, + class="parameter">index_column_name columns and/or + index_expression + expressions, and an optional index_predicate. All table_name unique indexes that, without regard to order, contain exactly the conflict_target-specified columns/expressions are inferred (chosen) as arbiter indexes. If - an index_predicate is + an index_predicate is specified, it must, as a further requirement for inference, satisfy arbiter indexes. Note that this means a non-partial unique index (a unique index without a predicate) will be inferred @@ -400,42 +400,42 @@ INSERT INTO table_name [ AS - index_column_name + index_column_name The name of a table_name column. Used to + class="parameter">table_name column. Used to infer arbiter indexes. Follows CREATE INDEX format. SELECT privilege on - index_column_name + index_column_name is required. - index_expression + index_expression Similar to index_column_name, but used to + class="parameter">index_column_name, but used to infer expressions on table_name columns appearing + class="parameter">table_name columns appearing within index definitions (not simple columns). Follows CREATE INDEX format. SELECT privilege on any column appearing within index_expression is required. + class="parameter">index_expression is required. - collation + collation When specified, mandates that corresponding index_column_name or - index_expression + class="parameter">index_column_name or + index_expression use a particular collation in order to be matched during inference. Typically this is omitted, as collations usually do not affect whether or not a constraint violation occurs. @@ -445,12 +445,12 @@ INSERT INTO table_name [ AS - opclass + opclass When specified, mandates that corresponding index_column_name or - index_expression + class="parameter">index_column_name or + index_expression use particular operator class in order to be matched during inference. Typically this is omitted, as the equality semantics are often equivalent @@ -463,7 +463,7 @@ INSERT INTO table_name [ AS - index_predicate + index_predicate Used to allow inference of partial unique indexes. Any @@ -471,13 +471,13 @@ INSERT INTO table_name [ AS CREATE INDEX format. SELECT privilege on any column appearing within index_predicate is required. + class="parameter">index_predicate is required. - constraint_name + constraint_name Explicitly specifies an arbiter @@ -488,7 +488,7 @@ INSERT INTO table_name [ AS - condition + condition An expression that returns a value of type @@ -522,7 +522,7 @@ INSERT INTO table_name [ AS It is often preferable to use unique index inference rather than naming a constraint directly using ON CONFLICT ON - CONSTRAINT + CONSTRAINT constraint_name. Inference will continue to work correctly when the underlying index is replaced by another more or less equivalent index in an overlapping way, for example when @@ -753,7 +753,7 @@ INSERT INTO distributors (did, dname) VALUES (10, 'Conrad International') Possible limitations of the query clause are documented under + class="parameter">query clause are documented under . diff --git a/doc/src/sgml/ref/listen.sgml b/doc/src/sgml/ref/listen.sgml index 9cd53b02bb2..76215716d61 100644 --- a/doc/src/sgml/ref/listen.sgml +++ b/doc/src/sgml/ref/listen.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -LISTEN channel +LISTEN channel @@ -31,14 +31,14 @@ LISTEN channel LISTEN registers the current session as a listener on the notification channel named channel. + class="parameter">channel. If the current session is already registered as a listener for this notification channel, nothing is done. Whenever the command NOTIFY channel is invoked, either + class="parameter">channel is invoked, either by this session or another one connected to the same database, all the sessions currently listening on that notification channel are notified, and each will in turn notify its connected client @@ -77,7 +77,7 @@ LISTEN channel - channel + channel Name of a notification channel (any identifier). diff --git a/doc/src/sgml/ref/load.sgml b/doc/src/sgml/ref/load.sgml index 6e9182fa3b3..2be28e6d15a 100644 --- a/doc/src/sgml/ref/load.sgml +++ b/doc/src/sgml/ref/load.sgml @@ -20,7 +20,7 @@ doc/src/sgml/ref/load.sgml -LOAD 'filename' +LOAD 'filename' @@ -53,7 +53,7 @@ LOAD 'filename' Non-superusers can only apply LOAD to library files located in $libdir/plugins/ — the specified - filename must begin + filename must begin with exactly that string. (It is the database administrator's responsibility to ensure that only safe libraries are installed there.) diff --git a/doc/src/sgml/ref/lock.sgml b/doc/src/sgml/ref/lock.sgml index b946eab3039..f1dbb8e65a8 100644 --- a/doc/src/sgml/ref/lock.sgml +++ b/doc/src/sgml/ref/lock.sgml @@ -21,9 +21,9 @@ PostgreSQL documentation -LOCK [ TABLE ] [ ONLY ] name [ * ] [, ...] [ IN lockmode MODE ] [ NOWAIT ] +LOCK [ TABLE ] [ ONLY ] name [ * ] [, ...] [ IN lockmode MODE ] [ NOWAIT ] -where lockmode is one of: +where lockmode is one of: ACCESS SHARE | ROW SHARE | ROW EXCLUSIVE | SHARE UPDATE EXCLUSIVE | SHARE | SHARE ROW EXCLUSIVE | EXCLUSIVE | ACCESS EXCLUSIVE @@ -59,7 +59,7 @@ LOCK [ TABLE ] [ ONLY ] name [ * ] committed data, because SHARE lock mode conflicts with the ROW EXCLUSIVE lock acquired by writers, and your LOCK TABLE name IN SHARE MODE + class="parameter">name IN SHARE MODE statement will wait until any concurrent holders of ROW EXCLUSIVE mode locks commit or roll back. Thus, once you obtain the lock, there are no uncommitted writes outstanding; @@ -107,7 +107,7 @@ LOCK [ TABLE ] [ ONLY ] name [ * ] - name + name The name (optionally schema-qualified) of an existing table to diff --git a/doc/src/sgml/ref/move.sgml b/doc/src/sgml/ref/move.sgml index ed64f230689..6b809b961d6 100644 --- a/doc/src/sgml/ref/move.sgml +++ b/doc/src/sgml/ref/move.sgml @@ -27,23 +27,23 @@ PostgreSQL documentation -MOVE [ direction [ FROM | IN ] ] cursor_name +MOVE [ direction [ FROM | IN ] ] cursor_name -where direction can be empty or one of: +where direction can be empty or one of: NEXT PRIOR FIRST LAST - ABSOLUTE count - RELATIVE count - count + ABSOLUTE count + RELATIVE count + count ALL FORWARD - FORWARD count + FORWARD count FORWARD ALL BACKWARD - BACKWARD count + BACKWARD count BACKWARD ALL diff --git a/doc/src/sgml/ref/notify.sgml b/doc/src/sgml/ref/notify.sgml index 3389aa055ca..09debd6685f 100644 --- a/doc/src/sgml/ref/notify.sgml +++ b/doc/src/sgml/ref/notify.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -NOTIFY channel [ , payload ] +NOTIFY channel [ , payload ] @@ -128,7 +128,7 @@ NOTIFY channel [ , - channel + channel Name of the notification channel to be signaled (any identifier). @@ -136,7 +136,7 @@ NOTIFY channel [ , - payload + payload The payload string to be communicated along with the diff --git a/doc/src/sgml/ref/pg_restore.sgml b/doc/src/sgml/ref/pg_restore.sgml index 51801035260..a628e793109 100644 --- a/doc/src/sgml/ref/pg_restore.sgml +++ b/doc/src/sgml/ref/pg_restore.sgml @@ -287,12 +287,12 @@ Restore only those archive elements that are listed in list-file, and restore them in the + class="parameter">list-file, and restore them in the order they appear in the file. Note that if filtering switches such as - list-file is normally created by + list-file is normally created by editing the output of a previous - new_table + new_table The name (optionally schema-qualified) of the table to be created. diff --git a/doc/src/sgml/ref/set.sgml b/doc/src/sgml/ref/set.sgml index 4ebb6a627b6..89c0fad1950 100644 --- a/doc/src/sgml/ref/set.sgml +++ b/doc/src/sgml/ref/set.sgml @@ -21,8 +21,8 @@ PostgreSQL documentation -SET [ SESSION | LOCAL ] configuration_parameter { TO | = } { value | 'value' | DEFAULT } -SET [ SESSION | LOCAL ] TIME ZONE { timezone | LOCAL | DEFAULT } +SET [ SESSION | LOCAL ] configuration_parameter { TO | = } { value | 'value' | DEFAULT } +SET [ SESSION | LOCAL ] TIME ZONE { timezone | LOCAL | DEFAULT } @@ -118,7 +118,7 @@ SET [ SESSION | LOCAL ] TIME ZONE { timezone - configuration_parameter + configuration_parameter Name of a settable run-time parameter. Available parameters are @@ -128,7 +128,7 @@ SET [ SESSION | LOCAL ] TIME ZONE { timezone - value + value New value of parameter. Values can be specified as string diff --git a/doc/src/sgml/ref/show.sgml b/doc/src/sgml/ref/show.sgml index 46bb239baf2..7e198e6df8c 100644 --- a/doc/src/sgml/ref/show.sgml +++ b/doc/src/sgml/ref/show.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -SHOW name +SHOW name SHOW ALL @@ -47,7 +47,7 @@ SHOW ALL - name + name The name of a run-time parameter. Available parameters are diff --git a/doc/src/sgml/ref/truncate.sgml b/doc/src/sgml/ref/truncate.sgml index e9c8a03a638..fef33155998 100644 --- a/doc/src/sgml/ref/truncate.sgml +++ b/doc/src/sgml/ref/truncate.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -TRUNCATE [ TABLE ] [ ONLY ] name [ * ] [, ... ] +TRUNCATE [ TABLE ] [ ONLY ] name [ * ] [, ... ] [ RESTART IDENTITY | CONTINUE IDENTITY ] [ CASCADE | RESTRICT ] @@ -44,7 +44,7 @@ TRUNCATE [ TABLE ] [ ONLY ] name [ - name + name The name (optionally schema-qualified) of a table to truncate. diff --git a/doc/src/sgml/ref/unlisten.sgml b/doc/src/sgml/ref/unlisten.sgml index f7c3c47e2f3..622e1cf1548 100644 --- a/doc/src/sgml/ref/unlisten.sgml +++ b/doc/src/sgml/ref/unlisten.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -UNLISTEN { channel | * } +UNLISTEN { channel | * } @@ -34,7 +34,7 @@ UNLISTEN { channel | * } UNLISTEN cancels any existing registration of the current PostgreSQL session as a listener on the notification channel named channel. The special wildcard + class="parameter">channel. The special wildcard * cancels all listener registrations for the current session. @@ -52,7 +52,7 @@ UNLISTEN { channel | * } - channel + channel Name of a notification channel (any identifier). diff --git a/doc/src/sgml/ref/update.sgml b/doc/src/sgml/ref/update.sgml index 8a1619fb68b..9dcbbd0e287 100644 --- a/doc/src/sgml/ref/update.sgml +++ b/doc/src/sgml/ref/update.sgml @@ -22,13 +22,13 @@ PostgreSQL documentation [ WITH [ RECURSIVE ] with_query [, ...] ] -UPDATE [ ONLY ] table_name [ * ] [ [ AS ] alias ] - SET { column_name = { expression | DEFAULT } | - ( column_name [, ...] ) = [ ROW ] ( { expression | DEFAULT } [, ...] ) | - ( column_name [, ...] ) = ( sub-SELECT ) +UPDATE [ ONLY ] table_name [ * ] [ [ AS ] alias ] + SET { column_name = { expression | DEFAULT } | + ( column_name [, ...] ) = [ ROW ] ( { expression | DEFAULT } [, ...] ) | + ( column_name [, ...] ) = ( sub-SELECT ) } [, ...] - [ FROM from_list ] - [ WHERE condition | WHERE CURRENT OF cursor_name ] + [ FROM from_list ] + [ WHERE condition | WHERE CURRENT OF cursor_name ] [ RETURNING * | output_expression [ [ AS ] output_name ] [, ...] ] @@ -88,7 +88,7 @@ UPDATE [ ONLY ] table_name [ * ] [ - table_name + table_name The name (optionally schema-qualified) of the table to update. @@ -115,11 +115,11 @@ UPDATE [ ONLY ] table_name [ * ] [ - column_name + column_name The name of a column in the table named by table_name. + class="parameter">table_name. The column name can be qualified with a subfield name or array subscript, if needed. Do not include the table's name in the specification of a target column — for example, @@ -129,7 +129,7 @@ UPDATE [ ONLY ] table_name [ * ] [ - expression + expression An expression to assign to the column. The expression can use the @@ -149,7 +149,7 @@ UPDATE [ ONLY ] table_name [ * ] [ - sub-SELECT + sub-SELECT A SELECT sub-query that produces as many output columns @@ -164,7 +164,7 @@ UPDATE [ ONLY ] table_name [ * ] [ - from_list + from_list A list of table expressions, allowing columns from other tables @@ -180,7 +180,7 @@ UPDATE [ ONLY ] table_name [ * ] [ - condition + condition An expression that returns a value of type boolean. @@ -191,7 +191,7 @@ UPDATE [ ONLY ] table_name [ * ] [ - cursor_name + cursor_name The name of the cursor to use in a WHERE CURRENT OF @@ -208,12 +208,12 @@ UPDATE [ ONLY ] table_name [ * ] [ - output_expression + output_expression An expression to be computed and returned by the UPDATE command after each row is updated. The expression can use any - column names of the table named by table_name + column names of the table named by table_name or table(s) listed in FROM. Write * to return all columns. @@ -221,7 +221,7 @@ UPDATE [ ONLY ] table_name [ * ] [ - output_name + output_name A name to use for a returned column. diff --git a/doc/src/sgml/ref/vacuum.sgml b/doc/src/sgml/ref/vacuum.sgml index e712226c61c..f5bc87e2903 100644 --- a/doc/src/sgml/ref/vacuum.sgml +++ b/doc/src/sgml/ref/vacuum.sgml @@ -21,10 +21,10 @@ PostgreSQL documentation -VACUUM [ ( option [, ...] ) ] [ table_and_columns [, ...] ] -VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ table_and_columns [, ...] ] +VACUUM [ ( option [, ...] ) ] [ table_and_columns [, ...] ] +VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ table_and_columns [, ...] ] -where option can be one of: +where option can be one of: FULL FREEZE @@ -32,9 +32,9 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ table_and_columns is: +and table_and_columns is: - table_name [ ( column_name [, ...] ) ] + table_name [ ( column_name [, ...] ) ] @@ -51,7 +51,7 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ table_and_columns + Without a table_and_columns list, VACUUM processes every table and materialized view in the current database that the current user has permission to vacuum. With a list, VACUUM processes only those table(s). @@ -161,7 +161,7 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ table_name + table_name The name (optionally schema-qualified) of a specific table or @@ -172,7 +172,7 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ column_name + column_name The name of a specific column to analyze. Defaults to all columns. diff --git a/doc/src/sgml/ref/values.sgml b/doc/src/sgml/ref/values.sgml index 9b0d8fa4a16..9baeade5519 100644 --- a/doc/src/sgml/ref/values.sgml +++ b/doc/src/sgml/ref/values.sgml @@ -21,7 +21,7 @@ PostgreSQL documentation -VALUES ( expression [, ...] ) [, ...] +VALUES ( expression [, ...] ) [, ...] [ ORDER BY sort_expression [ ASC | DESC | USING operator ] [, ...] ] [ LIMIT { count | ALL } ] [ OFFSET start [ ROW | ROWS ] ] @@ -63,13 +63,13 @@ VALUES ( expression [, ...] ) [, .. - expression + expression A constant or expression to compute and insert at the indicated place in the resulting table (set of rows). In a VALUES list appearing at the top level of an INSERT, an - expression can be replaced + expression can be replaced by DEFAULT to indicate that the destination column's default value should be inserted. DEFAULT cannot be used when VALUES appears in other contexts. diff --git a/doc/src/sgml/textsearch.sgml b/doc/src/sgml/textsearch.sgml index fe630a66b34..d5bde5c6c06 100644 --- a/doc/src/sgml/textsearch.sgml +++ b/doc/src/sgml/textsearch.sgml @@ -701,7 +701,7 @@ LIMIT 10; -to_tsvector( config regconfig, document text) returns tsvector +to_tsvector( config regconfig, document text) returns tsvector @@ -811,7 +811,7 @@ UPDATE tt SET ti = -to_tsquery( config regconfig, querytext text) returns tsquery +to_tsquery( config regconfig, querytext text) returns tsquery @@ -884,7 +884,7 @@ SELECT to_tsquery('''supernovae stars'' & !crab'); -plainto_tsquery( config regconfig, querytext text) returns tsquery +plainto_tsquery( config regconfig, querytext text) returns tsquery @@ -924,7 +924,7 @@ SELECT plainto_tsquery('english', 'The Fat & Rats:C'); -phraseto_tsquery( config regconfig, querytext text) returns tsquery +phraseto_tsquery( config regconfig, querytext text) returns tsquery @@ -994,7 +994,7 @@ SELECT phraseto_tsquery('english', 'The Fat & Rats:C'); ts_rank - ts_rank( weights float4[], vector tsvector, query tsquery , normalization integer ) returns float4 + ts_rank( weights float4[], vector tsvector, query tsquery , normalization integer ) returns float4 @@ -1011,7 +1011,7 @@ SELECT phraseto_tsquery('english', 'The Fat & Rats:C'); ts_rank_cd - ts_rank_cd( weights float4[], vector tsvector, query tsquery , normalization integer ) returns float4 + ts_rank_cd( weights float4[], vector tsvector, query tsquery , normalization integer ) returns float4 @@ -1043,7 +1043,7 @@ SELECT phraseto_tsquery('english', 'The Fat & Rats:C'); For both these functions, - the optional weights + the optional weights argument offers the ability to weigh word instances more or less heavily depending on how they are labeled. The weight arrays specify how heavily to weigh each category of word, in the order: @@ -1052,7 +1052,7 @@ SELECT phraseto_tsquery('english', 'The Fat & Rats:C'); {D-weight, C-weight, B-weight, A-weight} - If no weights are provided, + If no weights are provided, then these defaults are used: @@ -1199,7 +1199,7 @@ LIMIT 10; -ts_headline( config regconfig, document text, query tsquery , options text ) returns text +ts_headline( config regconfig, document text, query tsquery , options text ) returns text @@ -1388,7 +1388,7 @@ query.', setweight - setweight(vector tsvector, weight "char") returns tsvector + setweight(vector tsvector, weight "char") returns tsvector @@ -1416,7 +1416,7 @@ query.', length(tsvector) - length(vector tsvector) returns integer + length(vector tsvector) returns integer @@ -1433,7 +1433,7 @@ query.', strip - strip(vector tsvector) returns tsvector + strip(vector tsvector) returns tsvector @@ -1546,7 +1546,7 @@ SELECT to_tsquery('fat') <-> to_tsquery('cat | rat'); tsquery_phrase - tsquery_phrase(query1 tsquery, query2 tsquery [, distance integer ]) returns tsquery + tsquery_phrase(query1 tsquery, query2 tsquery [, distance integer ]) returns tsquery @@ -1575,7 +1575,7 @@ SELECT tsquery_phrase(to_tsquery('fat'), to_tsquery('cat'), 10); numnode - numnode(query tsquery) returns integer + numnode(query tsquery) returns integer @@ -1609,7 +1609,7 @@ SELECT numnode('foo & bar'::tsquery); querytree - querytree(query tsquery) returns text + querytree(query tsquery) returns text @@ -1662,16 +1662,16 @@ SELECT querytree(to_tsquery('!defined')); - ts_rewrite (query tsquery, target tsquery, substitute tsquery) returns tsquery + ts_rewrite (query tsquery, target tsquery, substitute tsquery) returns tsquery This form of ts_rewrite simply applies a single - rewrite rule: target - is replaced by substitute + rewrite rule: target + is replaced by substitute wherever it appears in query. For example: + class="parameter">query. For example: SELECT ts_rewrite('a & b'::tsquery, 'a'::tsquery, 'c'::tsquery); @@ -1686,7 +1686,7 @@ SELECT ts_rewrite('a & b'::tsquery, 'a'::tsquery, 'c'::tsquery); - ts_rewrite (query tsquery, select text) returns tsquery + ts_rewrite (query tsquery, select text) returns tsquery @@ -1785,8 +1785,8 @@ SELECT ts_rewrite('a & b'::tsquery, -tsvector_update_trigger(tsvector_column_name, config_name, text_column_name , ... ) -tsvector_update_trigger_column(tsvector_column_name, config_column_name, text_column_name , ... ) +tsvector_update_trigger(tsvector_column_name, config_name, text_column_name , ... ) +tsvector_update_trigger_column(tsvector_column_name, config_column_name, text_column_name , ... ) @@ -1886,9 +1886,9 @@ CREATE TRIGGER tsvectorupdate BEFORE INSERT OR UPDATE -ts_stat(sqlquery text, weights text, - OUT word text, OUT ndoc integer, - OUT nentry integer) returns setof record +ts_stat(sqlquery text, weights text, + OUT word text, OUT ndoc integer, + OUT nentry integer) returns setof record @@ -3177,22 +3177,22 @@ SHOW default_text_search_config; -ts_debug( config regconfig, document text, - OUT alias text, - OUT description text, - OUT token text, - OUT dictionaries regdictionary[], - OUT dictionary regdictionary, - OUT lexemes text[]) +ts_debug( config regconfig, document text, + OUT alias text, + OUT description text, + OUT token text, + OUT dictionaries regdictionary[], + OUT dictionary regdictionary, + OUT lexemes text[]) returns setof record ts_debug displays information about every token of - document as produced by the + document as produced by the parser and processed by the configured dictionaries. It uses the configuration specified by config, + class="parameter">config, or default_text_search_config if that argument is omitted. @@ -3360,10 +3360,10 @@ FROM ts_debug('public.english','The Brightest supernovaes'); -ts_parse(parser_name text, document text, - OUT tokid integer, OUT token text) returns setof record -ts_parse(parser_oid oid, document text, - OUT tokid integer, OUT token text) returns setof record +ts_parse(parser_name text, document text, + OUT tokid integer, OUT token text) returns setof record +ts_parse(parser_oid oid, document text, + OUT tokid integer, OUT token text) returns setof record @@ -3391,10 +3391,10 @@ SELECT * FROM ts_parse('default', '123 - a number'); -ts_token_type(parser_name text, OUT tokid integer, - OUT alias text, OUT description text) returns setof record -ts_token_type(parser_oid oid, OUT tokid integer, - OUT alias text, OUT description text) returns setof record +ts_token_type(parser_name text, OUT tokid integer, + OUT alias text, OUT description text) returns setof record +ts_token_type(parser_oid oid, OUT tokid integer, + OUT alias text, OUT description text) returns setof record @@ -3449,7 +3449,7 @@ SELECT * FROM ts_token_type('default'); -ts_lexize(dict regdictionary, token text) returns text[] +ts_lexize(dict regdictionary, token text) returns text[] diff --git a/doc/src/sgml/unaccent.sgml b/doc/src/sgml/unaccent.sgml index 2b127e6736c..d5cf98f6c1f 100644 --- a/doc/src/sgml/unaccent.sgml +++ b/doc/src/sgml/unaccent.sgml @@ -174,11 +174,11 @@ mydb=# select ts_headline('fr','Hôtel de la Mer',to_tsquery('fr','Hotels') -unaccent(dictionary, string) returns text +unaccent(dictionary, string) returns text - If the dictionary argument is + If the dictionary argument is omitted, unaccent is assumed.