diff --git a/doc/src/sgml/ref/analyze.sgml b/doc/src/sgml/ref/analyze.sgml index 20c6f9939f..07dbc9cf44 100644 --- a/doc/src/sgml/ref/analyze.sgml +++ b/doc/src/sgml/ref/analyze.sgml @@ -26,9 +26,9 @@ ANALYZE [ VERBOSE ] [ table_and_columnswhere option can be one of: - VERBOSE [ boolean ] - SKIP_LOCKED [ boolean ] BUFFER_USAGE_LIMIT [ size ] + SKIP_LOCKED [ boolean ] + VERBOSE [ boolean ] and table_and_columns is: @@ -70,10 +70,21 @@ ANALYZE [ VERBOSE ] [ table_and_columns - VERBOSE + BUFFER_USAGE_LIMIT - Enables display of progress messages. + Specifies the + Buffer Access Strategy + ring buffer size for ANALYZE. This size is used to + calculate the number of shared buffers which will be reused as part of + this strategy. 0 disables use of a + Buffer Access Strategy. When this option is not + specified, ANALYZE uses the value from + . Higher settings can + allow ANALYZE to run more quickly, but having too + large a setting may cause too many other useful pages to be evicted from + shared buffers. The minimum value is 128 kB and the + maximum value is 16 GB. @@ -97,21 +108,10 @@ ANALYZE [ VERBOSE ] [ table_and_columns - BUFFER_USAGE_LIMIT + VERBOSE - Specifies the - Buffer Access Strategy - ring buffer size for ANALYZE. This size is used to - calculate the number of shared buffers which will be reused as part of - this strategy. 0 disables use of a - Buffer Access Strategy. When this option is not - specified, ANALYZE uses the value from - . Higher settings can - allow ANALYZE to run more quickly, but having too - large a setting may cause too many other useful pages to be evicted from - shared buffers. The minimum value is 128 kB and the - maximum value is 16 GB. + Enables display of progress messages. @@ -130,6 +130,15 @@ ANALYZE [ VERBOSE ] [ table_and_columns + + column_name + + + The name of a specific column to analyze. Defaults to all columns. + + + + size @@ -156,15 +165,6 @@ ANALYZE [ VERBOSE ] [ table_and_columns - - - column_name - - - The name of a specific column to analyze. Defaults to all columns. - - - diff --git a/doc/src/sgml/ref/cluster.sgml b/doc/src/sgml/ref/cluster.sgml index 29f0f1fd90..b81542cf70 100644 --- a/doc/src/sgml/ref/cluster.sgml +++ b/doc/src/sgml/ref/cluster.sgml @@ -87,42 +87,42 @@ CLUSTER [VERBOSE] - table_name + VERBOSE - The name (possibly schema-qualified) of a table. + Prints a progress report as each table is clustered. - index_name + boolean - The name of an index. + Specifies whether the selected option should be turned on or off. + You can write TRUE, ON, or + 1 to enable the option, and FALSE, + OFF, or 0 to disable it. The + boolean value can also + be omitted, in which case TRUE is assumed. - VERBOSE + index_name - Prints a progress report as each table is clustered. + The name of an index. - boolean + table_name - Specifies whether the selected option should be turned on or off. - You can write TRUE, ON, or - 1 to enable the option, and FALSE, - OFF, or 0 to disable it. The - boolean value can also - be omitted, in which case TRUE is assumed. + The name (possibly schema-qualified) of a table. diff --git a/doc/src/sgml/ref/copy.sgml b/doc/src/sgml/ref/copy.sgml index 5e591ed2e6..0cbcb7bccd 100644 --- a/doc/src/sgml/ref/copy.sgml +++ b/doc/src/sgml/ref/copy.sgml @@ -32,18 +32,18 @@ COPY { table_name [ ( where option can be one of: - FORMAT format_name - FREEZE [ boolean ] + DEFAULT 'default_string' DELIMITER 'delimiter_character' - NULL 'null_string' - HEADER [ boolean | MATCH ] - QUOTE 'quote_character' + ENCODING 'encoding_name' ESCAPE 'escape_character' - FORCE_QUOTE { ( column_name [, ...] ) | * } FORCE_NOT_NULL ( column_name [, ...] ) FORCE_NULL ( column_name [, ...] ) - ENCODING 'encoding_name' - DEFAULT 'default_string' + FORCE_QUOTE { ( column_name [, ...] ) | * } + FORMAT format_name + FREEZE [ boolean ] + HEADER [ boolean | MATCH ] + NULL 'null_string' + QUOTE 'quote_character' @@ -96,105 +96,95 @@ COPY { table_name [ ( - table_name + DEFAULT - The name (optionally schema-qualified) of an existing table. - - - - - - column_name - - - An optional list of columns to be copied. If no column list is - specified, all columns of the table except generated columns will be - copied. + Specifies the string that represents a default value. Each time the string + is found in the input file, the default value of the corresponding column + will be used. + This option is allowed only in COPY FROM, and only when + not using binary format. - query + DELIMITER - A SELECT, - VALUES, - INSERT, - UPDATE, or - DELETE command whose results are to be - copied. Note that parentheses are required around the query. - - - For INSERT, UPDATE and - DELETE queries a RETURNING clause must be provided, - and the target relation must not have a conditional rule, nor - an ALSO rule, nor an INSTEAD rule - that expands to multiple statements. + Specifies the character that separates columns within each row + (line) of the file. The default is a tab character in text format, + a comma in CSV format. + This must be a single one-byte character. + This option is not allowed when using binary format. - filename + ENCODING - The path name of the input or output file. An input file name can be - an absolute or relative path, but an output file name must be an absolute - path. Windows users might need to use an E'' string and - double any backslashes used in the path name. + Specifies that the file is encoded in the encoding_name. If this option is + omitted, the current client encoding is used. See the Notes below + for more details. - PROGRAM + ESCAPE - A command to execute. In COPY FROM, the input is - read from standard output of the command, and in COPY TO, - the output is written to the standard input of the command. - - - Note that the command is invoked by the shell, so if you need to pass - any arguments that come from an untrusted source, you - must be careful to strip or escape any special characters that might - have a special meaning for the shell. For security reasons, it is best - to use a fixed command string, or at least avoid including any user input - in it. + Specifies the character that should appear before a + data character that matches the QUOTE value. + The default is the same as the QUOTE value (so that + the quoting character is doubled if it appears in the data). + This must be a single one-byte character. + This option is allowed only when using CSV format. - STDIN + FORCE_NOT_NULL - Specifies that input comes from the client application. + Do not match the specified columns' values against the null string. + In the default case where the null string is empty, this means that + empty values will be read as zero-length strings rather than nulls, + even when they are not quoted. + This option is allowed only in COPY FROM, and only when + using CSV format. - STDOUT + FORCE_NULL - Specifies that output goes to the client application. + Match the specified columns' values against the null string, even + if it has been quoted, and if a match is found set the value to + NULL. In the default case where the null string is empty, + this converts a quoted empty string into NULL. + This option is allowed only in COPY FROM, and only when + using CSV format. - boolean + FORCE_QUOTE - Specifies whether the selected option should be turned on or off. - You can write TRUE, ON, or - 1 to enable the option, and FALSE, - OFF, or 0 to disable it. The - boolean value can also - be omitted, in which case TRUE is assumed. + Forces quoting to be + used for all non-NULL values in each specified column. + NULL output is never quoted. If * is specified, + non-NULL values will be quoted in all columns. + This option is allowed only in COPY TO, and only when + using CSV format. @@ -235,14 +225,19 @@ COPY { table_name [ ( - DELIMITER + HEADER - Specifies the character that separates columns within each row - (line) of the file. The default is a tab character in text format, - a comma in CSV format. - This must be a single one-byte character. + Specifies that the file contains a header line with the names of each + column in the file. On output, the first line contains the column + names from the table. On input, the first line is discarded when this + option is set to true (or equivalent Boolean value). + If this option is set to MATCH, the number and names + of the columns in the header line must match the actual column names of + the table, in order; otherwise an error is raised. This option is not allowed when using binary format. + The MATCH option is only valid for COPY + FROM commands. @@ -272,19 +267,20 @@ COPY { table_name [ ( - HEADER + PROGRAM - Specifies that the file contains a header line with the names of each - column in the file. On output, the first line contains the column - names from the table. On input, the first line is discarded when this - option is set to true (or equivalent Boolean value). - If this option is set to MATCH, the number and names - of the columns in the header line must match the actual column names of - the table, in order; otherwise an error is raised. - This option is not allowed when using binary format. - The MATCH option is only valid for COPY - FROM commands. + A command to execute. In COPY FROM, the input is + read from standard output of the command, and in COPY TO, + the output is written to the standard input of the command. + + + Note that the command is invoked by the shell, so if you need to pass + any arguments that come from an untrusted source, you + must be careful to strip or escape any special characters that might + have a special meaning for the shell. For security reasons, it is best + to use a fixed command string, or at least avoid including any user input + in it. @@ -302,109 +298,113 @@ COPY { table_name [ ( - ESCAPE + STDIN - Specifies the character that should appear before a - data character that matches the QUOTE value. - The default is the same as the QUOTE value (so that - the quoting character is doubled if it appears in the data). - This must be a single one-byte character. - This option is allowed only when using CSV format. + Specifies that input comes from the client application. - FORCE_QUOTE + STDOUT - Forces quoting to be - used for all non-NULL values in each specified column. - NULL output is never quoted. If * is specified, - non-NULL values will be quoted in all columns. - This option is allowed only in COPY TO, and only when - using CSV format. + Specifies that output goes to the client application. - FORCE_NOT_NULL + WHERE + + + The optional WHERE clause has the general form + +WHERE condition + + where condition is + any expression that evaluates to a result of type + boolean. Any row that does not satisfy this + condition will not be inserted to the table. A row satisfies the + condition if it returns true when the actual row values are + substituted for any variable references. + + + + Currently, subqueries are not allowed in WHERE + expressions, and the evaluation does not see any changes made by the + COPY itself (this matters when the expression + contains calls to VOLATILE functions). + + + + + + + boolean - Do not match the specified columns' values against the null string. - In the default case where the null string is empty, this means that - empty values will be read as zero-length strings rather than nulls, - even when they are not quoted. - This option is allowed only in COPY FROM, and only when - using CSV format. + Specifies whether the selected option should be turned on or off. + You can write TRUE, ON, or + 1 to enable the option, and FALSE, + OFF, or 0 to disable it. The + boolean value can also + be omitted, in which case TRUE is assumed. - FORCE_NULL - + column_name + - Match the specified columns' values against the null string, even - if it has been quoted, and if a match is found set the value to - NULL. In the default case where the null string is empty, - this converts a quoted empty string into NULL. - This option is allowed only in COPY FROM, and only when - using CSV format. + An optional list of columns to be copied. If no column list is + specified, all columns of the table except generated columns will be + copied. - ENCODING + filename - Specifies that the file is encoded in the encoding_name. If this option is - omitted, the current client encoding is used. See the Notes below - for more details. + The path name of the input or output file. An input file name can be + an absolute or relative path, but an output file name must be an absolute + path. Windows users might need to use an E'' string and + double any backslashes used in the path name. - DEFAULT + query - Specifies the string that represents a default value. Each time the string - is found in the input file, the default value of the corresponding column - will be used. - This option is allowed only in COPY FROM, and only when - not using binary format. + A SELECT, + VALUES, + INSERT, + UPDATE, or + DELETE command whose results are to be + copied. Note that parentheses are required around the query. + + + For INSERT, UPDATE and + DELETE queries a RETURNING clause must be provided, + and the target relation must not have a conditional rule, nor + an ALSO rule, nor an INSTEAD rule + that expands to multiple statements. - WHERE + table_name - - The optional WHERE clause has the general form - -WHERE condition - - where condition is - any expression that evaluates to a result of type - boolean. Any row that does not satisfy this - condition will not be inserted to the table. A row satisfies the - condition if it returns true when the actual row values are - substituted for any variable references. - - - - Currently, subqueries are not allowed in WHERE - expressions, and the evaluation does not see any changes made by the - COPY itself (this matters when the expression - contains calls to VOLATILE functions). - - + + The name (optionally schema-qualified) of an existing table. + diff --git a/doc/src/sgml/ref/explain.sgml b/doc/src/sgml/ref/explain.sgml index 410490951b..4df028ffd6 100644 --- a/doc/src/sgml/ref/explain.sgml +++ b/doc/src/sgml/ref/explain.sgml @@ -37,15 +37,15 @@ EXPLAIN [ ANALYZE ] [ VERBOSE ] statementwhere option can be one of: ANALYZE [ boolean ] - VERBOSE [ boolean ] + BUFFERS [ boolean ] COSTS [ boolean ] - SETTINGS [ boolean ] + FORMAT { TEXT | XML | JSON | YAML } GENERIC_PLAN [ boolean ] - BUFFERS [ boolean ] - WAL [ boolean ] - TIMING [ boolean ] + SETTINGS [ boolean ] SUMMARY [ boolean ] - FORMAT { TEXT | XML | JSON | YAML } + TIMING [ boolean ] + VERBOSE [ boolean ] + WAL [ boolean ] @@ -131,17 +131,30 @@ ROLLBACK; - VERBOSE + BUFFERS - Display additional information regarding the plan. Specifically, include - the output column list for each node in the plan tree, schema-qualify - table and function names, always label variables in expressions with - their range table alias, and always print the name of each trigger for - which statistics are displayed. The query identifier will also be - displayed if one has been computed, see for more details. This parameter - defaults to FALSE. + Include information on buffer usage. Specifically, include the number of + shared blocks hit, read, dirtied, and written, the number of local blocks + hit, read, dirtied, and written, the number of temp blocks read and + written, and the time spent reading and writing data file blocks and + temporary file blocks (in milliseconds) if + is enabled. A + hit means that a read was avoided because the block + was found already in cache when needed. + Shared blocks contain data from regular tables and indexes; + local blocks contain data from temporary tables and indexes; + while temporary blocks contain short-term working data used in sorts, + hashes, Materialize plan nodes, and similar cases. + The number of blocks dirtied indicates the number of + previously unmodified blocks that were changed by this query; while the + number of blocks written indicates the number of + previously-dirtied blocks evicted from cache by this backend during + query processing. + The number of blocks shown for an + upper-level node includes those used by all its child nodes. In text + format, only non-zero values are printed. This parameter defaults to + FALSE. @@ -159,12 +172,13 @@ ROLLBACK; - SETTINGS + FORMAT - Include information on configuration parameters. Specifically, include - options affecting query planning with value different from the built-in - default value. This parameter defaults to FALSE. + Specify the output format, which can be TEXT, XML, JSON, or YAML. + Non-text output contains the same information as the text output + format, but is easier for programs to parse. This parameter defaults to + TEXT. @@ -186,43 +200,27 @@ ROLLBACK; - BUFFERS + SETTINGS - Include information on buffer usage. Specifically, include the number of - shared blocks hit, read, dirtied, and written, the number of local blocks - hit, read, dirtied, and written, the number of temp blocks read and - written, and the time spent reading and writing data file blocks and - temporary file blocks (in milliseconds) if - is enabled. A - hit means that a read was avoided because the block - was found already in cache when needed. - Shared blocks contain data from regular tables and indexes; - local blocks contain data from temporary tables and indexes; - while temporary blocks contain short-term working data used in sorts, - hashes, Materialize plan nodes, and similar cases. - The number of blocks dirtied indicates the number of - previously unmodified blocks that were changed by this query; while the - number of blocks written indicates the number of - previously-dirtied blocks evicted from cache by this backend during - query processing. - The number of blocks shown for an - upper-level node includes those used by all its child nodes. In text - format, only non-zero values are printed. This parameter defaults to - FALSE. + Include information on configuration parameters. Specifically, include + options affecting query planning with value different from the built-in + default value. This parameter defaults to FALSE. - WAL + SUMMARY - Include information on WAL record generation. Specifically, include the - number of records, number of full page images (fpi) and the amount of WAL - generated in bytes. In text format, only non-zero values are printed. - This parameter may only be used when ANALYZE is also - enabled. It defaults to FALSE. + Include summary information (e.g., totaled timing information) after the + query plan. Summary information is included by default when + ANALYZE is used but otherwise is not included by + default, but can be enabled using this option. Planning time in + EXPLAIN EXECUTE includes the time required to fetch + the plan from the cache and the time required for re-planning, if + necessary. @@ -245,28 +243,30 @@ ROLLBACK; - SUMMARY + VERBOSE - Include summary information (e.g., totaled timing information) after the - query plan. Summary information is included by default when - ANALYZE is used but otherwise is not included by - default, but can be enabled using this option. Planning time in - EXPLAIN EXECUTE includes the time required to fetch - the plan from the cache and the time required for re-planning, if - necessary. + Display additional information regarding the plan. Specifically, include + the output column list for each node in the plan tree, schema-qualify + table and function names, always label variables in expressions with + their range table alias, and always print the name of each trigger for + which statistics are displayed. The query identifier will also be + displayed if one has been computed, see for more details. This parameter + defaults to FALSE. - FORMAT + WAL - Specify the output format, which can be TEXT, XML, JSON, or YAML. - Non-text output contains the same information as the text output - format, but is easier for programs to parse. This parameter defaults to - TEXT. + Include information on WAL record generation. Specifically, include the + number of records, number of full page images (fpi) and the amount of WAL + generated in bytes. In text format, only non-zero values are printed. + This parameter may only be used when ANALYZE is also + enabled. It defaults to FALSE. diff --git a/doc/src/sgml/ref/reindex.sgml b/doc/src/sgml/ref/reindex.sgml index 71455dfdc7..eb7fcbcc0b 100644 --- a/doc/src/sgml/ref/reindex.sgml +++ b/doc/src/sgml/ref/reindex.sgml @@ -88,48 +88,55 @@ REINDEX [ ( option [, ...] ) ] { DA - INDEX + CONCURRENTLY - Recreate the specified index. This form of REINDEX - cannot be executed inside a transaction block when used with a - partitioned index. + When this option is used, PostgreSQL will rebuild the + index without taking any locks that prevent concurrent inserts, + updates, or deletes on the table; whereas a standard index rebuild + locks out writes (but not reads) on the table until it's done. + There are several caveats to be aware of when using this option + — see below. + + + For temporary tables, REINDEX is always + non-concurrent, as no other session can access them, and + non-concurrent reindex is cheaper. - TABLE + DATABASE - Recreate all indexes of the specified table. If the table has a - secondary TOAST table, that is reindexed as well. + Recreate all indexes within the current database, except system + catalogs. + Indexes on system catalogs are not processed. This form of REINDEX cannot be executed inside a - transaction block when used with a partitioned table. + transaction block. - SCHEMA + INDEX - Recreate all indexes of the specified schema. If a table of this - schema has a secondary TOAST table, that is reindexed as - well. Indexes on shared system catalogs are also processed. - This form of REINDEX cannot be executed inside a - transaction block. + Recreate the specified index. This form of REINDEX + cannot be executed inside a transaction block when used with a + partitioned index. - DATABASE + SCHEMA - Recreate all indexes within the current database, except system - catalogs. - Indexes on system catalogs are not processed. + Recreate all indexes of the specified schema. If a table of this + schema has a secondary TOAST table, that is reindexed as + well. Indexes on shared system catalogs are also processed. This form of REINDEX cannot be executed inside a transaction block. @@ -150,33 +157,13 @@ REINDEX [ ( option [, ...] ) ] { DA - name - - - The name of the specific index, table, or database to be - reindexed. Index and table names can be schema-qualified. - Presently, REINDEX DATABASE and REINDEX SYSTEM - can only reindex the current database. Their parameter is optional, - and it must match the current database's name. - - - - - - CONCURRENTLY + TABLE - When this option is used, PostgreSQL will rebuild the - index without taking any locks that prevent concurrent inserts, - updates, or deletes on the table; whereas a standard index rebuild - locks out writes (but not reads) on the table until it's done. - There are several caveats to be aware of when using this option - — see below. - - - For temporary tables, REINDEX is always - non-concurrent, as no other session can access them, and - non-concurrent reindex is cheaper. + Recreate all indexes of the specified table. If the table has a + secondary TOAST table, that is reindexed as well. + This form of REINDEX cannot be executed inside a + transaction block when used with a partitioned table. @@ -213,6 +200,19 @@ REINDEX [ ( option [, ...] ) ] { DA + + name + + + The name of the specific index, table, or database to be + reindexed. Index and table names can be schema-qualified. + Presently, REINDEX DATABASE and REINDEX SYSTEM + can only reindex the current database. Their parameter is optional, + and it must match the current database's name. + + + + new_tablespace diff --git a/doc/src/sgml/ref/vacuum.sgml b/doc/src/sgml/ref/vacuum.sgml index 57bc4c23ec..a3a4224ec7 100644 --- a/doc/src/sgml/ref/vacuum.sgml +++ b/doc/src/sgml/ref/vacuum.sgml @@ -26,20 +26,20 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ option can be one of: - FULL [ boolean ] - FREEZE [ boolean ] - VERBOSE [ boolean ] ANALYZE [ boolean ] + BUFFER_USAGE_LIMIT [ size ] DISABLE_PAGE_SKIPPING [ boolean ] - SKIP_LOCKED [ boolean ] + FREEZE [ boolean ] + FULL [ boolean ] INDEX_CLEANUP { AUTO | ON | OFF } + ONLY_DATABASE_STATS [ boolean ] + PARALLEL integer PROCESS_MAIN [ boolean ] PROCESS_TOAST [ boolean ] - TRUNCATE [ boolean ] - PARALLEL integer SKIP_DATABASE_STATS [ boolean ] - ONLY_DATABASE_STATS [ boolean ] - BUFFER_USAGE_LIMIT [ size ] + SKIP_LOCKED [ boolean ] + TRUNCATE [ boolean ] + VERBOSE [ boolean ] and table_and_columns is: @@ -106,50 +106,35 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ and - parameters - set to zero. Aggressive freezing is always performed when the - table is rewritten, so this option is redundant when FULL - is specified. - - - - - - VERBOSE + ANALYZE - Prints a detailed vacuum activity report for each table. + Updates statistics used by the planner to determine the most + efficient way to execute a query. - ANALYZE + BUFFER_USAGE_LIMIT - Updates statistics used by the planner to determine the most - efficient way to execute a query. + Specifies the + Buffer Access Strategy + ring buffer size for VACUUM. This size is used to + calculate the number of shared buffers which will be reused as part of + this strategy. 0 disables use of a + Buffer Access Strategy. If + is also specified, the value is used + for both the vacuum and analyze stages. This option can't be used with + the option except if is + also specified. When this option is not specified, + VACUUM uses the value from + . Higher settings can + allow VACUUM to run more quickly, but having too + large a setting may cause too many other useful pages to be evicted from + shared buffers. The minimum value is 128 kB and the + maximum value is 16 GB. @@ -174,21 +159,31 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ and + parameters + set to zero. Aggressive freezing is always performed when the + table is rewritten, so this option is redundant when FULL + is specified. + + + + + + FULL + + + Selects full vacuum, which can reclaim more + space, but takes much longer and exclusively locks the table. + This method also requires extra disk space, since it writes a + new copy of the table and doesn't release the old copy until + the operation is complete. Usually this should only be used when a + significant amount of space needs to be reclaimed from within the table. @@ -241,45 +236,15 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ table_and_columns + list must be empty, and no other option may be enabled + except VERBOSE. @@ -311,6 +276,32 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ - ONLY_DATABASE_STATS + SKIP_LOCKED - Specifies that VACUUM should do nothing except - update the database-wide statistics about oldest unfrozen XIDs. - When this option is specified, - the table_and_columns - list must be empty, and no other option may be enabled - except VERBOSE. + Specifies that VACUUM should not wait for any + conflicting locks to be released when beginning work on a relation: + if a relation cannot be locked immediately without waiting, the relation + is skipped. Note that even with this option, + VACUUM may still block when opening the relation's + indexes. Additionally, VACUUM ANALYZE may still + block when acquiring sample rows from partitions, table inheritance + children, and some types of foreign tables. Also, while + VACUUM ordinarily processes all partitions of + specified partitioned tables, this option will cause + VACUUM to skip all partitions if there is a + conflicting lock on the partitioned table. - BUFFER_USAGE_LIMIT + TRUNCATE - Specifies the - Buffer Access Strategy - ring buffer size for VACUUM. This size is used to - calculate the number of shared buffers which will be reused as part of - this strategy. 0 disables use of a - Buffer Access Strategy. If - is also specified, the value is used - for both the vacuum and analyze stages. This option can't be used with - the option except if is - also specified. When this option is not specified, - VACUUM uses the value from - . Higher settings can - allow VACUUM to run more quickly, but having too - large a setting may cause too many other useful pages to be evicted from - shared buffers. The minimum value is 128 kB and the - maximum value is 16 GB. + Specifies that VACUUM should attempt to + truncate off any empty pages at the end of the table and allow + the disk space for the truncated pages to be returned to + the operating system. This is normally the desired behavior + and is the default unless the vacuum_truncate + option has been set to false for the table to be vacuumed. + Setting this option to false may be useful to avoid + ACCESS EXCLUSIVE lock on the table that + the truncation requires. This option is ignored if the + FULL option is used. + + + + + + VERBOSE + + + Prints a detailed vacuum activity report for each table. @@ -384,6 +384,17 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ column_name + + + The name of a specific column to analyze. Defaults to all columns. + If a column list is specified, ANALYZE must also be + specified. + + + + integer @@ -416,17 +427,6 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ column_name - - - The name of a specific column to analyze. Defaults to all columns. - If a column list is specified, ANALYZE must also be - specified. - - -