SET
大纲
SET [ SESSION | LOCAL ] configuration_parameter { TO | = } { value | 'value' | DEFAULT } SET [ SESSION | LOCAL ] TIME ZONE { timezone | LOCAL | DEFAULT }
描述
SET命令更改运行时配置参数。很多 第 19 章中列出的参数可以用 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
-
指定该命令对当前会话有效(这是默认值)。
- LOCAL
-
指定该命令只对当前事务有效。在COMMIT或者 ROLLBACK之后,会话级别的设置会再次生效。 在事务块外部发出这个参数会发出一个警告并且不会有效果。
- configuration_parameter
-
一个可设置运行时参数的名称。可用的参数被记录在 第 19 章和下文中。
- value
-
参数的新值。根据特定的参数,值可以被指定为字符串常量、标识符、 数字或者以上构成的逗号分隔列表。写DEFAULT 可以指定把该参数重置成它的默认值(也就是说在当前会话中还没有 执行SET命令时它具有的值)。
除了在第 19 章中记录的配置参数, 还有一些参数只能用SET命令设置 或者具有特殊的语法:
- SCHEMA
-
SET SCHEMA 'value'是 SET search_path TO value的一个别名。 使用这种语法只能指定一个模式。
- NAMES
-
SET NAMES value是 SET client_encoding TO value的一个别名。
- SEED
-
为随机数生成器(函数
random
)设置 一个内部种子。允许的值是 -1 和 1 之间的浮点数,它会被乘上 231-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)。正值则是 UTC 以东。
- INTERVAL '-08:00' HOUR TO MINUTE
-
UTC 以西 8 小时的时区(等效于 PST)。
- LOCAL DEFAULT
-
把时区设置为你的本地时区(也就是说服务器的timezone默认值)。
以数字或区间给出的时区设置在内部被翻译成 POSIX 时区语法。 例如,在SET TIME ZONE -7之后, SHOW TIME ZONE将会报告 <-07>+07。
有关时区的更多信息可见第 8.5.3 节。