Re: Missing documentation - Mailing list pgsql-docs

From Alvaro Herrera
Subject Re: Missing documentation
Date
Msg-id 20221103174050.3y3dgvqebk6oqq6c@alvherre.pgsql
Whole thread Raw
In response to Re: Missing documentation  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: Missing documentation  (Stefan Badenhorst <Stefan.Badenhorst@mi-c3.com>)
List pgsql-docs
On 2022-Nov-03, Tom Lane wrote:

> Stefan Badenhorst <Stefan.Badenhorst@mi-c3.com> writes:
> > I am using a prometheus exporter:
> > https://github.com/prometheus-community/postgres_exporter/
> 
> Hmm, well, maybe prometheus is doing something with that part of the URL.
> There's no such behavior in Postgres itself, though.

Yeah, that part of the connection URI accepts libpq options, not
Postgres-server options.  The only way that you can pass options to the
backend is to use "options=-c foo=bar" in the URI, but both the
whitespace and the second equals sign need to be URI-escaped, so you end
up with something like this:

?sslmode=disable&options=-c%20jit%3Doff

This is explained (to some extent) in "34.1.1.2 Connection URIs",
https://www.postgresql.org/docs/current/libpq-connect.html#id-1.7.3.8.3.6

and later "34.1.2 Parameter Key Words" explains that the parameter
"options" is used to pass command-line (!!) options to the server.

Maybe this bit of documentation is not explicit enough; some additional
examples might clarify things.

-- 
Álvaro Herrera               48°01'N 7°57'E  —  https://www.EnterpriseDB.com/



pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Missing documentation
Next
From: Stefan Badenhorst
Date:
Subject: Re: Missing documentation