upstream/postgresql
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2026-02-21 00:40:20 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions
postgresql/src/tutorial
History
Tom Lane 4576208454 Force standard_conforming_strings to always be ON. 
Continuing to support this backwards-compatibility feature has
nontrivial costs; in particular it is potentially a security hazard
if an application somehow gets confused about which setting the
server is using.  We changed the default to ON fifteen years ago,
which seems like enough time for applications to have adapted.
Let's remove support for the legacy string syntax.

We should not remove the GUC altogether, since client-side code will
still test it, pg_dump scripts will attempt to set it to ON, etc.
Instead, just prevent it from being set to OFF.  There is precedent
for this approach (see commit de66987ad).

This patch does remove the related GUC escape_string_warning, however.
That setting does nothing when standard_conforming_strings is on,
so it's now useless.  We could leave it in place as a do-nothing
setting to avoid breaking clients that still set it, if there are any.
But it seems likely that any such client is also trying to turn off
standard_conforming_strings, so it'll need work anyway.

The client-side changes in this patch are pretty minimal, because even
though we are dropping the server's support, most of our clients still
need to be able to talk to older server versions.  We could remove
dead client code only once we disclaim compatibility with pre-v19
servers, which is surely years away.  One change of note is that
pg_dump/pg_dumpall now set standard_conforming_strings = on in their
source session, rather than accepting the source server's default.
This ensures that literals in view definitions and such will be
printed in a way that's acceptable to v19+.  In particular,
pg_upgrade will work transparently even if the source installation has
standard_conforming_strings = off.  (However, pg_restore will behave
the same as before if given an archive file containing
standard_conforming_strings = off.  Such an archive will not be safely
restorable into v19+, but we shouldn't break the ability to extract
valid data from it for use with an older server.)

Author: Tom Lane <tgl@sss.pgh.pa.us>
Discussion: https://postgr.es/m/3279216.1767072538@sss.pgh.pa.us
2026-01-21 15:08:38 -05:00
..
.gitignore Add .gitignore to src/tutorial/ 2019-11-22 21:14:54 +09:00
advanced.source Doc: simplify the tutorial's window-function examples. 2025-01-21 14:43:21 -05:00
basics.source Doc: sync src/tutorial/basics.source with SGML documentation. 2022-11-19 13:09:14 -05:00
complex.c Use palloc_object() and palloc_array() in more areas of the tree 2025-12-09 14:53:17 +09:00
complex.source Update copyright for 2026 2026-01-01 13:24:10 -05:00
funcs.c Use palloc_object() and palloc_array() in more areas of the tree 2025-12-09 14:53:17 +09:00
funcs.source Add documentation about calling version-1 C functions from C. 2025-01-17 14:37:38 -05:00
Makefile Rename 'gmake' to 'make' in docs and recommended commands 2014-02-12 17:29:19 -05:00
README Rename 'gmake' to 'make' in docs and recommended commands 2014-02-12 17:29:19 -05:00
syscat.source Force standard_conforming_strings to always be ON. 2026-01-21 15:08:38 -05:00

README 

src/tutorial/README

tutorial
========

This directory contains SQL tutorial scripts.  To look at them, first do a
	% make
to compile all the scripts and C files for the user-defined functions
and types.  (make needs to be GNU make --- it may be named something
different on your system, often 'gmake')

Then, run psql with the -s (single-step) flag:
	% psql -s

From within psql, you can try each individual script file by using
psql's \i <filename> command.