PostgreSQL SET

描述

SET命令更改運行時配置參數(shù)。很多 第 19 章中列出的參數(shù)可以用 SET即時更改（但是有些需要超級用戶 特權(quán)才能更改，并且還有一些在服務(wù)器或者會話啟動之后不能被更改）。 SET只影響當前會話所使用的值。

如果在一個事務(wù)內(nèi)發(fā)出SET （或者等效的SET SESSION）而該事務(wù)后來 中止，在該事務(wù)被回滾時SET命令的效果會 消失。一旦所在的事務(wù)被提交，這些效果將會持續(xù)到會話結(jié)束（除非被另 一個SET所覆蓋）。

SET LOCAL的效果只持續(xù)到當前事務(wù)結(jié)束， 不管事務(wù)是否被提交。一種特殊情況是在一個事務(wù)內(nèi) SET后面跟著 SET LOCAL： SET LOCAL值將會在該事務(wù)結(jié)束前一直可見， 但是之后（如果該事務(wù)被提交）SET值將會生效。

SET或SET LOCAL 的效果也會因為回滾到早于它們的保存點而消失。

如果在一個函數(shù)內(nèi)使用SET LOCAL并且該函數(shù) 還有對同一變量的SET選項（見 CREATE FUNCTION），在函數(shù)退出時 SET LOCAL命令的效果會消失。也就是說，該 函數(shù)被調(diào)用時的值會被恢復。這允許用 SET LOCAL在函數(shù)內(nèi)動態(tài)地或者重復地更改 一個參數(shù)，同時仍然能便利地使用SET選項來保存以及恢復調(diào)用 者的值。不過，一個常規(guī)的SET命令會覆蓋它所在的任何函 數(shù)的SET選項，除非回滾，它的效果將一直保持。

參數(shù)

除了在第 19 章中記錄的配置參數(shù)， 還有一些參數(shù)只能用SET命令設(shè)置 或者具有特殊的語法：

注解

函數(shù)set_config提供了等效的功能，見 第 9.27 節(jié)。此外，可以更新 pg_settings 系統(tǒng)視圖來執(zhí)行與 SET等效的工作。

示例

設(shè)置模式搜索路徑：

SET search_path TO my_schema, public;

把日期風格設(shè)置為傳統(tǒng) POSTGRES的 “日在月之前”的輸入習慣：

SET datestyle TO postgres, dmy;

設(shè)置時區(qū)為加州伯克利：

SET TIME ZONE 'PST8PDT';

設(shè)置時區(qū)為意大利：

SET TIME ZONE 'Europe/Rome';

兼容性

SET TIME ZONE擴展了 SQL 標準定義的語法。標準 只允許數(shù)字的時區(qū)偏移量而 PostgreSQL允許更靈活的時區(qū)說明。 所有其他SET特性都是 PostgreSQL擴展。

另見