Thread

Version number in psql banner

Peter Eisentraut <peter_e@gmx.net> — 2005-09-01T15:30:34Z

A release or two ago we added the version number to the psql welcome banner.  
I noticed that quite a few people interpret that as the server version.  
Somehow, the explicit display of the version numbers leads them to make 
inferences that they would otherwise not bother about.  Has anyone else 
experienced that?  I suppose there was a reason we added the version number 
there, but I can't recall it.  Could we make that more clear?

-- 
Peter Eisentraut
http://developer.postgresql.org/~petere/

Re: Version number in psql banner

Alvaro Herrera <alvherre@alvh.no-ip.org> — 2005-09-01T16:31:25Z

On Thu, Sep 01, 2005 at 05:30:34PM +0200, Peter Eisentraut wrote:
> A release or two ago we added the version number to the psql welcome banner.  
> I noticed that quite a few people interpret that as the server version.  
> Somehow, the explicit display of the version numbers leads them to make 
> inferences that they would otherwise not bother about.  Has anyone else 
> experienced that?  I suppose there was a reason we added the version number 
> there, but I can't recall it.  Could we make that more clear?

I think the rationale for not adding the server version is that you
could tell people to do "select version()", so it would be unneeded
verbosity, but certainly a lot of people doesn't even know they can do
that.

I think by far the easiest and clearest is to show both psql's version
and the server version.  Not the whole "version()" string, as that is
too verbose -- just the version number.

-- 
Alvaro Herrera -- Valdivia, Chile         Architect, www.EnterpriseDB.com
"Cuando miro a alguien, ms me atrae cmo cambia que quin es" (J. Binoche)

Re: Version number in psql banner

Josh Berkus <josh@agliodbs.com> — 2005-09-01T16:31:55Z

Peter,

> A release or two ago we added the version number to the psql welcome
> banner. I noticed that quite a few people interpret that as the server
> version. Somehow, the explicit display of the version numbers leads them to
> make inferences that they would otherwise not bother about.  Has anyone
> else experienced that?  I suppose there was a reason we added the version
> number there, but I can't recall it.  Could we make that more clear?

Well, Bruce just drafted a patch to warn when the PSQL version and the server 
version don't match up, because of PSQL incompatibilities.  However, that 
won't help for minor versions.

-- 
Josh Berkus
Aglio Database Solutions
San Francisco

Re: Version number in psql banner

Darcy Buskermolen <darcy@wavefire.com> — 2005-09-01T17:34:03Z

On Thursday 01 September 2005 08:30, Peter Eisentraut wrote:
> A release or two ago we added the version number to the psql welcome
> banner. I noticed that quite a few people interpret that as the server
> version. Somehow, the explicit display of the version numbers leads them to
> make inferences that they would otherwise not bother about.  Has anyone
> else experienced that?  I suppose there was a reason we added the version
> number there, but I can't recall it.  Could we make that more clear?

Yes I've seen the same frustration from users,  I think the banner should say 
something along the lines of "psql client version foo connected to server bar 
version sfoo" 

-- 
Darcy Buskermolen
Wavefire Technologies Corp.

http://www.wavefire.com
ph: 250.717.0200
fx: 250.763.1759

Re: Version number in psql banner

Aly Dharshi <aly.dharshi@telus.net> — 2005-09-01T18:44:50Z

On Thu, 1 Sep 2005, Darcy Buskermolen wrote:

> Yes I've seen the same frustration from users,  I think the banner should say
> something along the lines of "psql client version foo connected to server bar
> version sfoo"

 	I second this, I think that something like "psl client version 
8.03 connected to server db01 running PostgreSQL version 8.1" would be 
real swell.

 	Cheers,

 	Aly.

-- 
Aly S.P Dharshi
aly.dharshi@telus.net

 	 "A good speech is like a good dress
 	  that's short enough to be interesting
 	  and long enough to cover the subject"

Re: Version number in psql banner

Tom Lane <tgl@sss.pgh.pa.us> — 2005-09-01T18:53:12Z

Darcy Buskermolen <darcy@wavefire.com> writes:
> Yes I've seen the same frustration from users,  I think the banner should say
> something along the lines of "psql client version foo connected to server bar
> version sfoo" 

That seems overly verbose, particularly in the normal case where the
versions are indeed the same.  I could live with seeing a display like
that when the versions are different.

The other question is what counts as "different" --- do we want to
complain like this if the minor versions are different?

			regards, tom lane

Re: Version number in psql banner

Simon Riggs <simon@2ndquadrant.com> — 2005-09-01T22:18:25Z

