diff --git a/doc/src/sgml/glossary.sgml b/doc/src/sgml/glossary.sgml index fe8def41d0..5f077c70e0 100644 --- a/doc/src/sgml/glossary.sgml +++ b/doc/src/sgml/glossary.sgml @@ -52,12 +52,12 @@ tables and other relations to help the query planner - to make decisions about how to execute + make decisions about how to execute queries. (Don't confuse this term with the ANALYZE option - to the command.) + of the command.) For more information, see @@ -175,7 +175,7 @@ Process within an instance, - which runs system- or user-supplied code. + which runs system or user-supplied code. Serves as infrastructure for several features in PostgreSQL, such as logical replication @@ -227,7 +227,7 @@ Bloat - Space in data pages which does not contain current row versions, + Space in data pages that does not contain current row versions, such as unused (free) space or outdated row versions. @@ -256,9 +256,9 @@ Buffer Access Strategy - Some operations will access a large number of + Some operations access a large number of pages. A - Buffer Access Strategy helps to prevent these + Buffer Access Strategy helps prevent these operations from evicting too many pages from shared buffers. @@ -320,7 +320,7 @@ A type of constraint defined on a relation - which restricts the values allowed in one or more + that restricts the values allowed in one or more attributes. The check constraint can make reference to any attribute of the same row in the relation, but cannot reference other rows of the same relation or @@ -350,7 +350,7 @@ are necessary to reach a checkpoint as defined above. This process is initiated when predefined conditions are met, such as a specified amount of time has passed, or a certain volume - of records has been written; or it can be invoked by the user + of records were written; or it can be invoked by the user with the command CHECKPOINT. @@ -396,12 +396,11 @@ The operating system user that owns the data directory and under which the postgres process is run. - It is required that this user exist prior to creating a new + This user is required to exist prior to creating a new database cluster. - On operating systems with a root user, - said user is not allowed to be the cluster owner. + The user root is not allowed to be the cluster owner. @@ -424,7 +423,7 @@ The act of finalizing a transaction within the database, which - makes it visible to other transactions and assures its + makes it visible to other transactions and ensures its durability. @@ -468,13 +467,13 @@ Consistency - The property that the data in the + The property that data in the database - is always in compliance with + is always compliant with integrity constraints. - Transactions may be allowed to violate some of the constraints - transiently before it commits, but if such violations are not resolved - by the time it commits, such a transaction is automatically + Transactions may allow constraints to be violated + temporarily, but violations must be resolved before the transaction + commits or it will be automatically rolled back. This is one of the ACID properties. @@ -549,7 +548,7 @@ See also cluster owner, - the operating-system owner of a cluster, + the operating system owner of a cluster, and bootstrap superuser, the PostgreSQL owner of a cluster. @@ -619,7 +618,7 @@ Datum - The internal representation of one value of an SQL + The internal representation of one value of a SQL data type. @@ -629,7 +628,7 @@ Delete - An SQL command which removes + A SQL command that removes rows from a given table or relation. @@ -692,7 +691,7 @@ File segment - A physical file which stores data for a given + A physical file that stores data for a given relation. File segments are limited in size by a configuration value (typically 1 gigabyte), @@ -785,7 +784,7 @@ Each of the separate segmented file sets in which a relation is stored. The main fork is where the actual data resides. - There also exist two secondary forks for metadata: + There are two secondary forks for metadata: the free space map and the visibility map. Unlogged relations @@ -838,7 +837,7 @@ Grant - An SQL command that is used to allow a + A SQL command that is used to allow a user or role to access specific objects within the database. @@ -898,7 +897,7 @@ Insert - An SQL command used to add new data into a + A SQL command used to add new data into a table. @@ -1385,7 +1384,7 @@ A relation transmitted from a backend process to a client upon the - completion of an SQL command, usually a + completion of a SQL command, usually a SELECT but it can be an INSERT, UPDATE, or DELETE command if the RETURNING @@ -1867,8 +1866,8 @@ Trigger - A function which can - be defined to execute whenever a certain operation (INSERT, + A function that + executes whenever a certain operation (INSERT, UPDATE, DELETE, TRUNCATE) is applied to a relation. @@ -1942,7 +1941,7 @@ Update - An SQL command used to modify + A SQL command used to modify rows that may already exist in a specified table. It cannot create or remove rows.