public inbox for [email protected]help / color / mirror / Atom feed
the concept of a database cluster 4+ messages / 3 participants [nested] [flat]
* the concept of a database cluster @ 2020-01-03 01:07 PG Doc comments form <[email protected]> 2020-01-03 08:21 ` Re: the concept of a database cluster David G. Johnston <[email protected]> 0 siblings, 1 reply; 4+ messages in thread From: PG Doc comments form @ 2020-01-03 01:07 UTC (permalink / raw) To: [email protected]; +Cc: [email protected] 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 that 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 is intended. ^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: the concept of a database cluster 2020-01-03 01:07 the concept of a database cluster PG Doc comments form <[email protected]> @ 2020-01-03 08:21 ` David G. Johnston <[email protected]> 2020-01-04 09:58 ` Re: the concept of a database cluster Paul Weiss <[email protected]> 0 siblings, 1 reply; 4+ messages in thread From: David G. Johnston @ 2020-01-03 08:21 UTC (permalink / raw) To: [email protected] <[email protected]>; [email protected] <[email protected]> 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 that > 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 is > intended. > A garage is a “car storage area for a house”. 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. ^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: the concept of a database cluster 2020-01-03 01:07 the concept of a database cluster PG Doc comments form <[email protected]> 2020-01-03 08:21 ` Re: the concept of a database cluster David G. Johnston <[email protected]> @ 2020-01-04 09:58 ` Paul Weiss <[email protected]> 2020-01-04 16:11 ` Re: the concept of a database cluster David G. Johnston <[email protected]> 0 siblings, 1 reply; 4+ messages in thread From: Paul Weiss @ 2020-01-04 09:58 UTC (permalink / raw) To: David G. Johnston <[email protected]>; [email protected] <[email protected]> Oh, I didn't mean to imply that I am confused. It is clear that there are two concepts here, sharing a term. I was trying to communicate that the manual does not always make it immediately clear from context which concept is meant in a particular sentence. A garage is a good analogy. A garage is a container for cars rather than a collection of cars. You wouldn't say "I sold my garage" to mean "I sold my car collection". Containers and collections are different things. Here's a simple example In our context: "remove the cluster" could mean "delete the folder containing the databases", or "drop the databases". Those actions are not identical. I would think we would want to be clear to our users which we mean. Paul ________________________________ From: David G. Johnston <[email protected]> Sent: Friday, January 3, 2020 12:21 AM To: [email protected] <[email protected]>; [email protected] <[email protected]> Subject: Re: the concept of a database cluster On Thursday, January 2, 2020, PG Doc comments form <[email protected]<mailto:[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 that 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 is intended. A garage is a “car storage area for a house”. 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. ^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: the concept of a database cluster 2020-01-03 01:07 the concept of a database cluster PG Doc comments form <[email protected]> 2020-01-03 08:21 ` Re: the concept of a database cluster David G. Johnston <[email protected]> 2020-01-04 09:58 ` Re: the concept of a database cluster Paul Weiss <[email protected]> @ 2020-01-04 16:11 ` David G. Johnston <[email protected]> 0 siblings, 0 replies; 4+ messages in thread From: David G. Johnston @ 2020-01-04 16:11 UTC (permalink / raw) To: Paul Weiss <[email protected]>; +Cc: [email protected] <[email protected]> On Saturday, January 4, 2020, Paul Weiss <[email protected]> wrote: > Oh, I didn't mean to imply that I am confused. It is clear that there are > two concepts here, sharing a term. I was trying to communicate that the > manual does not always make it immediately clear from context which concept > is meant in a particular sentence. > > A garage is a good analogy. A garage is a container for cars rather than a > collection of cars. You wouldn't say "I sold my garage" to mean "I sold my > car collection". Containers and collections are different things. > > Here's a simple example In our context: "remove the cluster" could mean > "delete the folder containing the databases", or "drop the databases". > Those actions are not identical. I would think we would want to be clear to > our users which we mean. > I’m sure we’d be willing to fix concrete problematic examples but a lack of those suggests there is no actual problem here...as you aren’t confused or providing concrete examples and suggestions I have no idea what you are trying to accomplish with this thread. Awareness of what seems to be a non-existent issue? David J. ^ permalink raw reply [nested|flat] 4+ messages in thread
end of thread, other threads:[~2020-01-04 16:11 UTC | newest] Thread overview: 4+ messages (download: mbox mbox.gz follow: Atom feed) -- links below jump to the message on this page -- 2020-01-03 01:07 the concept of a database cluster PG Doc comments form <[email protected]> 2020-01-03 08:21 ` David G. Johnston <[email protected]> 2020-01-04 09:58 ` Paul Weiss <[email protected]> 2020-01-04 16:11 ` David G. Johnston <[email protected]>
This inbox is served by agora; see mirroring instructions for how to clone and mirror all data and code used for this inbox