@@ -177,6 +177,19 @@ EXEC SQL CONNECT TO <replaceable>target</replaceable> <optional>AS <replaceable>
177
177
SQL string literal, or a reference to a character variable.
178
178
</para>
179
179
180
+ <para>
181
+ If the connection target includes any <replaceable>options</replaceable>,
182
+ those consist of
183
+ <literal><replaceable>keyword</replaceable>=<replaceable>value</replaceable></literal>
184
+ specifications separated by ampersands (<literal>&</literal>).
185
+ The allowed key words are the same ones recognized
186
+ by <application>libpq</application> (see
187
+ <xref linkend="libpq-paramkeywords"/>). Spaces are ignored before
188
+ any <replaceable>keyword</replaceable> or <replaceable>value</replaceable>,
189
+ though not within or after one. Note that there is no way to
190
+ write <literal>&</literal> within a <replaceable>value</replaceable>.
191
+ </para>
192
+
180
193
<para>
181
194
The <replaceable>connection-name</replaceable> is used to handle
182
195
multiple connections in one program. It can be omitted if a
@@ -191,7 +204,7 @@ EXEC SQL CONNECT TO <replaceable>target</replaceable> <optional>AS <replaceable>
191
204
<link linkend="ddl-schemas-patterns">secure schema usage pattern</link>,
192
205
begin each session by removing publicly-writable schemas
193
206
from <varname>search_path</varname>. For example,
194
- add <literal>options=-csearch_path =</literal>
207
+ add <literal>options=-c search_path =</literal>
195
208
to <literal><replaceable>options</replaceable></literal>, or
196
209
issue <literal>EXEC SQL SELECT pg_catalog.set_config('search_path', '',
197
210
false);</literal> after connecting. This consideration is not specific to
0 commit comments