Re: the concept of a database cluster

"David G. Johnston" <[email protected]> Fri, 3 Jan 2020 01:21:05 -0700
Newsgroups gmane.comp.db.postgresql.devel.documentation
Message-ID <CAKFQuwYgLTMZHyqEDO2ge=gx1deY70gSLvLVcmZWNToiZ+v3tQ@mail.gmail.com>
--000000000000be3185059b37fd17
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Thursday, January 2, 2020, PG Doc comments form <[email protected]>
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=
[email protected]">[email protected]</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--