Re: Add A Glossary

From: Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>
To: Erik Rijkers <er(at)xs4all(dot)nl>
Cc: Jürgen Purtz <juergen(at)purtz(dot)de>, Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>, Fabien COELHO <coelho(at)cri(dot)ensmp(dot)fr>, Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>, Corey Huinker <corey(dot)huinker(at)gmail(dot)com>, Justin Pryzby <pryzby(at)telsasoft(dot)com>, Roger Harkavy <rogerharkavy(at)gmail(dot)com>, pgsql-hackers(at)postgresql(dot)org, Michael Paquier <michael(at)paquier(dot)xyz>
Subject: Re: Add A Glossary
Date: 2020-05-17 15:28:51
Message-ID: 20200517152851.GA31376@alvherre.pgsql
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On 2020-May-17, Erik Rijkers wrote:

> On 2020-05-17 08:51, Alvaro Herrera wrote:

> > I don't think that's the general understanding of those terms. For all
> > I know, they *are* synonyms, and there's no specific term for "the
> > fluctuating objects" as you call them. The instance is either running
> > (in which case there are processes and RAM) or it isn't.
>
> For what it's worth, I've also always understood 'instance' as 'a running
> database'. I admit it might be a left-over from my oracle years:
>
> https://docs.oracle.com/cd/E11882_01/server.112/e40540/startup.htm#CNCPT601
>
> There, 'instance' clearly refers to a running database. When that database
> is stopped, it ceases to be an instance.

I've never understood it that way, but I'm open to having my opinion on
it changed. So let's discuss it and maybe gather opinions from others.

I think the terms under discussion are just

* cluster
* instance
* server

We don't have "host" (I just made it a synonym for server), but perhaps
we can add that too, if it's useful. It would be good to be consistent
with historical Postgres usage, such as the initdb usage of "cluster"
etc.

Perhaps we should not only define what our use of each term is, but also
explain how each term is used outside PostgreSQL and highlight the
differences. (This would be particularly useful for "cluster" ISTM.)

It seems difficult to get this sorted out before beta1, but there's
still time before the glossary is released.

--
Álvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2020-05-17 21:11:49 non-string or non-string
Previous Message Erik Rijkers 2020-05-17 09:08:02 Re: Add A Glossary

Browse pgsql-hackers by date

  From Date Subject
Next Message Pavel Borisov 2020-05-17 19:53:21 Re: [PATCH] fix GIN index search sometimes losing results
Previous Message Fabien COELHO 2020-05-17 09:55:43 Re: pgbench: option delaying queries till connections establishment?