# SET

SET — 變更執行環境參數

### 語法

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

### 說明

SET 指令變更執行環境的配置參數。[第 19 章](/server-administration/server-configuration.md)中列出的許多執行環境參數都可以使用 SET 動態變更。（但有些需要超級使用者權限才能變更，有些參數則是伺服器或連線啟動後無法變更。）SET 僅影響目前連線所使用的值。

如果在稍後中止的事務中發出 SET（或等效的 SET SESSION），則在回溯事務時 SET 指令的效果也會消失。一旦提交了相關的事務，則效果將持續到連線結束，除非被另一個 SET 覆寫。

SET LOCAL 的效果僅持續到目前事務結束，無論是否已提交。一個特殊情況是在單個事務中 SET 後跟 SET LOCAL：SET LOCAL 值將一直顯示直到事務結束，但在事務之後（如果事務已提交）SET 值將生效。

透過回溯到早於指令的 savepoint，也會取消 SET 或 SET LOCAL 的效果。

如果在具有相同變數的 SET 選項函數中使用 SET LOCAL（參閱 [CREATE FUNCTION](/reference/sql-commands/create-function.md)），則 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`*

可設定的執行環境參數名稱。可用參數記錄在[第 19 章](/server-administration/server-configuration.md)及其以下小節。

*`value`*

參數的新值。可以將值指定為字串常數、識別字、數字或逗號分隔的值列表，以適應特定參數。可以使用 DEFAULT 來指定將參數重置為其預設值（即如果在目前會話中沒有執行 SET，它將具有的值）。

除了[第 19 章](/server-administration/server-configuration.md)中記錄的配置參數外，還有一些只能使用 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 函數來設定種子：

```
SELECT setseed(value);
```

`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。

有關時區的更多訊息，請參閱[第 8.5.3 節](/the-sql-language/data-types/date-time.md#8-5-3-time-zones)。

### 注意

函數 set\_config 提供了等效的功能；詳見 [9.26 節](/the-sql-language/functions-and-operators/system-administration.md)。此外，也可以更新 [pg\_settings](/internals/54.-system-views/pg_settings.md) 系統檢視表以執行 SET 的等效操作。

### 範例

設定綱要（schema）搜尋路徑：

```
SET search_path TO my_schema, public;
```

使用「日期置於月份前面」的輸入方式，將日期樣式設定為傳統 POSTGRES：

```
SET datestyle TO postgres, dmy;
```

設定為 Berkeley, California 的時區：

```
SET TIME ZONE 'PST8PDT';
```

設定為義大利的時區：

```
SET TIME ZONE 'Europe/Rome';
```

### 相容性

SET TIME ZONE 延伸了 SQL 標準所定義的語法。原標準僅允許數字時區語法，而 PostgreSQL 允許更靈活的時區規範。所有其他 SET 功能都是 PostgreSQL 的延伸功能。

### 參閱

[RESET](/reference/sql-commands/reset.md), [SHOW](/reference/sql-commands/show.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.postgresql.tw/reference/sql-commands/set.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.