Re: Missing documentation

From: Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Stefan Badenhorst <Stefan(dot)Badenhorst(at)mi-c3(dot)com>, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Missing documentation
Date: 2022-11-03 17:40:50
Message-ID: 20221103174050.3y3dgvqebk6oqq6c@alvherre.pgsql
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On 2022-Nov-03, Tom Lane wrote:

> Stefan Badenhorst <Stefan(dot)Badenhorst(at)mi-c3(dot)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/

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Stefan Badenhorst 2022-11-03 17:51:20 Re: Missing documentation
Previous Message Tom Lane 2022-11-03 17:25:03 Re: Missing documentation