On Thu, 2005-09-01 at 14:53 -0400, Tom Lane wrote:
> Darcy Buskermolen <darcy@wavefire.com> writes:
> > Yes I've seen the same frustration from users,  I think the banner should say
> > something along the lines of "psql client version foo connected to server bar
> > version sfoo" 
> 
> That seems overly verbose, particularly in the normal case where the
> versions are indeed the same.  I could live with seeing a display like
> that when the versions are different.

Thats the way Oracle sql*plus has worked for years, so its fairly
acceptable to a great many people without too many questions.

> The other question is what counts as "different" --- do we want to
> complain like this if the minor versions are different?

Which is much harder to define and could itself have a bug in it, so I
prefer the verbose message.... its much better to know for certain every
time.

Best Regards, Simon Riggs

Re: Version number in psql banner

Jim C. Nasby <jnasby@pervasive.com> — 2005-09-02T04:34:37Z

On Thu, Sep 01, 2005 at 11:18:25PM +0100, Simon Riggs wrote:
> On Thu, 2005-09-01 at 14:53 -0400, Tom Lane wrote:
> > Darcy Buskermolen <darcy@wavefire.com> writes:
> > > Yes I've seen the same frustration from users,  I think the banner should say
> > > something along the lines of "psql client version foo connected to server bar
> > > version sfoo" 
> > 
> > That seems overly verbose, particularly in the normal case where the
> > versions are indeed the same.  I could live with seeing a display like
> > that when the versions are different.
> 
> Thats the way Oracle sql*plus has worked for years, so its fairly
> acceptable to a great many people without too many questions.
> 
> > The other question is what counts as "different" --- do we want to
> > complain like this if the minor versions are different?
> 
> Which is much harder to define and could itself have a bug in it, so I
> prefer the verbose message.... its much better to know for certain every
> time.

I was going to mention that we should report server version info any
time we connect to a different server, though I guess \connect only
allows you to connect to a different database on the same server.

As a side note, there's a typo in \?:

  \c[onnect] [DBNAME|- [USER]]

Note the | where there should be a ].
-- 
Jim C. Nasby, Sr. Engineering Consultant      jnasby@pervasive.com
Pervasive Software        http://pervasive.com        512-569-9461

Re: Version number in psql banner

Michael Fuhr <mike@fuhr.org> — 2005-09-02T05:03:47Z

On Thu, Sep 01, 2005 at 11:34:37PM -0500, Jim C. Nasby wrote:
> As a side note, there's a typo in \?:
> 
>   \c[onnect] [DBNAME|- [USER]]
> 
> Note the | where there should be a ].

Eh?  Looks right to me; the | indicates an alternate, i.e., that
you can use either DBNAME or -.  I often use - to connect to the
same database as a different user.

test=> \c - postgres
You are now connected as new user "postgres".
test=# 

-- 
Michael Fuhr

Re: typo? was: Version number in psql banner

Tino Wildenhain <tino@wildenhain.de> — 2005-09-02T05:38:31Z

Am Donnerstag, den 01.09.2005, 23:34 -0500 schrieb Jim C. Nasby:
> On Thu, Sep 01, 2005 at 11:18:25PM +0100, Simon Riggs wrote:

> As a side note, there's a typo in \?:
> 
>   \c[onnect] [DBNAME|- [USER]]
> 
> Note the | where there should be a ].

No ;) The | stands for the alternative.
The whole block is optional, where 
you can either type dbname or a hypen
for the database name - to be able to
just switch the user.

Re: [HACKERS] Version number in psql banner

Bruce Momjian <pgman@candle.pha.pa.us> — 2005-09-03T00:39:52Z

Tom Lane wrote:
> Darcy Buskermolen <darcy@wavefire.com> writes:
> > Yes I've seen the same frustration from users,  I think the banner should say
> > something along the lines of "psql client version foo connected to server bar
> > version sfoo" 
> 
> That seems overly verbose, particularly in the normal case where the
> versions are indeed the same.  I could live with seeing a display like
> that when the versions are different.
> 
> The other question is what counts as "different" --- do we want to
> complain like this if the minor versions are different?

I updated the patch.  This gives psql three output displays on startup:

full match:

	Welcome to psql 8.1beta1, the PostgreSQL interactive terminal.

major match:

	Welcome to psql, the PostgreSQL interactive terminal.
	psql version 8.19, server version 8.1

and non-major match:
	
	WARNING:  You are connected to a server with major version 8.1,
	but your psql client is major version 8.2.  Informational backslash
	commands, like \d, might not work properly.
	
	Welcome to psql, the PostgreSQL interactive terminal.
	psql version 8.29, server version 8.1

Patch attached.

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  pgman@candle.pha.pa.us               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073