SET

功能描述

用于修改运行时配置参数。

注意事项

大多数运行时参数都可以用SET在运行时设置，但有些则在服务运行过程中或会话开始之后不能修改。

语法格式

• 设置所处的时区。

  SET [ SESSION | LOCAL ] TIME ZONE { timezone | LOCAL | DEFAULT };

• 设置所属的模式。

  SET [ SESSION | LOCAL ] 
      {CURRENT_SCHEMA { TO | = } { schema | DEFAULT }
      | SCHEMA 'schema'};

• 设置客户端编码集。

  SET [ SESSION | LOCAL ] NAMES {'charset_name' [COLLATE 'collation_name'] | DEFAULT};

• 设置其他运行时参数。

  SET [ SESSION | LOCAL ]
      {config_parameter { { TO | = } { value | DEFAULT } 
                        | FROM CURRENT }};

参数说明

• SESSION

  声明的参数只对当前会话起作用。如果SESSION和LOCAL都没出现，则SESSION为缺省值。

  如果在事务中执行了此命令，命令的产生影响将在事务回滚之后消失。如果该事务已提交，影响将持续到会话的结束，除非被另外一个SET命令重置参数。

• LOCAL

  声明的参数只在当前事务中有效。在COMMIT或ROLLBACK之后，会话级别的设置将再次生效。

  不论事务是否提交，此命令的影响只持续到当前事务结束。一个特例是：在一个事务里面，既有SET命令，又有SET LOCAL命令，且SET LOCAL在SET后面，则在事务结束之前，SET LOCAL命令会起作用，但事务提交之后，则是SET命令会生效。

• TIME ZONE timezone

  用于指定当前会话的本地时区。

  取值范围：有效的本地时区。该选项对应的运行时参数名称为TimeZone，DEFAULT缺省值为PRC。

• CURRENT_SCHEMA schema

  CURRENT_SCHEMA用于指定当前的模式。

  取值范围：已存在模式名称。如果模式名不存在，会导致CURRENT_SCHEMA值为空。

• SCHEMA schema

  同CURRENT_SCHEMA。此处的schema是个字符串。

  例如：set schema 'public';

• NAMES {'charset_name' [COLLATE 'collation_name'] | DEFAULT};
• 在B兼容模式下，并在设置b_format_version='5.7'、b_format_dev_version='s2';时，支持指定collate子句。

  用于设置客户端字符编码，常量字符串的字符集、字符序，及返回结果的字符集。

  等价于：

  set client_encoding = charset_name; set character_set_connection = charset_name;
  set collation_connection = collation_name; set character_set_results = charset_name;

  取值范围：B兼容模式下支持的字符集，字符序。暂不支持指定charset_name与数据库字符集不同。

• 其他场景下不支持指定collate子句。

  用于设置客户端的字符编码。

  等价于：

  set client_encoding to charset_name

  取值范围：有效的字符编码。该选项对应的运行时参数名称为client_encoding，默认编码为UTF8。

• config_parameter

  可设置的运行时参数的名称。可用的运行时参数可以使用SHOW ALL命令查看。

  

  部分通过SHOW ALL查看的参数不能通过SET设置。如max_datanodes。

• value

  config_parameter的新值。可以声明为字符串常量、标识符、数字，或者逗号分隔的列表。DEFAULT用于把这些参数设置为它们的缺省值。

• SESSION | @@SESSION. | @@

  声明的参数生效方式为superuser、user，可通过pg_settings系统视图的context字段确定，如果没有出现GLOBAL /SESSION，则SESSION为缺省值。支持config_parameter赋值为表达式。

  

  1. SET SESSION 只有在兼容B模式下（sql_compatibility = 'B'）支持，并且GUC参数b_format_behavior_compat_options设置值包含 enable_set_variables的场景下才支持（set b_format_behavior_compat_options = 'enable_set_variables')。
  2. 使用@@config_parameter进行操作符运算时，尽量使用空格隔开。比如set @@config_parameter1=@@config_parameter1*2; 命令中，会将=@@当做操作符，可将其修改为set @@config_parameter1= @@config_parameter1 * 2 。

示例

--设置所处的时区。
gaussdb=# SET TIME ZONE 'PST8PDT';

--设置模式搜索路径。    
gaussdb=# SET search_path TO tpcds, public;

--设置客户端编码集。
gaussdb=# SET client_encoding TO utf8;

--设置XML的解析方式。
gaussdb=# SET XML OPTION DOCUMENT;

--把日期时间风格设置为传统的 POSTGRES 风格(日在月前)。
gaussdb=# SET datestyle TO postgres,dmy;

--SET自定义用户变量的功能。
gaussdb=# CREATE DATABASE user_var DBCOMPATIBILITY 'B';
gaussdb=# \c user_var
user_var=# SET b_format_behavior_compat_options = enable_set_variables;
user_var=# SET @v1 := 1, @v2 := 1.1, @v3 := true, @v4 := 'dasda', @v5 := x'41';

--查询自定义用户变量。
user_var=# SELECT @v1, @v2, @v3, @v4, @v5, @v6, @v7;
@v1 | @v2 | @v3 |  @v4  |   @v5    | @v6 | @v7 
-----+-----+-----+-------+----------+-----+-----
   1 | 1.1 |   1 | dasda | 01000001 |     | 
(1 row)
--PREPARE语法使用自定义用户变量。
user_var=# SET @sql = 'select 1';
user_var=# PREPARE stmt as @sql;
user_var=# EXECUTE stmt;
user_var=# \c postgres

--删除数据库。
gaussdb=# DROP DATABASE user_var;

相关链接

RESET，SHOW