SET
Last updated
Last updated
SET — 變更執行環境參數
SET 指令變更執行環境的配置參數。中列出的許多執行環境參數都可以使用 SET 動態變更。（但有些需要超級使用者權限才能變更，有些參數則是伺服器或連線啟動後無法變更。）SET 僅影響目前連線所使用的值。
如果在稍後中止的事務中發出 SET（或等效的 SET SESSION），則在回溯事務時 SET 指令的效果也會消失。一旦提交了相關的事務，則效果將持續到連線結束，除非被另一個 SET 覆寫。
SET LOCAL 的效果僅持續到目前事務結束，無論是否已提交。一個特殊情況是在單個事務中 SET 後跟 SET LOCAL：SET LOCAL 值將一直顯示直到事務結束，但在事務之後（如果事務已提交）SET 值將生效。
透過回溯到早於指令的 savepoint，也會取消 SET 或 SET LOCAL 的效果。
如果在具有相同變數的 SET 選項函數中使用 SET LOCAL（參閱 ），則 SET LOCAL 指令的效果在函數結束時消失；也就是說，無論如何都會恢復呼叫函數時生效的值。這允許 SET LOCAL 用於函數內參數的動態或重複變更，同時仍然可以方便地使用 SET 選項來保存和恢復呼叫者的值。但是，一般 SET 指令會覆寫任何相關函數的 SET 選項；除非回溯，否則其效果將持續存在。
注意 在 PostgreSQL 版本 8.0 到 8.2 中，SET LOCAL 的效果將透過釋放較早的 savepoint 或成功退出 PL/pgSQL 例外處理來取消。此行為已被調整，因為它被認為是不直觀的。
SESSION
指定此指令對目前連線生效。（如果 SESSION 和 LOCAL 都沒有出現，這是預設行為。）
LOCAL
指定此指令僅對目前事務生效。在 COMMIT 或 ROLLBACK 之後，連線等級的設定會再次生效。在事務區塊之外發出此指令會發出警告，並且無效。
configuration_parameter
value
參數的新值。可以將值指定為字串常數、識別字、數字或逗號分隔的值列表，以適應特定參數。可以使用 DEFAULT 來指定將參數重置為其預設值（即如果在目前會話中沒有執行 SET，它將具有的值）。
SCHEMA
SET SCHEMA 'value' 是 SET search_path TO value 的別名。使用此語法只能指定一個綱要。
NAMES
SET NAMES value 是 SET client_encoding TO value 的別名。
SEED
設定隨機數産生器的內部種子（函數隨機）。允許值是介於 -1 和 1 之間的浮點數，然後乘以 2^31-1。
也可以透過呼叫 setseed 函數來設定種子：
TIME ZONE
SET TIME ZONE value 是 SET timezone TO value 的別名。語法 SET TIME ZONE 是允許時區規範的特殊語法。以下是有效值的範例：
'PST8PDT'
Berkeley, California 的時區。
'Europe/Rome'
義大利的時區。
-7
從 UTC 往西 7 小時的時區（相當於 PDT）。正值為 UTC 往東。
INTERVAL '-08:00' HOUR TO MINUTE
從 UTC 往西 8 小時的時區（相當於 PST）。
LOCAL
DEFAULT
將時區設定為本地時區（即伺服器的時區預設值）。
以數字或間隔設定的時區設定在內部轉換為 POSIX 時區語法。例如，在 SET TIME ZONE -7 之後，SHOW TIME ZONE 將回報 <-07>+07。
設定綱要（schema）搜尋路徑：
使用「日期置於月份前面」的輸入方式，將日期樣式設定為傳統 POSTGRES：
設定為 Berkeley, California 的時區：
設定為義大利的時區：
SET TIME ZONE 延伸了 SQL 標準所定義的語法。原標準僅允許數字時區語法，而 PostgreSQL 允許更靈活的時區規範。所有其他 SET 功能都是 PostgreSQL 的延伸功能。
可設定的執行環境參數名稱。可用參數記錄在及其以下小節。
除了中記錄的配置參數外，還有一些只能使用 SET 指令調整或具備的特殊語法：
有關時區的更多訊息，請參閱。
函數 set_config 提供了等效的功能；詳見 。此外，也可以更新 系統檢視表以執行 SET 的等效操作。
,