Doc: stop implying recommendation of insecure search_path value.
authorNoah Misch <noah@leadboat.com>
Thu, 1 May 2025 23:51:59 +0000 (16:51 -0700)
committerNoah Misch <noah@leadboat.com>
Thu, 1 May 2025 23:52:03 +0000 (16:52 -0700)
commit8ae4ac6a7424ae597e0c3ecb7bd5f380248f22cc
tree85bae563edee7824ee7d92e6f02b89ec0f0acccd
parent87af12e71fa9408e629f7a9772dc817de3ba44b8
Doc: stop implying recommendation of insecure search_path value.

SQL "SET search_path = 'pg_catalog, pg_temp'" is silently equivalent to
"SET search_path = pg_temp, pg_catalog, "pg_catalog, pg_temp"" instead
of the intended "SET search_path = pg_catalog, pg_temp".  (The intent
was a two-element search path.  With the single quotes, it instead
specifies one element with a comma and a space in the middle of the
element.)  In addition to the SET statement, this affects SET clauses of
CREATE FUNCTION, ALTER ROLE, and ALTER DATABASE.  It does not affect the
set_config() SQL function.

Though the documentation did not show an insecure command, remove single
quotes that could entice a reader to write an insecure command.
Back-patch to v13 (all supported versions).

Reported-by: Sven Klemm <sven@timescale.com>
Author: Sven Klemm <sven@timescale.com>
Backpatch-through: 13
doc/src/sgml/extend.sgml