Skip to content

Commit 29ad659

Browse files
committed
doc: Copy-edit the "Overview of PostgreSQL Internals" chapter
Rephrase a few sentences to be more concise. Refer to the postmaster process as "postmaster", not "postgres". This originally said "postmaster process", but was changed to "postgres process" in commit 5266f22, when we merged the "postmaster" and "postgres" commands, and "postmaster" became just a symlink. That was a case of overzealous search & replace, because the process is still called "postmaster". Author: Erik Rijkers and Jürgen Purtz Discussion: https://www.postgresql.org/message-id/aa31f359-1168-ded5-53d0-0ed228bfe097%40iki.fi
1 parent af0e79c commit 29ad659

File tree

1 file changed

+12
-15
lines changed

1 file changed

+12
-15
lines changed

doc/src/sgml/arch-dev.sgml

+12-15
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
<title>Author</title>
88
<para>
99
This chapter originated as part of
10-
<xref linkend="sim98"/>, Stefan Simkovics'
10+
<xref linkend="sim98"/> Stefan Simkovics'
1111
Master's Thesis prepared at Vienna University of Technology under the direction
1212
of O.Univ.Prof.Dr. Georg Gottlob and Univ.Ass. Mag. Katrin Seyr.
1313
</para>
@@ -17,10 +17,7 @@
1717
This chapter gives an overview of the internal structure of the
1818
backend of <productname>PostgreSQL</productname>. After having
1919
read the following sections you should have an idea of how a query
20-
is processed. This chapter does not aim to provide a detailed
21-
description of the internal operation of
22-
<productname>PostgreSQL</productname>, as such a document would be
23-
very extensive. Rather, this chapter is intended to help the reader
20+
is processed. This chapter is intended to help the reader
2421
understand the general sequence of operations that occur within the
2522
backend from the point at which a query is received, to the point
2623
at which the results are returned to the client.
@@ -30,8 +27,8 @@
3027
<title>The Path of a Query</title>
3128

3229
<para>
33-
Here we give a short overview of the stages a query has to pass in
34-
order to obtain a result.
30+
Here we give a short overview of the stages a query has to pass
31+
to obtain a result.
3532
</para>
3633

3734
<procedure>
@@ -125,10 +122,10 @@
125122
use a <firstterm>supervisor process</firstterm> (also
126123
<firstterm>master process</firstterm>) that spawns a new
127124
server process every time a connection is requested. This supervisor
128-
process is called <literal>postgres</literal> and listens at a
125+
process is called <literal>postmaster</literal> and listens at a
129126
specified TCP/IP port for incoming connections. Whenever a request
130-
for a connection is detected the <literal>postgres</literal>
131-
process spawns a new server process. The server tasks
127+
for a connection is detected the <literal>postmaster</literal>
128+
process spawns a new server process. The server processes
132129
communicate with each other using <firstterm>semaphores</firstterm> and
133130
<firstterm>shared memory</firstterm> to ensure data integrity
134131
throughout concurrent data access.
@@ -230,7 +227,7 @@
230227
<para>
231228
A detailed description of <application>bison</application> or
232229
the grammar rules given in <filename>gram.y</filename> would be
233-
beyond the scope of this paper. There are many books and
230+
beyond the scope of this manual. There are many books and
234231
documents dealing with <application>flex</application> and
235232
<application>bison</application>. You should be familiar with
236233
<application>bison</application> before you start to study the
@@ -343,8 +340,8 @@
343340
<note>
344341
<para>
345342
In some situations, examining each possible way in which a query
346-
can be executed would take an excessive amount of time and memory
347-
space. In particular, this occurs when executing queries
343+
can be executed would take an excessive amount of time and memory.
344+
In particular, this occurs when executing queries
348345
involving large numbers of join operations. In order to determine
349346
a reasonable (not necessarily optimal) query plan in a reasonable amount
350347
of time, <productname>PostgreSQL</productname> uses a <firstterm>Genetic
@@ -411,7 +408,7 @@
411408
<firstterm>merge join</firstterm>: Each relation is sorted on the join
412409
attributes before the join starts. Then the two relations are
413410
scanned in parallel, and matching rows are combined to form
414-
join rows. This kind of join is more
411+
join rows. This kind of join is
415412
attractive because each relation has to be scanned only once.
416413
The required sorting might be achieved either by an explicit sort
417414
step, or by scanning the relation in the proper order using an
@@ -442,7 +439,7 @@
442439
If the query uses fewer than <xref linkend="guc-geqo-threshold"/>
443440
relations, a near-exhaustive search is conducted to find the best
444441
join sequence. The planner preferentially considers joins between any
445-
two relations for which there exist a corresponding join clause in the
442+
two relations for which there exists a corresponding join clause in the
446443
<literal>WHERE</literal> qualification (i.e., for
447444
which a restriction like <literal>where rel1.attr1=rel2.attr2</literal>
448445
exists). Join pairs with no join clause are considered only when there

0 commit comments

Comments
 (0)