About SET SEARCH_PATH

Started by Christoph Hallerover 22 years ago4 messagesdocs
Jump to latest
#1Christoph Haller
ch@rodos.fzk.de

I'm thinking of introducing schemas within my databases.
Reading the doc I've found some stuff which does not
seem right. I'm referring to 7.3.4.

(1)
$PGSQLD/doc/html/functions-misc.html

The search path may be altered by a run-time setting.
The command to use is SET SEARCH_PATH 'schema'[,'schema']...

It should be
SET SEARCH_PATH TO schema[,schema]...

May be a link to
$PGSQLD/doc/html/ddl-schemas.html
should be used instead, it has it all right.

(2)
$PGSQLD/doc/html/sql-set.html

This page does not mention the SEARCH_PATH variable at all.
Is this intended?

Regards, Christoph

#2Tom Lane
tgl@sss.pgh.pa.us
In reply to: Christoph Haller (#1)
Re: About SET SEARCH_PATH

Christoph Haller <ch@rodos.fzk.de> writes:

The search path may be altered by a run-time setting.
The command to use is SET SEARCH_PATH 'schema'[,'schema']...

It should be
SET SEARCH_PATH TO schema[,schema]...

Actually, you can do it either way:

regression=# set search_path TO a,b,c;
regression=# set search_path TO 'a','b','c';

although not

regression=# set search_path TO 'a,b,c';
ERROR: schema "a,b,c" does not exist

This is mainly for legacy reasons (the grammar involved was originally
used for DateStyle...). I don't object to documenting primarily the
first form, though.

(2)
$PGSQLD/doc/html/sql-set.html

This page does not mention the SEARCH_PATH variable at all.
Is this intended?

Yeah; that page only documents SET items that are not in the main list
of run-time-configurable parameters.

regards, tom lane

#3Harry Broomhall
harry.broomhall@uk.easynet.net
In reply to: Christoph Haller (#1)
Re: About SET SEARCH_PATH

On Wed, 17 Sep 2003 16:40:32 -0400, tgl@sss.pgh.pa.us (Tom Lane)
wrote:

Christoph Haller <ch@rodos.fzk.de> writes:

The search path may be altered by a run-time setting.
The command to use is SET SEARCH_PATH 'schema'[,'schema']...

It should be
SET SEARCH_PATH TO schema[,schema]...

Actually, you can do it either way:

regression=# set search_path TO a,b,c;
regression=# set search_path TO 'a','b','c';

although not

regression=# set search_path TO 'a,b,c';
ERROR: schema "a,b,c" does not exist

But surely not without the 'TO' word, which is how it appears in
6.13 of the User's Guide?

Regards,
Harry.

#4Tom Lane
tgl@sss.pgh.pa.us
In reply to: Harry Broomhall (#3)
Re: About SET SEARCH_PATH

Harry Broomhall <harry.broomhall@uk.easynet.net> writes:

But surely not without the 'TO' word, which is how it appears in
6.13 of the User's Guide?

Right. I see this is already fixed in the 7.4 docs.

regards, tom lane