Add cross-references re schema search path

Started by Oliver Elphickover 23 years ago7 messagesdocs
Jump to latest
#1Oliver Elphick
olly@lfix.co.uk

I had great difficulty in finding how to change the search path, so here
is a patch to add some cross-referencing.

--
Oliver Elphick Oliver.Elphick@lfix.co.uk
Isle of Wight, UK
http://www.lfix.co.uk/oliver
GPG: 1024D/3E1D0C1C: CA12 09E0 E8D5 8870 5839 932A 614D 4C34 3E1D 0C1C
========================================
"But I would not have you to be ignorant, brethren,
concerning them which are asleep, that ye sorrow not,
even as others which have no hope. For if we believe
that Jesus died and rose again, even so them also
which sleep in Jesus will God bring with him."
I Thessalonians 4:13,14

Attachments:

pgsql.doc.patchtext/x-patch; charset=ISO-8859-15; name=pgsql.doc.patchDownload+15-1
#2Bruce Momjian
bruce@momjian.us
In reply to: Oliver Elphick (#1)
Re: Add cross-references re schema search path

Your patch has been added to the PostgreSQL unapplied patches list at:

http://candle.pha.pa.us/cgi-bin/pgpatches

I will try to apply it within the next 48 hours.

---------------------------------------------------------------------------

Oliver Elphick wrote:

I had great difficulty in finding how to change the search path, so here
is a patch to add some cross-referencing.

--
Oliver Elphick Oliver.Elphick@lfix.co.uk
Isle of Wight, UK
http://www.lfix.co.uk/oliver
GPG: 1024D/3E1D0C1C: CA12 09E0 E8D5 8870 5839 932A 614D 4C34 3E1D 0C1C
========================================
"But I would not have you to be ignorant, brethren,
concerning them which are asleep, that ye sorrow not,
even as others which have no hope. For if we believe
that Jesus died and rose again, even so them also
which sleep in Jesus will God bring with him."
I Thessalonians 4:13,14

[ text/x-patch is unsupported, treating like TEXT/PLAIN ]

Index: doc/src/sgml/func.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql-server/doc/src/sgml/func.sgml,v
retrieving revision 1.112
diff -u -r1.112 func.sgml
--- doc/src/sgml/func.sgml	2002/08/16 23:01:18	1.112
+++ doc/src/sgml/func.sgml	2002/08/19 04:15:18
@@ -5139,6 +5139,11 @@
path returned.
</para>
+   <para>
+    The search path may be altered by a runtime-alterable GUC setting:
+    <xref linkend="set-search-path">.
+   </para>
+
<table>
<title>System Information Functions</title>
<tgroup cols="3">
Index: doc/src/sgml/runtime.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql-server/doc/src/sgml/runtime.sgml,v
retrieving revision 1.126
diff -u -r1.126 runtime.sgml
--- doc/src/sgml/runtime.sgml	2002/08/18 03:03:25	1.126
+++ doc/src/sgml/runtime.sgml	2002/08/19 04:15:23
@@ -1548,7 +1548,7 @@
</listitem>
</varlistentry>
-     <varlistentry>
+     <varlistentry id="set-search-path" xreflabel="SET SEARCH_PATH">
<term><varname>SEARCH_PATH</varname> (<type>string</type>)</term>
<indexterm><primary>search_path</></>
<indexterm><primary>namespaces</></>
@@ -1608,6 +1608,10 @@
</para>
<para>
+	 <indexterm>
+	  <primary>schemas</primary>
+	  <secondary>current schema</secondary>
+	 </indexterm>
The current effective value of the search path can be examined
via the SQL function <function>current_schemas()</>.  This is not
quite the same as examining the value of
Index: doc/src/sgml/syntax.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql-server/doc/src/sgml/syntax.sgml,v
retrieving revision 1.66
diff -u -r1.66 syntax.sgml
--- doc/src/sgml/syntax.sgml	2002/08/13 20:40:43	1.66
+++ doc/src/sgml/syntax.sgml	2002/08/19 04:15:36
@@ -965,6 +965,11 @@
place <literal>pg_catalog</> at the end of your search path if you
prefer to have user-defined names override built-in names.
</para>
+
+    <para>
+     The search path is determined by the GUC variable SEARCH_PATH and
+     may be changed at any time.  See <xref linkend="set-search-path">.
+    </para>
</sect2>

<sect2 id="sql-reserved-names">

---------------------------(end of broadcast)---------------------------
TIP 5: Have you checked our extensive FAQ?

http://www.postgresql.org/users-lounge/docs/faq.html

-- 
  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
#3Peter Eisentraut
peter_e@gmx.net
In reply to: Oliver Elphick (#1)
Re: Add cross-references re schema search path

Oliver Elphick writes:

I had great difficulty in finding how to change the search path, so here
is a patch to add some cross-referencing.

You can't link across books. They need to build separately.

--
Peter Eisentraut peter_e@gmx.net

#4Bruce Momjian
bruce@momjian.us
In reply to: Peter Eisentraut (#3)
Re: Add cross-references re schema search path

OK, I will remove the reference to:

+ <varlistentry id="set-search-path" xreflabel="SET SEARCH_PATH">

^^^^^^^^^^^^^^^^^^^^^^^^^^

---------------------------------------------------------------------------

Peter Eisentraut wrote:

Oliver Elphick writes:

I had great difficulty in finding how to change the search path, so here
is a patch to add some cross-referencing.

You can't link across books. They need to build separately.

--
Peter Eisentraut peter_e@gmx.net

---------------------------(end of broadcast)---------------------------
TIP 6: Have you searched our list archives?

http://archives.postgresql.org

-- 
  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
#5Oliver Elphick
olly@lfix.co.uk
In reply to: Peter Eisentraut (#3)
Re: Add cross-references re schema search path

On Tue, 2002-08-20 at 22:20, Peter Eisentraut wrote:

Oliver Elphick writes:

I had great difficulty in finding how to change the search path, so here
is a patch to add some cross-referencing.

You can't link across books. They need to build separately.

Here's a replacement patch.

--
Oliver Elphick Oliver.Elphick@lfix.co.uk
Isle of Wight, UK
http://www.lfix.co.uk/oliver
GPG: 1024D/3E1D0C1C: CA12 09E0 E8D5 8870 5839 932A 614D 4C34 3E1D 0C1C
========================================
"But I would not have you to be ignorant, brethren,
concerning them which are asleep, that ye sorrow not,
even as others which have no hope. For if we believe
that Jesus died and rose again, even so them also
which sleep in Jesus will God bring with him."
I Thessalonians 4:13,14

Attachments:

pgsql.doc.patchtext/x-patch; charset=ISO-8859-15; name=pgsql.doc.patchDownload+20-0
#6Bruce Momjian
bruce@momjian.us
In reply to: Oliver Elphick (#5)
Re: Add cross-references re schema search path

Your patch has been added to the PostgreSQL unapplied patches list at:

http://candle.pha.pa.us/cgi-bin/pgpatches

I will try to apply it within the next 48 hours.

---------------------------------------------------------------------------

Oliver Elphick wrote:

On Tue, 2002-08-20 at 22:20, Peter Eisentraut wrote:

Oliver Elphick writes:

I had great difficulty in finding how to change the search path, so here
is a patch to add some cross-referencing.

You can't link across books. They need to build separately.

Here's a replacement patch.

--
Oliver Elphick Oliver.Elphick@lfix.co.uk
Isle of Wight, UK
http://www.lfix.co.uk/oliver
GPG: 1024D/3E1D0C1C: CA12 09E0 E8D5 8870 5839 932A 614D 4C34 3E1D 0C1C
========================================
"But I would not have you to be ignorant, brethren,
concerning them which are asleep, that ye sorrow not,
even as others which have no hope. For if we believe
that Jesus died and rose again, even so them also
which sleep in Jesus will God bring with him."
I Thessalonians 4:13,14

[ text/x-patch is unsupported, treating like TEXT/PLAIN ]

Index: doc/src/sgml/func.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql-server/doc/src/sgml/func.sgml,v
retrieving revision 1.115
diff -u -r1.115 func.sgml
--- doc/src/sgml/func.sgml	2002/08/21 16:08:19	1.115
+++ doc/src/sgml/func.sgml	2002/08/21 21:47:19
@@ -5144,6 +5144,17 @@
path returned.
</para>
+   <para id=set-search-path xreflabel="SET SEARCH_PATH">
+    <indexterm>
+     <primary>search path</primary>
+     <secondary>changing at runtime</secondary>
+    </indexterm>
+    The search path may be altered by a runtime-alterable GUC setting.  The
+    command to use is <command>
+     SET SEARCH_PATH '<varname>schema</varname>'[,'<varname>schema</varname>']...
+    </command>
+   </para>
+
<table>
<title>System Information Functions</title>
<tgroup cols="3">
Index: doc/src/sgml/runtime.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql-server/doc/src/sgml/runtime.sgml,v
retrieving revision 1.126
diff -u -r1.126 runtime.sgml
--- doc/src/sgml/runtime.sgml	2002/08/18 03:03:25	1.126
+++ doc/src/sgml/runtime.sgml	2002/08/21 21:47:23
@@ -1608,6 +1608,10 @@
</para>
<para>
+	 <indexterm>
+	  <primary>schemas</primary>
+	  <secondary>current schema</secondary>
+	 </indexterm>
The current effective value of the search path can be examined
via the SQL function <function>current_schemas()</>.  This is not
quite the same as examining the value of
Index: doc/src/sgml/syntax.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql-server/doc/src/sgml/syntax.sgml,v
retrieving revision 1.66
diff -u -r1.66 syntax.sgml
--- doc/src/sgml/syntax.sgml	2002/08/13 20:40:43	1.66
+++ doc/src/sgml/syntax.sgml	2002/08/21 21:47:37
@@ -965,6 +965,11 @@
place <literal>pg_catalog</> at the end of your search path if you
prefer to have user-defined names override built-in names.
</para>
+
+    <para>
+     The search path is determined by the GUC variable SEARCH_PATH and
+     may be changed at any time.  See <xref linkend="set-search-path">.
+    </para>
</sect2>

<sect2 id="sql-reserved-names">

---------------------------(end of broadcast)---------------------------
TIP 3: if posting/reading through Usenet, please send an appropriate
subscribe-nomail command to majordomo@postgresql.org so that your
message can get through to the mailing list cleanly

-- 
  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
#7Bruce Momjian
bruce@momjian.us
In reply to: Oliver Elphick (#5)
Re: Add cross-references re schema search path

Patch applied. Thanks.

---------------------------------------------------------------------------

Oliver Elphick wrote:

On Tue, 2002-08-20 at 22:20, Peter Eisentraut wrote:

Oliver Elphick writes:

I had great difficulty in finding how to change the search path, so here
is a patch to add some cross-referencing.

You can't link across books. They need to build separately.

Here's a replacement patch.

--
Oliver Elphick Oliver.Elphick@lfix.co.uk
Isle of Wight, UK
http://www.lfix.co.uk/oliver
GPG: 1024D/3E1D0C1C: CA12 09E0 E8D5 8870 5839 932A 614D 4C34 3E1D 0C1C
========================================
"But I would not have you to be ignorant, brethren,
concerning them which are asleep, that ye sorrow not,
even as others which have no hope. For if we believe
that Jesus died and rose again, even so them also
which sleep in Jesus will God bring with him."
I Thessalonians 4:13,14

[ text/x-patch is unsupported, treating like TEXT/PLAIN ]

Index: doc/src/sgml/func.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql-server/doc/src/sgml/func.sgml,v
retrieving revision 1.115
diff -u -r1.115 func.sgml
--- doc/src/sgml/func.sgml	2002/08/21 16:08:19	1.115
+++ doc/src/sgml/func.sgml	2002/08/21 21:47:19
@@ -5144,6 +5144,17 @@
path returned.
</para>
+   <para id=set-search-path xreflabel="SET SEARCH_PATH">
+    <indexterm>
+     <primary>search path</primary>
+     <secondary>changing at runtime</secondary>
+    </indexterm>
+    The search path may be altered by a runtime-alterable GUC setting.  The
+    command to use is <command>
+     SET SEARCH_PATH '<varname>schema</varname>'[,'<varname>schema</varname>']...
+    </command>
+   </para>
+
<table>
<title>System Information Functions</title>
<tgroup cols="3">
Index: doc/src/sgml/runtime.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql-server/doc/src/sgml/runtime.sgml,v
retrieving revision 1.126
diff -u -r1.126 runtime.sgml
--- doc/src/sgml/runtime.sgml	2002/08/18 03:03:25	1.126
+++ doc/src/sgml/runtime.sgml	2002/08/21 21:47:23
@@ -1608,6 +1608,10 @@
</para>
<para>
+	 <indexterm>
+	  <primary>schemas</primary>
+	  <secondary>current schema</secondary>
+	 </indexterm>
The current effective value of the search path can be examined
via the SQL function <function>current_schemas()</>.  This is not
quite the same as examining the value of
Index: doc/src/sgml/syntax.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql-server/doc/src/sgml/syntax.sgml,v
retrieving revision 1.66
diff -u -r1.66 syntax.sgml
--- doc/src/sgml/syntax.sgml	2002/08/13 20:40:43	1.66
+++ doc/src/sgml/syntax.sgml	2002/08/21 21:47:37
@@ -965,6 +965,11 @@
place <literal>pg_catalog</> at the end of your search path if you
prefer to have user-defined names override built-in names.
</para>
+
+    <para>
+     The search path is determined by the GUC variable SEARCH_PATH and
+     may be changed at any time.  See <xref linkend="set-search-path">.
+    </para>
</sect2>

<sect2 id="sql-reserved-names">

---------------------------(end of broadcast)---------------------------
TIP 3: if posting/reading through Usenet, please send an appropriate
subscribe-nomail command to majordomo@postgresql.org so that your
message can get through to the mailing list cleanly

-- 
  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