# 51.85. pg\_settings

檢視表 pg\_settings 提供對伺服器的執行時參數的存取。它本質上是 [SHOW](https://docs.postgresql.tw/13/reference/sql-commands/show) 和 [SET ](https://docs.postgresql.tw/13/reference/sql-commands/set)指令的替代介面。它也提供 SHOW 無法直接獲得的一些資訊存取，例如最小值和最大值。

####  **Table 51.86. `pg_settings` Columns**

| <p>Column Type</p><p>Description</p>                                                                                                                            |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><code>name</code> <code>text</code></p><p>執行階段的組態參數名稱</p>                                                                                                    |
| <p><code>setting</code> <code>text</code></p><p>參數的現值</p>                                                                                                       |
| <p><code>unit</code> <code>text</code></p><p>參數隱含的單位</p>                                                                                                        |
| <p><code>category</code> <code>text</code></p><p>參數的邏輯分類</p>                                                                                                    |
| <p><code>short\_desc</code> <code>text</code></p><p>參數的簡要說明</p>                                                                                                 |
| <p><code>extra\_desc</code> <code>text</code></p><p>更進一步的詳細參數說明</p>                                                                                             |
| <p><code>context</code> <code>text</code></p><p>組態參數值的必要內容（詳見下文）</p>                                                                                            |
| <p><code>vartype</code> <code>text</code></p><p>參數型別（bool、enum、integer、real 或 string）</p>                                                                       |
| <p><code>source</code> <code>text</code></p><p>目前參數值的來源</p>                                                                                                     |
| <p><code>min\_val</code> <code>text</code></p><p>參數的最小允許值（非數字型別為 null）</p>                                                                                      |
| <p><code>max\_val</code> <code>text</code></p><p>參數的最大允許值（非數字型別為 null）</p>                                                                                      |
| <p><code>enumvals</code> <code>text\[]</code></p><p>列舉參數的允許值（非列舉型別為 null）</p>                                                                                   |
| <p><code>boot\_val</code> <code>text</code></p><p>如果未另行設定參數，則在伺服器啟動時預先給予參數值</p>                                                                                 |
| <p><code>reset\_val</code> <code>text</code></p><p>RESET 將參數重置為目前連線中的值</p>                                                                                      |
| <p><code>sourcefile</code> <code>text</code></p><p>組態檔案目前設定為何（對於從組態檔案以外來源設定的值，或者由非超級使用者也不是 pg\_read\_all\_settings 的成員所給予，為null）；在組態檔案中使用 include 指令時會很有幫助。</p> |
| <p><code>sourceline</code> <code>int4</code></p><p>組態檔案中目前設定所在的行號（對於從組態檔案以外來源所設定的值，或者由非超級使用者，也不是 pg\_read\_all\_settings 成員所給予的值，則為 null）。</p>                  |
| <p><code>pending\_restart</code> <code>bool</code></p><p>如果組態檔案中的值已更改但需要重新啟動，則為 true；否則為 false。</p>                                                             |

設定內容有幾種可能的值，是為了降低變更組態的複雜度，它們是：

`internal`

這些設定無法直接更改；它們反映了內部所決定的值，其中一些可以透過使用不同的組態選項重建伺服器，或透過更改提供給 initdb 的選項來調整。

`postmaster`

這些設定只能在伺服器啟動時套用，因此任何變更都需要重新啟動伺服器。這些設定的值通常儲存在 postgresql.conf 檔案中，或在啟動伺服器時在命令列中給予。當然，也可以在伺服器啟動時設定任何層級較低的設定。

`sighup`

可以在 postgresql.conf 中對這些設定進行變更，而毌須重新啟動伺服器。只要向 postmaster 發送一個 SIGHUP 信號，使其重新讀取 postgresql.conf 並套用變更。postmaster 還會將 SIGHUP 信號轉發給其子程序，以便它們都獲取新值。

`superuser-backend`

可以在 postgresql.conf 中對這些設定進行變更，且毌須重新啟動伺服器。它們也可以在連線要求的封包中設定為特別連線（例如，透過 libpq 的 PGOPTIONS 環境變數），但前提是連線使用者是超級使用者。但是，這些設定在啟動後的連線中永遠不會變更。如果你在 postgresql.conf 中更改它們，請向 postmaster 發送一個 SIGHUP 信號，使其重新讀取 postgresql.conf。新值只會影響隨後啟動的連線。

`backend`

可以在 postgresql.conf 中對這些設定進行變更，而毌須重新啟動伺服器。它們也可以在連線請求封包中設定為特別連線（例如，透過 libpq 的 PGOPTIONS 環境變數）；任何使用者都可以為他們的連線進行這樣的變更。但是，這些設定在啟動後的連線中永遠無法變更。如果你在 postgresql.conf 中更改它們，請向 postmaster 發送一個 SIGHUP 信號，使其重新讀取 postgresql.conf。新值只會影響隨後啟動的連線。

`superuser`

這些設定可以從 postgresql.conf 設定，也可以透過 SET 指令在連線中設定；但只有超級使用者可以透過 SET 來更改。僅當沒有使用 SET 建立連線專用的值時，postgresql.conf 中的變更才會影響現有連線。

`user`

這些設定可以從 postgresql.conf 設定，也可以透過 SET 指令在連線中設定。允許任何使用者變更其連線中所使用的值。僅當未使用 SET 未建立連線專用值時，postgresql.conf 中的變更才會影響現有連線。

有關變更這些參數的各種方法和更多資訊，請參閱[第 19.1 節](https://docs.postgresql.tw/13/server-administration/server-configuration/setting-parameters)。

pg\_settings 檢視表無法INSERT 或 DELETE，但可以 UPDATE。套用於一行 pg\_settings 的 UPDATE 相當於對該參數執行 [SET](https://docs.postgresql.tw/13/reference/sql-commands/set) 指令。此變更僅影響目前連線所使用的值。如果在稍後中止的交易事務中發出 UPDATE，則在回溯事務時 UPDATE 指令的效果會消失。一旦提交了相關的事務，則效果將持續到連線結束，除非被另一個 UPDATE 或 SET 覆蓋。