mirror of
https://github.com/postgres/postgres.git
synced 2025-06-01 00:01:20 -04:00
Fix collection of typos and grammar mistakes in the tree, volume 2
This fixes some comments and documentation new as of Postgres 13, and is a follow-up of the work done in dd0f37e. Author: Justin Pryzby Discussion: https://postgr.es/m/20200408165653.GF2228@telsasoft.com
This commit is contained in:
parent
f762b2feba
commit
8128b0c152
@ -200,7 +200,7 @@ LOAD 'auto_explain';
|
|||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
<varname>auto_explain.log_settings</varname> controls whether information
|
<varname>auto_explain.log_settings</varname> controls whether information
|
||||||
about modified configuration options are printed when execution plan is logged.
|
about modified configuration options is printed when execution plan is logged.
|
||||||
Only options affecting query planning with value different from the built-in
|
Only options affecting query planning with value different from the built-in
|
||||||
default value are included in the output. This parameter is off by default.
|
default value are included in the output. This parameter is off by default.
|
||||||
Only superusers can change this setting.
|
Only superusers can change this setting.
|
||||||
|
@ -2596,14 +2596,14 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
|
|||||||
<row>
|
<row>
|
||||||
<entry><structfield>datname</structfield></entry>
|
<entry><structfield>datname</structfield></entry>
|
||||||
<entry><type>name</type></entry>
|
<entry><type>name</type></entry>
|
||||||
<entry>Name of this database, or <literal>NULL</literal> for the shared
|
<entry>Name of this database, or <literal>NULL</literal> for shared
|
||||||
objects.</entry>
|
objects.</entry>
|
||||||
</row>
|
</row>
|
||||||
<row>
|
<row>
|
||||||
<entry><structfield>numbackends</structfield></entry>
|
<entry><structfield>numbackends</structfield></entry>
|
||||||
<entry><type>integer</type></entry>
|
<entry><type>integer</type></entry>
|
||||||
<entry>Number of backends currently connected to this database, or
|
<entry>Number of backends currently connected to this database, or
|
||||||
<literal>NULL</literal> for the shared objects. This is the only column
|
<literal>NULL</literal> for shared objects. This is the only column
|
||||||
in this view that returns a value reflecting current state; all other
|
in this view that returns a value reflecting current state; all other
|
||||||
columns return the accumulated values since the last reset.</entry>
|
columns return the accumulated values since the last reset.</entry>
|
||||||
</row>
|
</row>
|
||||||
@ -2725,7 +2725,7 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
|
|||||||
|
|
||||||
<para>
|
<para>
|
||||||
The <structname>pg_stat_database</structname> view will contain one row
|
The <structname>pg_stat_database</structname> view will contain one row
|
||||||
for each database in the cluster, plus one for the shared objects, showing
|
for each database in the cluster, plus one for shared objects, showing
|
||||||
database-wide statistics.
|
database-wide statistics.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
@ -4483,7 +4483,7 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
|
|||||||
is taking a base backup, the
|
is taking a base backup, the
|
||||||
<structname>pg_stat_progress_basebackup</structname>
|
<structname>pg_stat_progress_basebackup</structname>
|
||||||
view will contain a row for each WAL sender process that is currently
|
view will contain a row for each WAL sender process that is currently
|
||||||
running <command>BASE_BACKUP</command> replication command
|
running the <command>BASE_BACKUP</command> replication command
|
||||||
and streaming the backup. The tables below describe the information
|
and streaming the backup. The tables below describe the information
|
||||||
that will be reported and provide information about how to interpret it.
|
that will be reported and provide information about how to interpret it.
|
||||||
</para>
|
</para>
|
||||||
|
@ -311,7 +311,7 @@ EXPLAIN SELECT * FROM tenk1 ORDER BY unique1;
|
|||||||
-> Seq Scan on tenk1 (cost=0.00..445.00 rows=10000 width=244)
|
-> Seq Scan on tenk1 (cost=0.00..445.00 rows=10000 width=244)
|
||||||
</screen>
|
</screen>
|
||||||
|
|
||||||
If the a part of the plan guarantess an ordering on a prefix of the
|
If a part of the plan guarantees an ordering on a prefix of the
|
||||||
required sort keys, then the planner may instead decide to use an
|
required sort keys, then the planner may instead decide to use an
|
||||||
<literal>incremental sort</literal> step:
|
<literal>incremental sort</literal> step:
|
||||||
|
|
||||||
|
@ -132,7 +132,7 @@ CREATE PUBLICATION <replaceable class="parameter">name</replaceable>
|
|||||||
on its partitions) contained in the publication will be published
|
on its partitions) contained in the publication will be published
|
||||||
using the identity and schema of the partitioned table rather than
|
using the identity and schema of the partitioned table rather than
|
||||||
that of the individual partitions that are actually changed; the
|
that of the individual partitions that are actually changed; the
|
||||||
latter is the default. Enablings this allows the changes to be
|
latter is the default. Enabling this allows the changes to be
|
||||||
replicated into a non-partitioned table or a partitioned table
|
replicated into a non-partitioned table or a partitioned table
|
||||||
consisting of a different set of partitions.
|
consisting of a different set of partitions.
|
||||||
</para>
|
</para>
|
||||||
|
@ -41,7 +41,7 @@ PostgreSQL documentation
|
|||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
It is important to note that that the validation which is performed by
|
It is important to note that the validation which is performed by
|
||||||
<application>pg_verifybackup</application> does not and can not include
|
<application>pg_verifybackup</application> does not and can not include
|
||||||
every check which will be performed by a running server when attempting
|
every check which will be performed by a running server when attempting
|
||||||
to make use of the backup. Even if you use this tool, you should still
|
to make use of the backup. Even if you use this tool, you should still
|
||||||
|
@ -1242,9 +1242,9 @@ testdb=>
|
|||||||
<para>
|
<para>
|
||||||
Lists operator classes
|
Lists operator classes
|
||||||
(see <xref linkend="catalog-pg-opclass"/>).
|
(see <xref linkend="catalog-pg-opclass"/>).
|
||||||
If <replaceable class="parameter">access-method-patttern</replaceable>
|
If <replaceable class="parameter">access-method-pattern</replaceable>
|
||||||
is specified, only operator classes associated with access methods whose
|
is specified, only operator classes associated with access methods whose
|
||||||
names match pattern are listed.
|
names match the pattern are listed.
|
||||||
If <replaceable class="parameter">input-type-pattern</replaceable>
|
If <replaceable class="parameter">input-type-pattern</replaceable>
|
||||||
is specified, only operator classes associated with input types whose
|
is specified, only operator classes associated with input types whose
|
||||||
names match the pattern are listed.
|
names match the pattern are listed.
|
||||||
@ -1265,9 +1265,9 @@ testdb=>
|
|||||||
<para>
|
<para>
|
||||||
Lists operator families
|
Lists operator families
|
||||||
(see <xref linkend="catalog-pg-opfamily"/>).
|
(see <xref linkend="catalog-pg-opfamily"/>).
|
||||||
If <replaceable class="parameter">access-method-patttern</replaceable>
|
If <replaceable class="parameter">access-method-pattern</replaceable>
|
||||||
is specified, only operator families associated with access methods whose
|
is specified, only operator families associated with access methods whose
|
||||||
names match pattern are listed.
|
names match the pattern are listed.
|
||||||
If <replaceable class="parameter">input-type-pattern</replaceable>
|
If <replaceable class="parameter">input-type-pattern</replaceable>
|
||||||
is specified, only operator families associated with input types whose
|
is specified, only operator families associated with input types whose
|
||||||
names match the pattern are listed.
|
names match the pattern are listed.
|
||||||
@ -1289,9 +1289,9 @@ testdb=>
|
|||||||
<para>
|
<para>
|
||||||
Lists operators associated with operator families
|
Lists operators associated with operator families
|
||||||
(<xref linkend="catalog-pg-amop"/>).
|
(<xref linkend="catalog-pg-amop"/>).
|
||||||
If <replaceable class="parameter">access-method-patttern</replaceable>
|
If <replaceable class="parameter">access-method-pattern</replaceable>
|
||||||
is specified, only members of operator families associated with access
|
is specified, only members of operator families associated with access
|
||||||
methods whose names match pattern are listed.
|
methods whose names match the pattern are listed.
|
||||||
If <replaceable class="parameter">input-type-pattern</replaceable>
|
If <replaceable class="parameter">input-type-pattern</replaceable>
|
||||||
is specified, only members of operator families whose names match the
|
is specified, only members of operator families whose names match the
|
||||||
pattern are listed.
|
pattern are listed.
|
||||||
@ -1312,9 +1312,9 @@ testdb=>
|
|||||||
<para>
|
<para>
|
||||||
Lists procedures associated with operator families
|
Lists procedures associated with operator families
|
||||||
(<xref linkend="catalog-pg-amproc"/>).
|
(<xref linkend="catalog-pg-amproc"/>).
|
||||||
If <replaceable class="parameter">access-method-patttern</replaceable>
|
If <replaceable class="parameter">access-method-pattern</replaceable>
|
||||||
is specified, only members of operator families associated with access
|
is specified, only members of operator families associated with access
|
||||||
methods whose names match pattern are listed.
|
methods whose names match the pattern are listed.
|
||||||
If <replaceable class="parameter">input-type-pattern</replaceable>
|
If <replaceable class="parameter">input-type-pattern</replaceable>
|
||||||
is specified, only members of operator families whose names match the
|
is specified, only members of operator families whose names match the
|
||||||
pattern are listed.
|
pattern are listed.
|
||||||
|
@ -1450,7 +1450,7 @@ FETCH { FIRST | NEXT } [ <replaceable class="parameter">count</replaceable> ] {
|
|||||||
omitted in a <literal>FETCH</literal> clause, it defaults to 1.
|
omitted in a <literal>FETCH</literal> clause, it defaults to 1.
|
||||||
The <literal>WITH TIES</literal> option is used to return any additional
|
The <literal>WITH TIES</literal> option is used to return any additional
|
||||||
rows that tie for the last place in the result set according to
|
rows that tie for the last place in the result set according to
|
||||||
<literal>ORDER BY</literal> clause; <literal>ORDER BY</literal>
|
the <literal>ORDER BY</literal> clause; <literal>ORDER BY</literal>
|
||||||
is mandatory in this case.
|
is mandatory in this case.
|
||||||
<literal>ROW</literal> and <literal>ROWS</literal> as well as
|
<literal>ROW</literal> and <literal>ROWS</literal> as well as
|
||||||
<literal>FIRST</literal> and <literal>NEXT</literal> are noise
|
<literal>FIRST</literal> and <literal>NEXT</literal> are noise
|
||||||
|
@ -270,7 +270,7 @@ isCurrentGroup(IncrementalSortState *node, TupleTableSlot *pivot, TupleTableSlot
|
|||||||
* verify they're all part of the same prefix key group before sorting them
|
* verify they're all part of the same prefix key group before sorting them
|
||||||
* solely by unsorted suffix keys.
|
* solely by unsorted suffix keys.
|
||||||
*
|
*
|
||||||
* While it's likely that all already fetch tuples are all part of a single
|
* While it's likely that all tuples already fetched are all part of a single
|
||||||
* prefix group, we also have to handle the possibility that there is at least
|
* prefix group, we also have to handle the possibility that there is at least
|
||||||
* one different prefix key group before the large prefix key group.
|
* one different prefix key group before the large prefix key group.
|
||||||
* ----------------------------------------------------------------
|
* ----------------------------------------------------------------
|
||||||
@ -381,7 +381,7 @@ switchToPresortedPrefixMode(PlanState *pstate)
|
|||||||
* node->transfer_tuple slot, and, even though that slot
|
* node->transfer_tuple slot, and, even though that slot
|
||||||
* points to memory inside the full sort tuplesort, we can't
|
* points to memory inside the full sort tuplesort, we can't
|
||||||
* reset that tuplesort anyway until we've fully transferred
|
* reset that tuplesort anyway until we've fully transferred
|
||||||
* out of its tuples, so this reference is safe. We do need to
|
* out its tuples, so this reference is safe. We do need to
|
||||||
* reset the group pivot tuple though since we've finished the
|
* reset the group pivot tuple though since we've finished the
|
||||||
* current prefix key group.
|
* current prefix key group.
|
||||||
*/
|
*/
|
||||||
@ -603,7 +603,7 @@ ExecIncrementalSort(PlanState *pstate)
|
|||||||
/*
|
/*
|
||||||
* Initialize presorted column support structures for
|
* Initialize presorted column support structures for
|
||||||
* isCurrentGroup(). It's correct to do this along with the
|
* isCurrentGroup(). It's correct to do this along with the
|
||||||
* initial intialization for the full sort state (and not for the
|
* initial initialization for the full sort state (and not for the
|
||||||
* prefix sort state) since we always load the full sort state
|
* prefix sort state) since we always load the full sort state
|
||||||
* first.
|
* first.
|
||||||
*/
|
*/
|
||||||
@ -723,7 +723,7 @@ ExecIncrementalSort(PlanState *pstate)
|
|||||||
nTuples++;
|
nTuples++;
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* If we've reach our minimum group size, then we need to
|
* If we've reached our minimum group size, then we need to
|
||||||
* store the most recent tuple as a pivot.
|
* store the most recent tuple as a pivot.
|
||||||
*/
|
*/
|
||||||
if (nTuples == minGroupSize)
|
if (nTuples == minGroupSize)
|
||||||
@ -752,7 +752,7 @@ ExecIncrementalSort(PlanState *pstate)
|
|||||||
{
|
{
|
||||||
/*
|
/*
|
||||||
* Since the tuple we fetched isn't part of the current
|
* Since the tuple we fetched isn't part of the current
|
||||||
* prefix key group we don't want to sort it as part of
|
* prefix key group we don't want to sort it as part of
|
||||||
* the current batch. Instead we use the group_pivot slot
|
* the current batch. Instead we use the group_pivot slot
|
||||||
* to carry it over to the next batch (even though we
|
* to carry it over to the next batch (even though we
|
||||||
* won't actually treat it as a group pivot).
|
* won't actually treat it as a group pivot).
|
||||||
@ -792,12 +792,12 @@ ExecIncrementalSort(PlanState *pstate)
|
|||||||
}
|
}
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Unless we've alrady transitioned modes to reading from the full
|
* Unless we've already transitioned modes to reading from the full
|
||||||
* sort state, then we assume that having read at least
|
* sort state, then we assume that having read at least
|
||||||
* DEFAULT_MAX_FULL_SORT_GROUP_SIZE tuples means it's likely we're
|
* DEFAULT_MAX_FULL_SORT_GROUP_SIZE tuples means it's likely we're
|
||||||
* processing a large group of tuples all having equal prefix keys
|
* processing a large group of tuples all having equal prefix keys
|
||||||
* (but haven't yet found the final tuple in that prefix key
|
* (but haven't yet found the final tuple in that prefix key
|
||||||
* group), so we need to transition in to presorted prefix mode.
|
* group), so we need to transition into presorted prefix mode.
|
||||||
*/
|
*/
|
||||||
if (nTuples > DEFAULT_MAX_FULL_SORT_GROUP_SIZE &&
|
if (nTuples > DEFAULT_MAX_FULL_SORT_GROUP_SIZE &&
|
||||||
node->execution_status != INCSORT_READFULLSORT)
|
node->execution_status != INCSORT_READFULLSORT)
|
||||||
@ -849,7 +849,7 @@ ExecIncrementalSort(PlanState *pstate)
|
|||||||
|
|
||||||
/*
|
/*
|
||||||
* We might have multiple prefix key groups in the full sort
|
* We might have multiple prefix key groups in the full sort
|
||||||
* state, so the mode transition function needs to know the it
|
* state, so the mode transition function needs to know that it
|
||||||
* needs to move from the fullsort to presorted prefix sort.
|
* needs to move from the fullsort to presorted prefix sort.
|
||||||
*/
|
*/
|
||||||
node->n_fullsort_remaining = nTuples;
|
node->n_fullsort_remaining = nTuples;
|
||||||
@ -913,7 +913,7 @@ ExecIncrementalSort(PlanState *pstate)
|
|||||||
/*
|
/*
|
||||||
* If the tuple's prefix keys match our pivot tuple, we're not
|
* If the tuple's prefix keys match our pivot tuple, we're not
|
||||||
* done yet and can load it into the prefix sort state. If not, we
|
* done yet and can load it into the prefix sort state. If not, we
|
||||||
* don't want to sort it as part of the current batch. Instead we
|
* don't want to sort it as part of the current batch. Instead we
|
||||||
* use the group_pivot slot to carry it over to the next batch
|
* use the group_pivot slot to carry it over to the next batch
|
||||||
* (even though we won't actually treat it as a group pivot).
|
* (even though we won't actually treat it as a group pivot).
|
||||||
*/
|
*/
|
||||||
@ -1121,14 +1121,14 @@ ExecReScanIncrementalSort(IncrementalSortState *node)
|
|||||||
PlanState *outerPlan = outerPlanState(node);
|
PlanState *outerPlan = outerPlanState(node);
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Incremental sort doesn't support efficient rescan even when paramters
|
* Incremental sort doesn't support efficient rescan even when parameters
|
||||||
* haven't changed (e.g., rewind) because unlike regular sort we don't
|
* haven't changed (e.g., rewind) because unlike regular sort we don't
|
||||||
* store all tuples at once for the full sort.
|
* store all tuples at once for the full sort.
|
||||||
*
|
*
|
||||||
* So even if EXEC_FLAG_REWIND is set we just reset all of our state and
|
* So even if EXEC_FLAG_REWIND is set we just reset all of our state and
|
||||||
* reexecute the sort along with the child node below us.
|
* reexecute the sort along with the child node below us.
|
||||||
*
|
*
|
||||||
* In theory if we've only fill the full sort with one batch (and haven't
|
* In theory if we've only filled the full sort with one batch (and haven't
|
||||||
* reset it for a new batch yet) then we could efficiently rewind, but
|
* reset it for a new batch yet) then we could efficiently rewind, but
|
||||||
* that seems a narrow enough case that it's not worth handling specially
|
* that seems a narrow enough case that it's not worth handling specially
|
||||||
* at this time.
|
* at this time.
|
||||||
|
@ -575,7 +575,7 @@ logicalrep_partmap_init(void)
|
|||||||
* Returned entry reuses most of the values of the root table's entry, save
|
* Returned entry reuses most of the values of the root table's entry, save
|
||||||
* the attribute map, which can be different for the partition.
|
* the attribute map, which can be different for the partition.
|
||||||
*
|
*
|
||||||
* Note there's no logialrep_partition_close, because the caller closes the
|
* Note there's no logicalrep_partition_close, because the caller closes the
|
||||||
* the component relation.
|
* the component relation.
|
||||||
*/
|
*/
|
||||||
LogicalRepRelMapEntry *
|
LogicalRepRelMapEntry *
|
||||||
|
@ -808,7 +808,7 @@ tuplesort_begin_common(int workMem, SortCoordinate coordinate,
|
|||||||
*
|
*
|
||||||
* Setup, or reset, all state need for processing a new set of tuples with this
|
* Setup, or reset, all state need for processing a new set of tuples with this
|
||||||
* sort state. Called both from tuplesort_begin_common (the first time sorting
|
* sort state. Called both from tuplesort_begin_common (the first time sorting
|
||||||
* with this sort state) and tuplesort_reseti (for subsequent usages).
|
* with this sort state) and tuplesort_reset (for subsequent usages).
|
||||||
*/
|
*/
|
||||||
static void
|
static void
|
||||||
tuplesort_begin_batch(Tuplesortstate *state)
|
tuplesort_begin_batch(Tuplesortstate *state)
|
||||||
|
@ -63,7 +63,7 @@ typedef struct SortCoordinateData *SortCoordinate;
|
|||||||
* sometimes put it in shared memory.
|
* sometimes put it in shared memory.
|
||||||
*
|
*
|
||||||
* The parallel-sort infrastructure relies on having a zero TuplesortMethod
|
* The parallel-sort infrastructure relies on having a zero TuplesortMethod
|
||||||
* indicate that a worker never did anything, so we assign zero to
|
* to indicate that a worker never did anything, so we assign zero to
|
||||||
* SORT_TYPE_STILL_IN_PROGRESS. The other values of this enum can be
|
* SORT_TYPE_STILL_IN_PROGRESS. The other values of this enum can be
|
||||||
* OR'ed together to represent a situation where different workers used
|
* OR'ed together to represent a situation where different workers used
|
||||||
* different methods, so we need a separate bit for each one. Keep the
|
* different methods, so we need a separate bit for each one. Keep the
|
||||||
|
Loading…
x
Reference in New Issue
Block a user