SET · PostgreSQL 中文文檔 9.3

# SET ## Name SET?--?修改運行時參數 ## Synopsis ``` SET [ SESSION | LOCAL ] _configuration_parameter_ { TO | = } { _value_ | '_value_' | DEFAULT } SET [ SESSION | LOCAL ] TIME ZONE { _timezone_ | LOCAL | DEFAULT } ``` ## 描述 `SET`命令修改運行時配置參數。許多在[Chapter 18](#calibre_link-500) 里面列出的運行時參數可以用`SET`在運行時設置。但是有些要求使用超級用戶權限來修改，而其它有些則在服務器或者會話開始之后不能修改。請注意`SET`只影響當前會話使用的數值。如果`SET`（或相等的`SET SESSION`）是在一個稍后退出的事務里發出的，那么`SET`命令的效果將在事務回滾之后消失。一旦包圍它的事務提交，那么其效果將持續到會話結束，除非被另外一個`SET`覆蓋。不管是否提交，`SET LOCAL`的效果只持續到當前事務結束。一個特例是在一個事務里面的`SET`后面跟著一個`SET LOCAL`：在事務結束之前只能看到`SET LOCAL`的數值，但是之后(如果事務提交)，則是`SET`的值生效。 `SET`或`SET LOCAL`的影響也可以通過回滾到一個命令之前的保存點取消。如果`SET LOCAL`在一個對相同變量有`SET`選項的函數內使用 (請參閱[CREATE FUNCTION](#calibre_link-4))，`SET LOCAL` 命令的影響在函數退出時消失；也就是說，函數調用時起作用的值不論如何都會還原。這允許`SET LOCAL`用來對函數內的一個參數進行動態和反復修改，盡管仍然方便使用`SET`選項來保存和存儲調用程序的值。然而，規則的`SET`命令重寫任何函數內的`SET`選項；其影響將會持續，除非回滾。 > **Note:** 在PostgreSQL 8.0到8.2版本中，一個`SET LOCAL` 的影響將通過釋放一個較早的保存點被取消，或者通過從一個PL/pgSQL 異常塊成功退出。該選項已被更改，因為它被認為是非直觀的。 ## 參數 `SESSION` 聲明這個命令只對當前會話起作用。如果`SESSION`或`LOCAL`都沒出現，那么這個是缺省。 `LOCAL` 聲明該命令只在當前事務中有效。在`COMMIT`或者`ROLLBACK`之后，會話級別的設置將再次生效。請注意如果在`BEGIN`塊之外運行，那么`SET LOCAL`將表現出沒有作用，因為事務將立即結束。 `_configuration_parameter_` 可設置的運行時參數的名字。可用的參數在[Chapter 18](#calibre_link-500)和下面有文檔。 `_value_` 參數的新值。值可以聲明為字符串常量、標識符、數字，或者逗號分隔的上面這些東西的列表，視特定變量而定。對于特定參數是恰當的。可以寫出`DEFAULT` 把這些參數設置為它們的缺省值。（也就是說，如果在當前會話中沒有`SET`執行，已有的任何數值都會設置。）除了在[Chapter 18](#calibre_link-500)里面有文檔記載的配置參數之外，還有幾個只能用`SET`命令設置，或者是有特殊的語法的參數。 `SCHEMA` `SET SCHEMA '``_value_`'是`SET search_path TO` `_value_`的別名。使用該語法只可指定一個模式。 `NAMES` `SET NAMES` `_value_`是`SET client_encoding TO` `_value_`的別名。 `SEED` 為隨機數生成器(函數`random`)設置內部的種子。允許的值是介于 -1 和 1 之間的浮點數，然后它會被乘以 2<sup class="calibre28">31</sup>-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`缺省值)。參閱[Section 8.5.3](#calibre_link-792)獲取有關時區的更多細節。 ## 注意函數`set_config`提供了等效的功能。參閱[Section 9.26](#calibre_link-1334)。同時，可以UPDATE這個[`pg_settings`](#calibre_link-967) 系統視圖來執行`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](#calibre_link-1211), [SHOW](#calibre_link-509)