database/postgres
database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-05-05 09:19:17 +03:00
Code

Doc: Improve description of connection strings with Percent-encoding

Browse Source 
Clarify the description related to the use of characters which can be
encoded, and add an example.

Author: Jobin Augustine
Reviewed-by: Peter Eisentraut, Alvaro Herrera, Heikki Linnakangas,
Michael Paquier, Alex Shulgin
Discussion: https://postgr.es/m/CANaTPsrYgSgE2fuj3=4x=Jmx1c+NgkEDzftNknZbrMuqL+aBhQ@mail.gmail.com
This commit is contained in:
Michael Paquier 2020-01-19 18:55:51 +09:00
parent 34a0a81bfb
commit e0ed6817c0
1 changed files with 9 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
doc/src/sgml/libpq.sgml
View File

@ -925,10 +925,15 @@ postgresql:///mydb?host=localhost&port=5433
</para> </para>
<para> <para>
Percent-encoding may be used to include symbols with special meaning in any Connection <acronym>URI</acronym> needs to be encoded with
of the <acronym>URI</acronym> parts, e.g. replace <literal>=</literal> with <ulink url="https://tools.ietf.org/html/rfc3986#section-2.1">Percent-encoding</ulink>
<literal>%3D</literal>. if it includes symbols with special meaning in any of its parts.
Here is an example where equal sign (<literal>=</literal>) is replaced
with <literal>%3D</literal> and whitespace character with
<literal>%20</literal>:
<programlisting>
postgresql://user@localhost:5433/mydb?options=-c%20synchronous_commit%3Doff
</programlisting>
</para> </para>
<para> <para>