From: Neil Conway Date: Sun, 12 Nov 2006 06:25:37 +0000 (+0000) Subject: Do a round of copy-editing for the system catalog chapter. In particular, X-Git-Tag: REL9_0_0~6723 X-Git-Url: http://git.osdn.net/view?a=commitdiff_plain;h=f49baa73ef2f447267893cbf72b333b456fd2e60;p=pg-rex%2Fsyncrep.git Do a round of copy-editing for the system catalog chapter. In particular, consistently capitalize the content of the "Description" column but do not include a terminating period, as is the convention elsewhere in the docs. Also, remove the "References" column from catalog that do not have any referencing columns, for the sake of brevity. Make various other SGML and grammar fixes. --- diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml index 1ade58644e..4d66020a34 100644 --- a/doc/src/sgml/catalogs.sgml +++ b/doc/src/sgml/catalogs.sgml @@ -1,4 +1,4 @@ - + @@ -290,7 +290,7 @@ The initial value of the transition state. This is a text field containing the initial value in its external string representation. If this field is NULL, the transition state - value starts out NULL. + value starts out NULL @@ -779,7 +779,7 @@ The exact meaning of positive values is data type-dependent. For scalar data types, attstattarget is both the target number of most common values - to collect, and the target number of histogram bins to create. + to collect, and the target number of histogram bins to create @@ -800,7 +800,7 @@ The number of the column. Ordinary columns are numbered from 1 up. System columns, such as oid, - have (arbitrary) negative numbers. + have (arbitrary) negative numbers @@ -811,7 +811,7 @@ Number of dimensions, if the column is an array type; otherwise 0. (Presently, the number of dimensions of an array is not enforced, - so any nonzero value effectively means it's an array.) + so any nonzero value effectively means it's an array) @@ -822,7 +822,7 @@ Always -1 in storage, but when loaded into a row descriptor in memory this may be updated to cache the offset of the attribute - within the row. + within the row @@ -835,7 +835,7 @@ supplied at table creation time (for example, the maximum length of a varchar column). It is passed to type-specific input functions and length coercion functions. - The value will generally be -1 for types that do not need atttypmod. + The value will generally be -1 for types that do not need atttypmod @@ -855,7 +855,7 @@ Normally a copy of pg_type.typstorage of this column's type. For TOAST-able data types, this can be altered - after column creation to control storage policy. + after column creation to control storage policy @@ -874,7 +874,7 @@ This represents a not-null constraint. It is possible to - change this column to enable or disable the constraint. + change this column to enable or disable the constraint @@ -885,7 +885,7 @@ This column has a default value, in which case there will be a corresponding entry in the pg_attrdef - catalog that actually defines the value. + catalog that actually defines the value @@ -896,7 +896,7 @@ This column has been dropped and is no longer valid. A dropped column is still physically present in the table, but is - ignored by the parser and so cannot be accessed via SQL. + ignored by the parser and so cannot be accessed via SQL @@ -906,7 +906,7 @@ This column is defined locally in the relation. Note that a column may - be locally defined and inherited simultaneously. + be locally defined and inherited simultaneously @@ -916,7 +916,7 @@ The number of direct ancestors this column has. A column with a - nonzero number of ancestors cannot be dropped nor renamed. + nonzero number of ancestors cannot be dropped nor renamed @@ -981,7 +981,6 @@ Name Type - References Description @@ -990,21 +989,18 @@ rolname name - Role name rolsuper bool - Role has superuser privileges rolinherit bool - Role automatically inherits privileges of roles it is a member of @@ -1012,58 +1008,51 @@ rolcreaterole bool - Role may create more roles rolcreatedb bool - Role may create databases rolcatupdate bool - Role may update system catalogs directly. (Even a superuser may not do - this unless this column is true.) + this unless this column is true) rolcanlogin bool - Role may log in. That is, this role can be given as the initial - session authorization identifier. + session authorization identifier rolconnlimit int4 - For roles that can log in, this sets maximum number of concurrent - connections this role can make. -1 means no limit. + connections this role can make. -1 means no limit rolpassword text - Password (possibly encrypted); NULL if none rolvaliduntil timestamptz - Password expiry time (only used for password authentication); NULL if no expiration @@ -1071,7 +1060,6 @@ rolconfig text[] - Session defaults for run-time configuration variables @@ -1164,10 +1152,11 @@ The catalog pg_autovacuum stores optional - per-relation configuration parameters for . + per-relation configuration parameters for the autovacuum daemon. If there is an entry here for a particular relation, the given parameters will be used for autovacuuming that table. If no entry - is present, the system-wide defaults will be used. + is present, the system-wide defaults will be used. For more information + about the autovacuum daemon, see . @@ -1288,13 +1277,13 @@ any negative value) to indicate that the system-wide default should be used for this particular value. Observe that the vac_cost_delay variable inherits its default value from the - autovacuum_vacuum_cost_delay configuration parameter, + configuration parameter, or from vacuum_cost_delay if the former is set to a negative value. The same applies to vac_cost_limit. Also, autovacuum will ignore attempts to set a per-table - freeze_max_age larger than the system-wide setting (it can only be set - smaller), and the freeze_min_age value will be limited to half the - system-wide autovacuum_freeze_max_age setting. + freeze_max_age larger than the system-wide setting (it can only be set + smaller), and the freeze_min_age value will be limited to half the + system-wide setting. @@ -1309,7 +1298,8 @@ The catalog pg_cast stores data type conversion paths, - both built-in paths and those defined with CREATE CAST. + both built-in paths and those defined with + .
@@ -1347,7 +1337,7 @@ The OID of the function to use to perform this cast. Zero is stored if the data types are binary compatible (that is, no - run-time operation is needed to perform the cast). + run-time operation is needed to perform the cast) @@ -1362,7 +1352,7 @@ a means implicitly in assignment to a target column, as well as explicitly. i means implicitly in expressions, as well as the - other cases. + other cases @@ -1499,11 +1489,10 @@ Size of the on-disk representation of this table in pages (of size - BLCKSZ). - This is only an estimate used by the planner. - It is updated by VACUUM, - ANALYZE, and a few DDL commands - such as CREATE INDEX. + BLCKSZ). This is only an estimate used by the + planner. It is updated by VACUUM, + ANALYZE, and a few DDL commands such as + CREATE INDEX @@ -1512,11 +1501,10 @@ float4 - Number of rows in the table. - This is only an estimate used by the planner. - It is updated by VACUUM, - ANALYZE, and a few DDL commands - such as CREATE INDEX. + Number of rows in the table. This is only an estimate used by the + planner. It is updated by VACUUM, + ANALYZE, and a few DDL commands such as + CREATE INDEX @@ -1525,9 +1513,9 @@ oid pg_class.oid - OID of the TOAST table associated with this table, 0 if none. - The TOAST table stores large attributes out of - line in a secondary table. + OID of the TOAST table associated with this table, 0 if none. The + TOAST table stores large attributes out of line in a + secondary table @@ -1536,7 +1524,7 @@ oid pg_class.oid - For a TOAST table, the OID of its index. 0 if not a TOAST table. + For a TOAST table, the OID of its index. 0 if not a TOAST table @@ -1549,7 +1537,7 @@ indexes. This is set by CREATE INDEX, but not cleared immediately by DROP INDEX. VACUUM clears relhasindex if it finds the - table has no indexes. + table has no indexes @@ -1557,9 +1545,11 @@ relisshared bool - True if this table is shared across all databases in the - cluster. Only certain system catalogs (such as - pg_database) are shared. + + True if this table is shared across all databases in the cluster. Only + certain system catalogs (such as pg_database) + are shared + @@ -1582,7 +1572,7 @@ Number of user columns in the relation (system columns not counted). There must be this many corresponding entries in pg_attribute. See also - pg_attribute.attnum. + pg_attribute.attnum @@ -1592,7 +1582,7 @@ Number of check constraints on the table; see - pg_constraint catalog + pg_constraint catalog @@ -1602,7 +1592,7 @@ Number of triggers on the table; see - pg_trigger catalog + pg_trigger catalog @@ -1649,8 +1639,9 @@ relhasrules bool - True if table has rules; see - pg_rewrite catalog + + True if table has rules; see + pg_rewrite catalog @@ -1670,7 +1661,7 @@ (frozen) transaction ID in this table. This is used to track whether the table needs to be vacuumed in order to prevent transaction ID wraparound or to allow pg_clog to be shrunk. Zero - (InvalidTransactionId) if the relation is not a table. + (InvalidTransactionId) if the relation is not a table @@ -1959,11 +1950,11 @@ - The catalog pg_database stores information - about the available databases. Databases are created with the - CREATE DATABASE command. Consult - for details about the meaning of some of the - parameters. + The catalog pg_database stores information about + the available databases. Databases are created with the command. + Consult for details about the meaning + of some of the parameters. @@ -2018,7 +2009,7 @@ If true then this database can be used in the TEMPLATE clause of CREATE DATABASE to create a new database as a clone of - this one. + this one @@ -2028,7 +2019,7 @@ If false then no one can connect to this database. This is - used to protect the template0 database from being altered. + used to protect the template0 database from being altered @@ -2038,7 +2029,7 @@ Sets maximum number of concurrent connections that can be made - to this database. -1 means no limit. + to this database. -1 means no limit @@ -2062,7 +2053,7 @@ track whether the database needs to be vacuumed in order to prevent transaction ID wraparound or to allow pg_clog to be shrunk. It is the minimum of the per-table - pg_class.relfrozenxid values. + pg_class.relfrozenxid values @@ -2075,7 +2066,7 @@ Within this database, all tables for which pg_class.reltablespace is zero will be stored in this tablespace; in particular, all the non-shared - system catalogs will be there. + system catalogs will be there @@ -2160,7 +2151,7 @@ For a table column, this is the column number (the objid and classid refer to the table itself). For all other object types, this column is - zero. + zero @@ -2186,7 +2177,7 @@ For a table column, this is the column number (the refobjid and refclassid refer to the table itself). For all other object types, this column - is zero. + is zero @@ -2287,7 +2278,7 @@ The catalog pg_description stores optional descriptions (comments) for each database object. Descriptions can be manipulated - with the COMMENT command and viewed with + with the command and viewed with psql's \d commands. Descriptions of many built-in system objects are provided in the initial contents of pg_description. @@ -2335,7 +2326,7 @@ For a comment on a table column, this is the column number (the objoid and classoid refer to the table itself). For all other object types, this column is - zero. + zero @@ -2427,11 +2418,13 @@ indisvalid bool - If true, the index is currently valid for queries. - False means the index is possibly incomplete: it must still be - inserted into by INSERT/UPDATE operations, but it cannot safely be - used for queries, and if it is unique, the uniqueness shouldn't be - relied on either. + + If true, the index is currently valid for queries. False means the + index is possibly incomplete: it must still be modified by + INSERT/UPDATE operations, but it cannot safely + be used for queries. If it is unique, the uniqueness property is not + true either + @@ -2455,7 +2448,7 @@ For each column in the index key this contains the OID of the operator class to use. See - pg_opclass for details. + pg_opclass for details @@ -2466,7 +2459,7 @@ Expression trees (in nodeToString() representation) for index attributes that are not simple column references. This is a list with one element for each zero entry in indkey. - NULL if all index attributes are simple references. + NULL if all index attributes are simple references @@ -2474,7 +2467,7 @@ text Expression tree (in nodeToString() representation) - for partial index predicate. NULL if not a partial index. + for partial index predicate. NULL if not a partial index @@ -2536,7 +2529,7 @@ If there is more than one direct parent for a child table (multiple inheritance), this number tells the order in which the - inherited columns are to be arranged. The count starts at 1. + inherited columns are to be arranged. The count starts at 1 @@ -2590,7 +2583,7 @@ SQL) and true for user-defined languages. Currently, pg_dump still uses this to determine which languages need to be dumped, but this may be - replaced by a different mechanism sometime. + replaced by a different mechanism in the future @@ -2602,7 +2595,7 @@ True if this is a trusted language, which means that it is believed not to grant access to anything outside the normal SQL execution environment. Only superusers may create functions in untrusted - languages. + languages @@ -2614,7 +2607,7 @@ For noninternal languages this references the language handler, which is a special function that is responsible for executing all functions that are written in the particular - language. + language @@ -2625,7 +2618,7 @@ This references a language validator function that is responsible for checking the syntax and validity of new functions when they - are created. Zero if no validator is provided. + are created. Zero if no validator is provided @@ -2660,7 +2653,7 @@ OID assigned when it is created. Each large object is broken into segments or pages small enough to be conveniently stored as rows in pg_largeobject. - The amount of data per page is defined to be LOBLKSIZE (which is currently + The amount of data per page is defined to be LOBLKSIZE (which is currently BLCKSZ/4, or typically 2 kB). @@ -2672,7 +2665,6 @@ Name Type - References Description @@ -2681,14 +2673,12 @@ loid oid - Identifier of the large object that includes this page pageno int4 - Page number of this page within its large object (counting from zero) @@ -2696,10 +2686,9 @@ data bytea - Actual data stored in the large object. - This will never be more than LOBLKSIZE bytes and may be less. + This will never be more than LOBLKSIZE bytes and may be less @@ -2754,26 +2743,24 @@ relname name - - Notify condition name. (The name need not match any actual - relation in the database; the name relname is historical.) + + Notify condition name. (The name need not match any actual + relation in the database; the name relname is historical.) listenerpid int4 - PID of the server process that created this entry notification int4 - Zero if no event is pending for this listener. If an event is - pending, the PID of the server process that sent the notification. + pending, the PID of the server process that sent the notification @@ -3149,7 +3136,6 @@ Name Type - References Description @@ -3158,42 +3144,36 @@ tmplname name - Name of the language this template is for tmpltrusted boolean - True if language is considered trusted tmplhandler text - Name of call handler function tmplvalidator text - Name of validator function, or NULL if none tmpllibrary text - Path of shared library that implements language tmplacl aclitem[] - Access privileges for template (not yet used) @@ -3305,7 +3285,7 @@ Function returns null if any call argument is null. In that case the function won't actually be called at all. Functions that are not strict must be prepared to handle - null inputs. + null inputs @@ -3357,7 +3337,7 @@ An array with the data types of the function arguments. This includes only input arguments (including INOUT arguments), and thus represents - the call signature of the function. + the call signature of the function @@ -3370,7 +3350,7 @@ all arguments (including OUT and INOUT arguments); however, if all the arguments are IN arguments, this field will be null. Note that subscripting is 1-based, whereas for historical reasons - proargtypes is subscripted from 0. + proargtypes is subscripted from 0 @@ -3385,7 +3365,7 @@ b for INOUT arguments. If all the arguments are IN arguments, this field will be null. Note that subscripts correspond to positions of - proallargtypes not proargtypes. + proallargtypes not proargtypes @@ -3398,7 +3378,7 @@ Arguments without a name are set to empty strings in the array. If none of the arguments have a name, this field will be null. Note that subscripts correspond to positions of - proallargtypes not proargtypes. + proallargtypes not proargtypes @@ -3410,7 +3390,7 @@ This tells the function handler how to invoke the function. It might be the actual source code of the function for interpreted languages, a link symbol, a file name, or just about anything - else, depending on the implementation language/call convention. + else, depending on the implementation language/call convention @@ -3418,8 +3398,9 @@ probin bytea - Additional information about how to invoke the function. - Again, the interpretation is language-specific. + + Additional information about how to invoke the function. + Again, the interpretation is language-specific @@ -3701,9 +3682,10 @@ The catalog pg_shdescription stores optional - descriptions (comments) for shared database objects. Descriptions can - be manipulated with the COMMENT command and viewed - with psql's \d commands. + descriptions (comments) for shared database objects. Descriptions can be + manipulated with the command and viewed with + psql's \d commands. @@ -3751,7 +3733,7 @@ description text - Arbitrary text that servers as the description of this object. + Arbitrary text that serves as the description of this object @@ -3859,7 +3841,7 @@ A value less than zero is the negative of a fraction of the number of rows in the table (for example, a column in which values appear about twice on the average could be represented by stadistinct = -0.5). - A zero value means the number of distinct values is unknown. + A zero value means the number of distinct values is unknown @@ -3870,7 +3852,7 @@ A code number indicating the kind of statistics stored in the Nth slot of the - pg_statistic row. + pg_statistic row @@ -3882,7 +3864,7 @@ An operator used to derive the statistics stored in the Nth slot. For example, a histogram slot would show the < operator - that defines the sort order of the data. + that defines the sort order of the data @@ -3907,7 +3889,7 @@ kind does not store any data values. Each array's element values are actually of the specific column's data type, so there is no way to define these columns' type more specifically than - anyarray. + anyarray @@ -4201,7 +4183,7 @@ Variable-length types are always passed by reference. Note that typbyval can be false even if the length would allow pass-by-value; this is currently true for - type float4, for example. + type float4, for example @@ -4215,7 +4197,7 @@ table's row type), d for a domain, or p for a pseudo-type. See also typrelid and - typbasetype. + typbasetype @@ -4227,7 +4209,7 @@ True if the type is defined, false if this is a placeholder entry for a not-yet-defined type. When typisdefined is false, nothing - except the type name, namespace, and OID can be relied on. + except the type name, namespace, and OID can be relied on @@ -4235,9 +4217,11 @@ typdelim char - Character that separates two values of this type when parsing - array input. Note that the delimiter is associated with the array - element data type, not the array data type. + + Character that separates two values of this type when parsing + array input. Note that the delimiter is associated with the array + element data type, not the array data type + @@ -4252,7 +4236,7 @@ pg_class entry doesn't really represent a table, but it is needed anyway for the type's pg_attribute entries to link to.) - Zero for non-composite types. + Zero for non-composite types @@ -4274,7 +4258,7 @@ its internal representation must be some number of values of the typelem data type with no other data. Variable-length array types have a header defined by the array - subroutines. + subroutines @@ -4394,7 +4378,7 @@ typnotnull represents a not-null - constraint on a type. Used for domains only. + constraint on a type. Used for domains only @@ -4403,9 +4387,9 @@ oid pg_type.oid - If this is a domain (see typtype), - then typbasetype identifies - the type that this one is based on. Zero if not a domain. + If this is a domain (see typtype), then + typbasetype identifies the type that this + one is based on. Zero if this type is not a domain @@ -4416,7 +4400,7 @@ Domains use typtypmod to record the typmod to be applied to their base type (-1 if base type does not use a - typmod). -1 if this type is not a domain. + typmod). -1 if this type is not a domain @@ -4428,7 +4412,7 @@ typndims is the number of array dimensions for a domain that is an array (that is, typbasetype is an array type; the domain's typelem will match the base type's typelem). - Zero for types other than array domains. + Zero for types other than array domains @@ -4439,7 +4423,7 @@ If typdefaultbin is not null, it is the nodeToString() representation of a default expression for the type. This is - only used for domains. + only used for domains @@ -4455,7 +4439,7 @@ typdefaultbin is null and typdefault is not, then typdefault is the external representation of the type's default value, which may be fed to the type's input - converter to produce a constant. + converter to produce a constant @@ -4649,7 +4633,6 @@ Name Type - References Description @@ -4658,21 +4641,18 @@ name text - The name of the cursor statement text - The verbatim query string submitted to declare this cursor is_holdable boolean - true if the cursor is holdable (that is, it can be accessed after the transaction that declared the cursor @@ -4683,7 +4663,6 @@ is_binary boolean - true if the cursor was declared BINARY; false @@ -4694,7 +4673,6 @@ is_scrollable boolean - true if the cursor is scrollable (that is, it allows rows to be retrieved in a nonsequential manner); @@ -4705,7 +4683,6 @@ creation_time timestamptz - The time at which the cursor was declared @@ -4803,31 +4780,32 @@ schemaname name pg_namespace.nspname - name of schema containing table and index + Name of schema containing table and index tablename name pg_class.relname - name of table the index is for + Name of table the index is for indexname name pg_class.relname - name of index + Name of index tablespace name pg_tablespace.spcname - name of tablespace containing index (NULL if default for database) + Name of tablespace containing index (NULL if default for database) indexdef text - index definition (a reconstructed creation command) + Index definition (a reconstructed CREATE INDEX + command) @@ -4922,7 +4900,7 @@ integer - page number within the relation, or NULL if the object + Page number within the relation, or NULL if the object is not a tuple or relation page @@ -4931,7 +4909,7 @@ smallint - tuple number within the page, or NULL if the object is not a tuple + Tuple number within the page, or NULL if the object is not a tuple @@ -4985,21 +4963,21 @@ Process ID of the server process holding or awaiting this - lock. NULL if the lock is held by a prepared transaction. + lock. NULL if the lock is held by a prepared transaction mode text - name of the lock mode held or desired by this process (see Name of the lock mode held or desired by this process (see ) granted boolean - true if lock is held, false if lock is awaited + True if lock is held, false if lock is awaited @@ -5051,7 +5029,7 @@ view produces a consistent set of results, while not blocking normal lock manager operations longer than necessary. Nonetheless there could be some impact on database performance if this view is - read often. + frequently accessed. @@ -5112,7 +5090,6 @@ Name Type - References Description @@ -5120,7 +5097,6 @@ name text - The identifier of the prepared statement @@ -5128,20 +5104,18 @@ statement text - The query string submitted by the client to create this prepared statement. For prepared statements created via SQL, this is the PREPARE statement submitted by the client. For prepared statements created via the frontend/backend protocol, this is the text of the prepared - statement itself. + statement itself prepare_time timestamptz - The time at which the prepared statement was created @@ -5149,18 +5123,16 @@ parameter_types regtype[] - The expected parameter types for the prepared statement in the form of an array of regtype. The OID corresponding to an element of this array can be obtained by casting the - regtype value to oid. + regtype value to oid from_sql boolean - true if the prepared statement was created via the PREPARE SQL statement; @@ -5261,7 +5233,7 @@ view produces a consistent set of results, while not blocking normal operations longer than necessary. Nonetheless there could be some impact on database performance if this view is - read often. + frequently accessed. @@ -5351,8 +5323,8 @@ bool - Role may log in, that is, this role can be given as the initial - session authorization identifier. + Role may log in. That is, this role can be given as the initial + session authorization identifier @@ -5362,7 +5334,7 @@ For roles that can log in, this sets maximum number of concurrent - connections this role can make. -1 means no limit. + connections this role can make. -1 means no limit @@ -5429,33 +5401,33 @@ schemaname name pg_namespace.nspname - name of schema containing table + Name of schema containing table tablename name pg_class.relname - name of table the rule is for + Name of table the rule is for rulename name pg_rewrite.rulename - name of rule + Name of rule definition text - rule definition (a reconstructed creation command) + Rule definition (a reconstructed creation command)
- The pg_rules view excludes the ON SELECT rules of - views; those can be seen in pg_views. + The pg_rules view excludes the ON SELECT rules + of views; those can be seen in pg_views. @@ -5484,7 +5456,6 @@ Name Type - References Description @@ -5492,71 +5463,60 @@ name text - - run-time configuration parameter name + Run-time configuration parameter name setting text - - current value of the parameter + Current value of the parameter unit text - - implicit unit of the parameter + Implicit unit of the parameter category text - - logical group of the parameter + Logical group of the parameter short_desc text - - a brief description of the parameter + A brief description of the parameter extra_desc text - - additional, more detailed, information about the parameter + Additional, more detailed, information about the parameter context text - - context required to set the parameter's value + Context required to set the parameter's value vartype text - - parameter type (bool, integer, + Parameter type (bool, integer, real, or string) source text - - source of the current parameter value + Source of the current parameter value min_val text - - minimum allowed value of the parameter (NULL for nonnumeric + Minimum allowed value of the parameter (NULL for non-numeric values) max_val text - - maximum allowed value of the parameter (NULL for nonnumeric + Maximum allowed value of the parameter (NULL for non-numeric values) @@ -5567,7 +5527,7 @@ The pg_settings view cannot be inserted into or deleted from, but it can be updated. An UPDATE applied to a row of pg_settings is equivalent to executing - the command on that named + the command on that named parameter. The change only affects the value used by the current session. If an UPDATE is issued within a transaction that is later aborted, the effects of the UPDATE command @@ -5721,50 +5681,50 @@ schemaname name pg_namespace.nspname - name of schema containing table + Name of schema containing table tablename name pg_class.relname - name of table + Name of table attname name pg_attribute.attname - name of the column described by this row + Name of the column described by this row null_frac real - fraction of column entries that are null + Fraction of column entries that are null avg_width integer - average width in bytes of column's entries + Average width in bytes of column's entries n_distinct real - If greater than zero, the estimated number of distinct values - in the column. If less than zero, the negative of the number of - distinct values divided by the number of rows. (The negated form - is used when ANALYZE believes that the number of distinct - values - is likely to increase as the table grows; the positive form is used - when the column seems to have a fixed number of possible values.) - For example, -1 indicates a unique column in which the number of - distinct values is the same as the number of rows. + + If greater than zero, the estimated number of distinct values in the + column. If less than zero, the negative of the number of distinct + values divided by the number of rows. (The negated form is used when + ANALYZE believes that the number of distinct values is + likely to increase as the table grows; the positive form is used when + the column seems to have a fixed number of possible values.) For + example, -1 indicates a unique column in which the number of distinct + values is the same as the number of rows @@ -5772,17 +5732,20 @@ most_common_vals anyarray - A list of the most common values in the column. (NULL if - no values seem to be more common than any others.) + + A list of the most common values in the column. (NULL if + no values seem to be more common than any others.) + most_common_freqs real[] - A list of the frequencies of the most common values, - i.e., number of occurrences of each divided by total number of rows. - (NULL when most_common_vals is.) + + A list of the frequencies of the most common values, + i.e., number of occurrences of each divided by total number of rows. + (NULL when most_common_vals is.) @@ -5790,13 +5753,14 @@ histogram_bounds anyarray - A list of values that divide the column's values into - groups of approximately equal population. The values in - most_common_vals, if present, are omitted from this - histogram calculation. (This column is NULL if the column data type - does not have a < operator or if the - most_common_vals list accounts for the entire - population.) + + A list of values that divide the column's values into groups of + approximately equal population. The values in + most_common_vals, if present, are omitted from this + histogram calculation. (This column is NULL if the column data type + does not have a < operator or if the + most_common_vals list accounts for the entire + population.) @@ -5804,12 +5768,13 @@ correlation real - Statistical correlation between physical row ordering and - logical ordering of the column values. This ranges from -1 to +1. - When the value is near -1 or +1, an index scan on the column will - be estimated to be cheaper than when it is near zero, due to reduction - of random access to the disk. (This column is NULL if the column data - type does not have a < operator.) + + Statistical correlation between physical row ordering and + logical ordering of the column values. This ranges from -1 to +1. + When the value is near -1 or +1, an index scan on the column will + be estimated to be cheaper than when it is near zero, due to reduction + of random access to the disk. (This column is NULL if the column data + type does not have a < operator.) @@ -5855,25 +5820,25 @@ schemaname name pg_namespace.nspname - name of schema containing table + Name of schema containing table tablename name pg_class.relname - name of table + Name of table tableowner name pg_authid.rolname - name of table's owner + Name of table's owner tablespace name pg_tablespace.spcname - name of tablespace containing table (NULL if default for database) + Name of tablespace containing table (NULL if default for database) hasindexes @@ -5928,17 +5893,17 @@ abbrev text - time zone abbreviation + Time zone abbreviation utc_offset interval - offset from UTC (positive means east of Greenwich) + Offset from UTC (positive means east of Greenwich) is_dst boolean - true if this is a daylight-savings abbreviation + True if this is a daylight-savings abbreviation @@ -5980,22 +5945,22 @@ name text - time zone name + Time zone name abbrev text - time zone abbreviation + Time zone abbreviation utc_offset interval - offset from UTC (positive means east of Greenwich) + Offset from UTC (positive means east of Greenwich) is_dst boolean - true if currently observing daylight savings + True if currently observing daylight savings @@ -6026,7 +5991,6 @@ Name Type - References Description @@ -6034,35 +5998,30 @@ usename name - User name usesysid int4 - User ID (arbitrary number used to reference this user) usecreatedb bool - User may create databases usesuper bool - User is a superuser usecatupd bool - User may update system catalogs. (Even a superuser may not do this unless this column is true.) @@ -6072,21 +6031,18 @@ passwd text - Not the password (always reads as ********) valuntil abstime - Password expiry time (only used for password authentication) useconfig text[] - Session defaults for run-time configuration variables @@ -6124,25 +6080,25 @@ schemaname name pg_namespace.nspname - name of schema containing view + Name of schema containing view viewname name pg_class.relname - name of view + Name of view viewowner name pg_authid.rolname - name of view's owner + Name of view's owner definition text - view definition (a reconstructed SELECT query) + View definition (a reconstructed SELECT query)