MIME-Version: 1.0
In-Reply-To: <157801363409.1149.3930072152315481638@wrigleys.postgresql.org>
References: <157801363409.1149.3930072152315481638@wrigleys.postgresql.org>
From: "David G. Johnston" <david.g.johnston@gmail.com>
Date: Fri, 3 Jan 2020 01:21:05 -0700
Message-ID: 
 <CAKFQuwYgLTMZHyqEDO2ge=gx1deY70gSLvLVcmZWNToiZ+v3tQ@mail.gmail.com>
Subject: Re: the concept of a database cluster
To: "libcub@hotmail.com" <libcub@hotmail.com>,
	"pgsql-docs@lists.postgresql.org" <pgsql-docs@lists.postgresql.org>
Content-Type: multipart/alternative; boundary="000000000000be3185059b37fd17"
Precedence: bulk

--000000000000be3185059b37fd17
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Thursday, January 2, 2020, PG Doc comments form <noreply@postgresql.org>
wrote:

> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/12/creating-cluster.html
> Description:
>
> In 18.2, a database cluster is said to be "a database storage area on
> disk",
> and then shortly afterward is is defined as "a collection of databases th=
at
> is managed by a single instance of a running database server". Those seem
> very different things. Sometimes in the manual I can't tell which usage i=
s
> intended.
>

A garage is a =E2=80=9Ccar storage area for a house=E2=80=9D. A garage can =
(typically)
store multiple cars just as a database cluster can store multiple
databases.  The files are only useful if there is a running instance and
all databases stored in the cluster are managed by a single shared
instance.  You will need to better explain your confusion because the
documentation is describing a complex system accurately but in parts that
are related - two sides of the same coin, if you will.

David J.

--000000000000be3185059b37fd17
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Thursday, January 2, 2020, PG Doc comments form &lt;<a href=3D"mailto:no=
reply@postgresql.org">noreply@postgresql.org</a>&gt; wrote:<br><blockquote =
class=3D"gmail_quote" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid=
;padding-left:1ex">The following documentation comment has been logged on t=
he website:<br>
<br>
Page: <a href=3D"https://www.postgresql.org/docs/12/creating-cluster.html" =
target=3D"_blank">https://www.postgresql.org/<wbr>docs/12/creating-cluster.=
html</a><br>
Description:<br>
<br>
In 18.2, a database cluster is said to be &quot;a database storage area on =
disk&quot;,<br>
and then shortly afterward is is defined as &quot;a collection of databases=
 that<br>
is managed by a single instance of a running database server&quot;. Those s=
eem<br>
very different things. Sometimes in the manual I can&#39;t tell which usage=
 is<br>
intended.<br>
</blockquote><div><br></div><div>A garage is a =E2=80=9Ccar storage area fo=
r a house=E2=80=9D. A garage can (typically) store multiple cars just as a =
database cluster can store multiple databases.=C2=A0 The files are only use=
ful if there is a running instance and all databases stored in the cluster =
are managed by a single shared instance.=C2=A0 You will need to better expl=
ain your confusion because the documentation is describing a complex system=
 accurately but in parts that are related - two sides of the same coin, if =
you will.</div><div><br></div><div>David J.</div><div><br></div>

--000000000000be3185059b37fd17--