PostgreSQL 15 文档: SET - Redrock Postgres

SET
上一页	上一级	SQL 命令	起始页	下一页

SET

SET — 更改运行时参数

大纲

SET [ SESSION | LOCAL ] configuration_parameter { TO | = } { value | 'value' | DEFAULT }
SET [ SESSION | LOCAL ] TIME ZONE { value | 'value' | LOCAL | DEFAULT }

描述

SET命令用于更改运行时配置参数。许多在第 20 章中列出的运行时参数可以通过SET动态更改。（有些参数只能由超级用户和已被授予对该参数具有SET特权的用户更改。还有一些参数在服务器或会话启动后无法更改。） SET仅影响当前会话使用的值。

如果在一个事务内发出SET （或者等效的SET SESSION）而该事务后来中止，在该事务被回滚时SET命令的效果会消失。一旦所在的事务被提交，这些效果将会持续到会话结束（除非被另一个SET所覆盖）。

SET LOCAL的效果只持续到当前事务结束，不管事务是否被提交。一种特殊情况是在一个事务内 SET后面跟着 SET LOCAL： SET LOCAL值将会在该事务结束前一直可见，但是之后（如果该事务被提交）SET值将会生效。

SET或SET LOCAL 的效果也会因为回滚到早于它们的保存点而消失。

如果SET LOCAL在一个函数内使用，并且该函数还有对同一变量的SET选项（见 CREATE FUNCTION），在函数退出时 SET LOCAL命令的效果会消失。也就是说，该函数被调用时的值会被恢复。这允许用 SET LOCAL在函数内动态地或重复地更改一个参数，同时仍然能便利地使用SET选项来保存和恢复调用者的值。不过，一个常规的SET命令会覆盖它所在的任何函数的SET选项，除非回滚，它的效果将一直保持。

注意

在PostgreSQL 版本 8.0 到 8.2 中，一个SET LOCAL的效果会因为释放较早的保存点或者成功地从一个PL/pgSQL异常块中退出而被取消。这种行为已经被更改，因为它被认为不直观。

参数

SESSION: 指定该命令对当前会话有效（这是默认值，如果既没有出现 SESSION也没有出现LOCAL）。
LOCAL: 指定该命令只对当前事务有效。在COMMIT或 ROLLBACK之后，会话级别的设置会再次生效。在事务块外部发出这个参数会发出一个警告，并且不会有效果。
configuration_parameter: 可设置运行时参数的名称。可用的参数在第 20 章和下文中有记录。
value: 参数的新值。根据特定的参数，值可以被指定为字符串常量、标识符、数字或者以上构成的逗号分隔列表。写DEFAULT 可以指定将该参数重置为它的默认值（也就是说在当前会话中还没有执行SET命令时它具有的值）。

除了在第 20 章中记录的配置参数外，还有一些只能使用SET命令调整或具有特殊语法的参数：

SCHEMA

SET SCHEMA 'value'是SET search_path TO value的别名。只能使用这种语法指定一个模式。

NAMES

SET NAMES value是SET client_encoding TO value的别名。

SEED

设置随机数生成器（函数random）的内部种子。允许的值是-1到1之间的浮点数。

种子也可以通过调用函数setseed来设置：

SELECT setseed(value);

TIME ZONE

SET TIME ZONE 'value'是SET timezone TO 'value'的别名。语法SET TIME ZONE允许时间区域规范的特殊语法。以下是有效值的示例：

'PST8PDT': 加利福尼亚州伯克利的时区。
'Europe/Rome': 意大利的时区。
-7: UTC西7小时的时区（等同于PDT）。正值表示东部时区。
INTERVAL '-08:00' HOUR TO MINUTE: UTC西8小时的时区（等同于PST）。
LOCAL DEFAULT: 将时区设置为本地时区（即服务器的默认值timezone）。

以数字或间隔形式给出的时区设置会被内部转换为POSIX时区语法。例如，在SET TIME ZONE -7之后，SHOW TIME ZONE将报告<-07>+07。

SET不支持时区缩写；有关时区的更多信息，请参阅第 8.5.3 节。

注释

函数set_config提供了等效的功能，见第 9.27.1 节。此外，可以更新 pg_settings 系统视图来执行与SET等效的工作。

示例

设置模式搜索路径：

SET search_path TO my_schema, public;

把日期风格设置为传统 POSTGRES的 “日先于月”的输入习惯：

SET datestyle TO postgres, dmy;

设置时区为加州伯克利：

SET TIME ZONE 'PST8PDT';

设置时区为意大利：

SET TIME ZONE 'Europe/Rome';

兼容性

SET TIME ZONE 扩展了 SQL 标准定义的语法。标准只允许数字的时区偏移量，而 PostgreSQL 允许更灵活的时区说明。所有其他 SET 特性都是 PostgreSQL 扩展。

其他

RESET, SHOW