Provided by: manpages-zh_1.5.2-1_all bug

NAME

       SET - 改变运行时参数

SYNOPSIS

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

DESCRIPTION 描述

       SET     命令修改运行时配置参数。许多在    Section    16.4    ``Run-time    Configuration''
       里面列出的运行时参数可以用                       SET                        在运行时设置。
       (但是有些要求使用超级用户权限来修改,而其它有些则在服务器或者会话
       开始之后不能修改。)请注意 SET 只影响当前会话使用的数值。

        如果    SET    或者    SET    SESSION    是在一个稍后退出的事务里发出的,    那么     SET
       命令的效果将在事务回滚的之后小时。  (这个行为和PostgreSQL版本  7.3  之前的不同, 那个时候
       SET                                                     的效果在后面的错误之后不会回滚。)
       一旦包围它的事务提交,那么其效果将持续到事务的结束,除非被另外一个 SET 覆盖。

       SET   LOCAL   的效果只持续到当前事务结束,不管是否提交。   一个特例是在一个事务里面的  SET
       后面跟着一个         SET         LOCAL:在事务结束之前只能看到          SET          LOCAL
       的数值,但是之后(如果事务提交),则是 SET 的值生效。

PARAMETERS 选项

       SESSION
               声明这个命令只对当前会话起作用。        (如果        SESSION       或       LOCAL
              都没出现,那么这个是缺省。)

       LOCAL
               声明该命令只在当前事务中有效。在          COMMIT           或者           ROLLBACK
              之后,会话级别的设置将再次生效。  请注意如果在  BEGIN  块之外运行,那么  SET  LOCAL
              将表现出没有作用,因为事务将立即结束。

       name
               可设置的运行时参数的名字。可用的参数在  Section  16.4  ``Run-time  Configuration''
              和下面归档。

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

        除了在   Section   16.4   ``Run-time    Configuration''    里面有文档记载的配置参数之外,
       还有几个只能用 SET 命令设置,或者是有特殊的语法的参数:

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

       SEED
               为随机数生成器(函数    random)设置内部的种子。    允许的值是介于    0    和    1
              之间的浮点数,然后它会被乘以 231-1。

               我们也可以通过调用函数 setseed 来设置种子:

              SELECT setseed(value);

       TIME ZONE
              SET TIME ZONE value 是 for SET timezone TO value 的一个别名。 语法  SET  TIME  ZONE
              允许为时区设置特殊的语法。 下面是有效值的例子:

              'PST8PDT'
                      加州伯克利的时区。

              'Portugal'
                      葡萄牙时区。

              'Europe/Rome'
                      意大利时区。

              -7
                      UTC 以西 7 小时的时区(等效于 PDT)。

              INTERVAL '-08:00' HOUR TO MINUTE
                      UTC 以西 8 小时的时区(等效于 PST)。

              LOCAL

              DEFAULT
                      将时区设置为你的本地时区(服务器的操作系统缺省的那个)。

        参阅 Section 8.5 ``Date/Time Types'' 获取有关时区的更多细节。

NOTES 注意

        函数 set_config 提供了等效的功能。 参阅 Section 9.13 ``Miscellaneous Functions'' 。

EXAMPLES 例子

        设置模式搜索路径:

       SET search_path TO my_schema, public;

       把日期时间风格设置为传统的 POSTGRES 风格, with ``day before month'' input convention:

       SET datestyle TO postgres, dmy;

        把时区设置为加州伯克力,                           使用双引号保存时区声明里大写字符的属性
       (注意这里的日期/时间格式是 PostgreSQL):

       SET TIME ZONE 'PST8PDT';
       SELECT current_timestamp AS today;

                    today
       -------------------------------
        2003-04-29 15:02:01.218622-07

COMPATIBILITY 兼容性

       SET TIME ZONE 扩展了在 SQL 标准里定义的语法。 标准只允许有一个数字时区偏移, 而 PostgreSQL
       还允许完整更灵活的时区声明。 所有其它的 SET 特性都是 PostgreSQL 扩展。

SEE ALSO 参见

       RESET [reset(7)], SHOW [show(l)]

译者

       Postgresql 中文网站 何伟平 <laser@pgsqldb.org>