]> granicus.if.org Git - pgbouncer/commitdiff
doc: Document SET command
authorPeter Eisentraut <peter@eisentraut.org>
Thu, 19 Jul 2018 16:18:13 +0000 (18:18 +0200)
committerPeter Eisentraut <peter@eisentraut.org>
Thu, 19 Jul 2018 16:18:13 +0000 (18:18 +0200)
doc/usage.rst

index 27a55f44e9d6e5136f6fc5a64c4fe507553a090d..48ad97551a6047b677c1c58d705fad31a560b494 100644 (file)
@@ -485,7 +485,8 @@ value
 
 changeable
     Either **yes** or **no**, shows if the variable can be changed while running.
-    If **no**, the variable can be changed only boot-time.
+    If **no**, the variable can be changed only at boot time.  Use
+    **SET** to change a variable at run time.
 
 SHOW DNS_HOSTS;
 ---------------
@@ -566,6 +567,21 @@ RELOAD;
 The PgBouncer process will reload its configuration file and update
 changeable settings.
 
+Other commands
+~~~~~~~~~~~~~~
+
+SET key = arg
+-------------
+
+Changes a configuration setting (see also **SHOW CONFIG**).  For example::
+
+    SET log_connections = 1;
+    SET server_check_query = 'select 2';
+
+(Note that this command is run on the PgBouncer admin console and sets
+PgBouncer settings.  A **SET** command run on another database will be
+passed to the PostgreSQL backend like any other SQL command.)
+
 Signals
 ~~~~~~~