如果當前表輸出格式未對齊，則切換為對齊。如果未對齊，則將其設定為未對齊。此命令保留是為了向後相容。有關更通用的解決方案，請參閱 \pset。

設定下一次查詢執行的查詢引數，並將指定的引數傳遞給任何引數佔位符（$1 等）。

示例：

INSERT INTO tbl1 VALUES ($1, $2) \bind 'first value' 'second value' \g

這適用於除 \g 之外的查詢執行命令，例如 \gx 和 \gset。

此命令導致使用擴充套件查詢協議（參見 第 54.1.2 節），這與使用簡單查詢協議的正常 psql 操作不同。因此，此命令可用於從 psql 測試擴充套件查詢協議。（即使查詢沒有引數並且此命令指定零引數，也使用擴充套件查詢協議。）此命令僅影響下一個執行的查詢；所有後續查詢將預設使用簡單查詢協議。

\bind_named 等同於 \bind，但它將現有預備語句的名稱作為第一個引數。空字串表示未命名的預備語句。

示例：

INSERT INTO tbls1 VALUES ($1, $2) \parse stmt1
\bind_named stmt1 'first value' 'second value' \g

此命令導致使用擴充套件查詢協議（參見 第 54.1.2 節），這與使用簡單查詢協議的正常 psql 操作不同。因此，此命令可用於從 psql 測試擴充套件查詢協議。

建立與 PostgreSQL 伺服器的新連線。要使用的連線引數可以透過位置語法（一個或多個數據庫名稱、使用者、主機和埠）或使用 第 32.1.1 節 中詳細描述的 conninfo 連線字串來指定。如果沒有給定引數，則使用與以前相同的引數建立新連線。

將 dbname、username、host 或 port 中的任何一個指定為 - 等同於省略該引數。

新連線可以重用先前連線的連線引數；不僅是資料庫名稱、使用者、主機和埠，還有其他設定，例如 sslmode。預設情況下，引數在位置語法中重用，但在給出 conninfo 字串時則不重用。傳遞第一個引數 -reuse-previous=on 或 -reuse-previous=off 會覆蓋該預設值。如果引數被重用，則任何未明確指定為位置引數或在 conninfo 字串中的引數都將從現有連線的引數中獲取。一個例外是，如果使用位置語法將 host 設定從其先前值更改，則現有連線引數中存在的任何 hostaddr 設定都將被刪除。此外，用於現有連線的任何密碼僅在使用者、主機和埠設定未更改時才會被重用。當命令既未指定也未重用特定引數時，將使用 libpq 預設值。

如果成功建立新連線，則關閉先前的連線。如果連線嘗試失敗（使用者名稱錯誤、訪問被拒絕等），則如果 psql 處於互動模式，則會保留先前的連線。但是，當執行非互動式指令碼時，舊連線將被關閉並報告錯誤。這可能會或可能不會終止指令碼；如果不會，所有資料庫訪問命令都將失敗，直到成功執行另一個 \connect 命令。這種區別一方面是為了使用者方便避免打字錯誤，另一方面是為了安全機制，防止指令碼意外地作用於錯誤的資料庫。請注意，無論何時 \connect 命令嘗試重用引數，重用的值都是上次成功連線的值，而不是隨後任何失敗嘗試的值。但是，在非互動式 \connect 失敗的情況下，不允許稍後重用任何引數，因為指令碼可能期望重用失敗的 \connect 中的值。

示例

=> \c mydb myuser host.dom 6432
=> \c service=foo
=> \c "host=localhost port=5432 dbname=mydb connect_timeout=10 sslmode=disable"
=> \c -reuse-previous=on sslmode=require    -- changes only sslmode
=> \c postgresql://tom@localhost/mydb?application_name=myapp

設定作為查詢結果列印的任何表的標題或取消設定任何此類標題。此命令等同於 \pset title title。（此命令的名稱來源於“caption”，因為它以前僅用於設定表中的標題。）HTML表。）

將當前工作目錄更改為 directory。不帶引數時，更改為當前使用者的主目錄。有關如何查詢主目錄的詳細資訊，請參見 第 32.16 節。

關閉指定的預備語句。空字串表示未命名的預備語句。如果不存在具有此名稱的預備語句，則操作為空操作。

示例：

SELECT $1 \parse stmt1
\close_prepared stmt1

此命令導致使用擴充套件查詢協議，這與使用簡單查詢協議的正常 psql 操作不同。因此，此命令可用於從 psql 測試擴充套件查詢協議。

輸出有關當前資料庫連線的資訊，如果使用 SSL，則包括與 SSL 相關的資訊。

請注意，Client User 欄位顯示連線時的使用者，而 Superuser 欄位指示當前使用者（在當前執行上下文中）是否具有超級使用者許可權。這些使用者通常相同，但它們可能不同，例如，如果當前使用者已透過 SET ROLE 命令更改。

執行前端（客戶端）複製。這是一個執行一個SQL COPY 命令的操作，但不是伺服器讀取或寫入指定檔案，而是 psql 讀取或寫入檔案並在伺服器和本地檔案系統之間路由資料。這意味著檔案可訪問性和許可權是本地使用者的，而不是伺服器的，並且不需要 SQL 超級使用者許可權。

當指定 program 時，psql 執行 command，資料在伺服器和客戶端之間路由，從 command 傳遞或傳遞給 command。同樣，執行許可權是本地使用者的，而不是伺服器的，並且不需要 SQL 超級使用者許可權。

對於 \copy ... from stdin，資料行從發出命令的同一源讀取，直到讀取到只包含 \. 的行或流到達檔案結束。此選項對於在 SQL 指令碼檔案中內聯填充表很有用。對於 \copy ... to stdout，輸出傳送到與 psql 命令輸出相同的位置，並且不列印 COPY count 命令狀態（因為它可能與資料行混淆）。要讀取/寫入 psql 的標準輸入或輸出，無論當前的命令源或 \o 選項如何，請寫入 from pstdin 或 to pstdout。

此命令的語法與SQL COPY 命令的語法相似。除了資料來源/目標之外的所有選項都按照 COPY 的規定。因此，特殊的解析規則適用於 \copy 元命令。與大多數其他元命令不同，行的其餘部分始終被視為 \copy 的引數，並且引數中不執行變數插值和反引號擴充套件。

顯示 PostgreSQL 的版權和分發條款。

執行當前查詢緩衝區（如 \g）並以交叉表網格顯示結果。查詢必須至少返回三列。由 colV 標識的輸出列成為垂直標題，由 colH 標識的輸出列成為水平標題。colD 標識要在網格中顯示的輸出列。sortcolH 標識水平標題的可選排序列。

每個列規範可以是列號（從 1 開始）或列名。通常的 SQL 大小寫摺疊和引用規則適用於列名。如果省略，colV 被視為第 1 列，colH 被視為第 2 列。colH 必須不同於 colV。如果未指定 colD，則查詢結果中必須正好有三列，並且既不是 colV 也不是 colH 的列被視為 colD。

垂直標題，顯示為最左邊的列，包含在 colV 列中找到的值，順序與查詢結果中的順序相同，但刪除了重複項。

水平標題，顯示為第一行，包含在 colH 列中找到的值，並刪除了重複項。預設情況下，這些值以與查詢結果中相同的順序顯示。但是，如果給定了可選的 sortcolH 引數，它將標識一個列，其值必須是整數，並且來自 colH 的值將根據相應的 sortcolH 值排序後出現在水平標題中。

在交叉表網格中，對於 colH 的每個不同值 x 和 colV 的每個不同值 y，位於交點 (x,y) 的單元格包含查詢結果行中 colD 列的值，其中 colH 的值為 x 且 colV 的值為 y。如果沒有這樣的行，則單元格為空。如果存在多行，則報告錯誤。

對於與 pattern 匹配的每個關係（表、檢視、物化檢視、索引、序列或外部表）或複合型別，顯示所有列、它們的型別、表空間（如果不是預設值）以及任何特殊屬性，例如 NOT NULL 或預設值。還顯示相關的索引、約束、規則和觸發器。對於外部表，還顯示相關的外部伺服器。（“匹配模式”的定義見下面的 模式。）

對於某些型別的關係，\d 為每列顯示額外資訊：序列的列值、索引的索引表示式以及外部表的外部資料封裝器選項。

命令形式 \d+ 相同，但顯示更多資訊：顯示與表列關聯的任何註釋，以及表中 OID 的存在，如果關係是檢視，則顯示檢視定義，非預設的 複製身份 設定以及如果關係具有訪問方法，則顯示 訪問方法 名稱。

預設情況下，只顯示使用者建立的物件；提供模式或 S 修飾符以包含系統物件。

列出聚合函式，以及它們的返回型別和它們操作的資料型別。如果指定了 pattern，則只顯示名稱匹配模式的聚合。預設情況下，只顯示使用者建立的物件；提供模式或 S 修飾符以包含系統物件。如果在命令名稱後附加 x，則結果以擴充套件模式顯示。

列出訪問方法。如果指定了 pattern，則只顯示名稱匹配模式的訪問方法。如果在命令名稱後附加 x，則結果以擴充套件模式顯示。如果在命令名稱後附加 +，則每個訪問方法都與其關聯的處理函式和描述一起列出。

列出運算子類（參見 第 36.16.1 節）。如果指定了 access-method-pattern，則只列出與名稱匹配該模式的訪問方法關聯的運算子類。如果指定了 input-type-pattern，則只列出與名稱匹配該模式的輸入型別關聯的運算子類。如果在命令名稱後附加 x，則結果以擴充套件模式顯示。如果在命令名稱後附加 +，則每個運算子類都與其關聯的運算子族和所有者一起列出。

列出運算子族（參見 第 36.16.5 節）。如果指定了 access-method-pattern，則只列出與名稱匹配該模式的訪問方法相關聯的運算子族。如果指定了 input-type-pattern，則只列出與名稱匹配該模式的輸入型別相關聯的運算子族。如果在命令名稱後附加 x，則結果以擴充套件模式顯示。如果在命令名稱後附加 +，則每個運算子族都與其所有者一起列出。

列出與運算子族關聯的運算子（參見 第 36.16.2 節）。如果指定了 access-method-pattern，則只列出與名稱匹配該模式的訪問方法相關聯的運算子族的成員。如果指定了 operator-family-pattern，則只列出與名稱匹配該模式的運算子族的成員。如果在命令名稱後附加 x，則結果以擴充套件模式顯示。如果在命令名稱後附加 +，則每個運算子都與其排序運算子族（如果它是排序運算子）一起列出，以及其底層函式是否防洩漏。

列出與運算子族關聯的支援函式（參見 第 36.16.3 節）。如果指定了 access-method-pattern，則只列出與名稱匹配該模式的訪問方法關聯的運算子族中的函式。如果指定了 operator-family-pattern，則只列出與名稱匹配該模式的運算子族中的函式。如果在命令名稱後附加 x，則結果以擴充套件模式顯示。如果在命令名稱後附加 +，則函式將以詳細模式顯示，並帶有其實際引數列表。

列出表空間。如果指定了 pattern，則只顯示名稱匹配模式的表空間。如果在命令名稱後附加 x，則結果以擴充套件模式顯示。如果在命令名稱後附加 +，則每個表空間都與其關聯的選項、磁碟大小、許可權和描述一起列出。

列出字元集編碼之間的轉換。如果指定了 pattern，則只列出名稱匹配該模式的轉換。預設情況下，只顯示使用者建立的物件；提供模式或 S 修飾符以包含系統物件。如果在命令名稱後附加 x，則結果以擴充套件模式顯示。如果在命令名稱後附加 +，則每個物件都與其關聯的描述一起列出。

列出伺服器配置引數及其值。如果指定了 pattern，則只列出名稱匹配該模式的引數。如果沒有 pattern，則只列出設定為非預設值的引數。（使用 \dconfig * 檢視所有引數。）如果在命令名稱後附加 x，則結果以擴充套件模式顯示。如果在命令名稱後附加 +，則每個引數都與其資料型別、可以設定引數的上下文以及訪問許可權（如果已授予非預設訪問許可權）一起列出。

列出型別轉換。如果指定了 pattern，則只列出源型別或目標型別匹配該模式的轉換。如果在命令名稱後附加 x，則結果以擴充套件模式顯示。如果在命令名稱後附加 +，則顯示每個轉換的附加資訊，包括其底層函式是否防洩漏以及轉換的描述。

顯示型別為 constraint、operator class、operator family、rule 和 trigger 的物件的描述。所有其他註釋可以透過這些物件型別各自的反斜槓命令檢視。

\dd 顯示與 pattern 匹配的物件的描述，如果未給出引數，則顯示適當型別的可見物件的描述。但在這兩種情況下，只列出具有描述的物件。預設情況下，只顯示使用者建立的物件；提供模式或 S 修飾符以包含系統物件。如果在命令名稱後附加 x，則結果以擴充套件模式顯示。

可以使用 COMMENT 命令建立物件的描述。SQL命令。

列出域。如果指定了 pattern，則只顯示名稱匹配模式的域。預設情況下，只顯示使用者建立的物件；提供模式或 S 修飾符以包含系統物件。如果在命令名稱後附加 x，則結果以擴充套件模式顯示。如果在命令名稱後附加 +，則每個物件都與其關聯的許可權和描述一起列出。

列出預設訪問許可權設定。對於每個預設許可權設定已從內建預設值更改的角色（以及適用的模式），都會顯示一個條目。如果指定了 pattern，則只列出其角色名或模式名匹配該模式的條目。如果在命令名稱後附加 x，則結果以擴充套件模式顯示。

ALTER DEFAULT PRIVILEGES 命令用於設定預設訪問許可權。許可權顯示的含義在 第 5.8 節 中解釋。

在此組命令中，字母 E、i、m、s、t 和 v 分別代表外部表、索引、物化檢視、序列、表和檢視。您可以指定其中任何或所有字母，按任意順序，以獲取這些型別的物件的列表。例如，\dti 列出表和索引。如果在命令名稱後附加 x，則結果以擴充套件模式顯示。如果在命令名稱後附加 +，則每個物件都與其持久狀態（永久、臨時或未記錄）、磁碟上的物理大小以及任何關聯的描述一起列出。如果指定了 pattern，則只列出名稱匹配該模式的物件。預設情況下，只顯示使用者建立的物件；提供模式或 S 修飾符以包含系統物件。

列出外部伺服器（助記：“外部伺服器”）。如果指定了pattern，則只列出名稱與該模式匹配的伺服器。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則顯示每個伺服器的完整描述，包括伺服器的訪問許可權、型別、版本、選項和描述。

列出外部表（助記：“外部表”）。如果指定了pattern，則只列出表名或模式名與該模式匹配的條目。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則還顯示通用選項和外部表描述。

列出使用者對映（助記：“外部使用者”）。如果指定了pattern，則只列出使用者名稱與該模式匹配的對映。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則顯示每個對映的附加資訊。

列出外部資料包裝器（助記：“外部包裝器”）。如果指定了pattern，則只列出名稱與該模式匹配的外部資料包裝器。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則還顯示外部資料包裝器的訪問許可權、選項和描述。

列出函式，以及它們的返回資料型別、引數資料型別和函式型別，函式型別分類為“agg”（聚合）、“normal”（普通）、“procedure”（過程）、“trigger”（觸發器）或“window”（視窗）。要只顯示特定型別的函式，請向命令新增相應的字母a、n、p、t或w。如果指定了pattern，則只顯示名稱與該模式匹配的函式。任何附加引數都是型別名稱模式，它們將與函式的第一個、第二個等引數的型別名稱匹配。（匹配的函式可以擁有比您指定的更多引數。為了防止這種情況，請將破折號-作為最後一個arg_pattern寫入。）預設情況下，只顯示使用者建立的物件；提供模式或S修飾符以包含系統物件。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則顯示每個函式的附加資訊，包括易變性、並行安全性、所有者、安全分類、是否防洩漏、訪問許可權、語言、內部名稱（僅適用於C和內部函式）以及描述。可以使用\sf檢視特定函式的原始碼。

列出文字搜尋配置。如果指定了pattern，則只顯示名稱與該模式匹配的配置。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則顯示每個配置的完整描述，包括底層文字搜尋解析器和每個解析器令牌型別的字典列表。

列出文字搜尋字典。如果指定了pattern，則只顯示名稱與該模式匹配的字典。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則顯示每個選定字典的附加資訊，包括底層文字搜尋模板和選項值。

列出文字搜尋解析器。如果指定了pattern，則只顯示名稱與該模式匹配的解析器。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則顯示每個解析器的完整描述，包括底層函式和識別的令牌型別列表。

列出文字搜尋模板。如果指定了pattern，則只顯示名稱與該模式匹配的模板。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則顯示每個模板的附加資訊，包括底層函式名稱。

列出資料庫角色。（由於“使用者”和“組”的概念已統一為“角色”，因此此命令現在等效於\du。）預設情況下，只顯示使用者建立的角色；提供S修飾符以包含系統角色。如果指定了pattern，則只列出名稱與該模式匹配的角色。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則顯示每個角色的附加資訊；目前，這會新增每個角色的註釋。

這是\lo_list的別名，顯示大型物件列表。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則每個大型物件都將列出其關聯的許可權（如果有）。

列出過程語言。如果指定了pattern，則只列出名稱與該模式匹配的語言。預設情況下，只顯示使用者建立的語言；提供S修飾符以包含系統物件。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則每個語言都將列出其呼叫處理程式、驗證器、訪問許可權以及它是否為系統物件。

列出模式（名稱空間）。如果指定了pattern，則只列出名稱與該模式匹配的模式。預設情況下，只顯示使用者建立的物件；提供模式或S修飾符以包含系統物件。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則每個物件都將列出其關聯的許可權和描述（如果有）。

列出運算子及其運算元和結果型別。如果指定了pattern，則只列出名稱與該模式匹配的運算子。如果指定了一個arg_pattern，則只列出右引數型別名稱與該模式匹配的字首運算子。如果指定了兩個arg_pattern，則只列出引數型別名稱與這些模式匹配的二元運算子。（或者，對於一元運算子的未使用引數，寫入-。）預設情況下，只顯示使用者建立的物件；提供模式或S修飾符以包含系統物件。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則顯示每個運算子的附加資訊，包括底層函式的名稱以及它是否防洩漏。

列出排序規則。如果指定了pattern，則只列出名稱與該模式匹配的排序規則。預設情況下，只顯示使用者建立的物件；提供模式或S修飾符以包含系統物件。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則每個排序規則都將列出其關聯的描述（如果有）。請注意，只顯示當前資料庫編碼可用的排序規則，因此在同一安裝的不同資料庫中，結果可能會有所不同。

列出表、檢視和序列及其關聯的訪問許可權。如果指定了pattern，則只列出名稱與該模式匹配的表、檢視和序列。預設情況下，只顯示使用者建立的物件；提供模式或S修飾符以包含系統物件。如果命令名稱後附加了x，則結果以擴充套件模式顯示。

GRANT和REVOKE命令用於設定訪問許可權。許可權顯示的含義在第5.8節中解釋。

列出分割槽關係。如果指定了pattern，則只列出名稱與該模式匹配的條目。修飾符t（表）和i（索引）可以附加到命令後，以過濾要列出的關係型別。預設情況下，列出分割槽表和索引。

如果使用修飾符n（“巢狀”），或指定了模式，則包含非根分割槽關係，並顯示一列以顯示每個分割槽關係的父級。

如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則還顯示每個關係分割槽的大小總和，以及關係的描述。如果n與+結合使用，則顯示兩個大小：一個包括直接附加的葉分割槽的總大小，另一個顯示所有分割槽的總大小，包括間接附加的子分割槽。

列出已定義的配置設定。這些設定可以是角色特定的、資料庫特定的，或兩者兼有。role-pattern和database-pattern分別用於選擇要列出的特定角色和資料庫。如果省略，或指定*，則列出所有設定，包括那些不是角色特定的或資料庫特定的設定。如果命令名稱後附加了x，則結果以擴充套件模式顯示。

ALTER ROLE和ALTER DATABASE命令用於定義每個角色和每個資料庫的配置設定。

列出有關每個已授予角色成員資格的資訊，包括分配的選項（ADMIN、INHERIT和/或SET）和授權者。有關角色成員資格的資訊，請參閱GRANT命令。

預設情況下，只顯示授予使用者建立的角色的許可權；提供S修飾符以包含系統角色。如果指定了pattern，則只列出授予名稱與該模式匹配的角色的許可權。如果命令名稱後附加了x，則結果以擴充套件模式顯示。

列出複製釋出。如果指定了pattern，則只列出名稱與該模式匹配的釋出。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則還顯示與每個釋出關聯的表和模式。

列出複製訂閱。如果指定了pattern，則只列出名稱與該模式匹配的訂閱。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則顯示訂閱的附加屬性。

列出資料型別。如果指定了pattern，則只列出名稱與該模式匹配的型別。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則每個型別都將列出其內部名稱和大小，如果它是enum型別，則列出其允許值，以及其關聯的許可權。預設情況下，只顯示使用者建立的物件；提供模式或S修飾符以包含系統物件。

列出資料庫角色。（由於“使用者”和“組”的概念已統一為“角色”，因此此命令現在等效於\dg。）預設情況下，只顯示使用者建立的角色；提供S修飾符以包含系統角色。如果指定了pattern，則只列出名稱與該模式匹配的角色。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則顯示每個角色的附加資訊；目前，這會新增每個角色的註釋。

列出已安裝的擴充套件。如果指定了pattern，則只列出名稱與該模式匹配的擴充套件。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則列出屬於每個匹配擴充套件的所有物件。

列出擴充套件統計資訊。如果指定了pattern，則只列出名稱與該模式匹配的擴充套件統計資訊。如果命令名稱後附加了x，則結果以擴充套件模式顯示。

每種擴充套件統計資訊的狀態顯示在其統計資訊型別命名的列中（例如 Ndistinct）。defined表示在建立統計資訊時已請求，NULL表示未請求。如果您想知道是否已執行ANALYZE以及統計資訊是否可用於規劃器，可以使用pg_stats_ext。

列出事件觸發器。如果指定了pattern，則只列出名稱與該模式匹配的事件觸發器。如果命令名稱後附加了x，則結果以擴充套件模式顯示。如果命令名稱後附加了+，則每個物件都將列出其關聯的描述。

如果指定了filename，則編輯該檔案；編輯器退出後，檔案內容將複製到當前查詢緩衝區中。如果沒有給出filename，則當前查詢緩衝區將複製到一個臨時檔案，然後以相同方式編輯。或者，如果當前查詢緩衝區為空，則最近執行的查詢將複製到一個臨時檔案並以相同方式編輯。

如果您編輯檔案或以前的查詢，並且在不修改檔案的情況下退出編輯器，則查詢緩衝區將被清除。否則，查詢緩衝區的新內容將根據psql的正常規則重新解析，將整個緩衝區視為單行。任何完整的查詢都會立即執行；也就是說，如果查詢緩衝區包含或以分號結尾，則到該點為止的所有內容都將執行並從查詢緩衝區中移除。查詢緩衝區中剩餘的任何內容都將重新顯示。鍵入分號或\g傳送它，或\r透過清除查詢緩衝區來取消它。

將緩衝區視為單行主要影響元命令：元命令後緩衝區中的任何內容都將被視為元命令的引數，即使它跨多行。（因此，您不能以這種方式建立使用元命令的指令碼。為此請使用\i。）

如果指定了行號，psql將把游標定位在檔案或查詢緩衝區的指定行上。請注意，如果給出了一個全數字引數，psql假定它是一個行號，而不是檔名。

將評估的引數列印到標準輸出，以空格分隔，後跟換行符。這對於在指令碼輸出中插入資訊很有用。例如

=> \echo `date`
Tue Oct 26 21:40:57 CEST 1999

如果第一個引數是未加引號的-n，則不寫入尾隨換行符（也不寫入第一個引數）。

此命令以CREATE OR REPLACE FUNCTION或CREATE OR REPLACE PROCEDURE命令的形式獲取並編輯命名函式的定義。編輯方式與\edit相同。如果您在不儲存的情況下退出編輯器，則該語句將被丟棄。如果您儲存並退出編輯器，如果您為其添加了分號，則更新的命令會立即執行。否則它會重新顯示；鍵入分號或\g傳送它，或\r取消。

目標函式可以僅透過名稱指定，也可以透過名稱和引數指定，例如foo(integer, text)。如果存在多個同名函式，則必須給出引數型別。

如果未指定函式，則會顯示一個空白的CREATE FUNCTION模板供編輯。

如果指定了行號，psql將把游標定位在函式體的指定行上。（請注意，函式體通常不是從檔案的第一行開始。）

與大多數其他元命令不同，行的其餘部分始終被視為\ef的引數，並且在引數中不執行變數插值或反引號擴充套件。

設定客戶端字元集編碼。如果沒有引數，此命令會顯示當前編碼。

以最大詳細程度重複最近的伺服器錯誤訊息，就像VERBOSITY設定為verbose且SHOW_CONTEXT設定為always一樣。

此命令以CREATE OR REPLACE VIEW命令的形式獲取並編輯命名檢視的定義。編輯方式與\edit相同。如果您在不儲存的情況下退出編輯器，則該語句將被丟棄。如果您儲存並退出編輯器，如果您為其添加了分號，則更新的命令會立即執行。否則它會重新顯示；鍵入分號或\g傳送它，或\r取消。

如果未指定檢視，則會顯示一個空白的CREATE VIEW模板供編輯。

如果指定了行號，psql將把游標定位在檢視定義的指定行上。

與大多數其他元命令不同，行的其餘部分始終被視為\ev的引數，並且在引數中不執行變數插值或反引號擴充套件。

設定未對齊查詢輸出的欄位分隔符。預設值為豎線（|）。它等效於\pset fieldsep。

將當前查詢緩衝區傳送到伺服器執行。

如果在\g之後出現括號，它們會圍繞一個以空格分隔的option=value格式化選項子句列表，這些子句的解釋方式與\pset option value命令相同，但僅在此查詢期間生效。在此列表中，等號=周圍不允許有空格，但選項子句之間必須有空格。如果省略=value，則命名option的更改方式與\pset option沒有明確value時相同。

如果給出了filename或|command引數，則查詢的輸出將寫入指定檔案或透過管道傳輸到給定shell命令，而不是像往常一樣顯示。只有當查詢成功返回零個或多個元組時才寫入檔案或命令，如果查詢失敗或是非資料返回的SQL命令則不寫入。

如果當前查詢緩衝區為空，則重新執行最近傳送的查詢。除了此行為外，不帶任何引數的\g本質上等同於一個分號。帶引數的\g提供了\o命令的“一次性”替代方案，並且還允許對通常由\pset設定的輸出格式選項進行一次性調整。

當最後一個引數以|開頭時，行的其餘部分都被視為要執行的command，並且不執行變數插值或反引號擴充套件。行的其餘部分只是字面上地傳遞給shell。

顯示當前查詢緩衝區的查詢結果的描述（即列名和資料型別）。查詢實際上並未執行；但是，如果其中包含某種語法錯誤，該錯誤將以正常方式報告。

如果當前查詢緩衝區為空，則會轉而描述最近傳送的查詢。

獲取環境變數 env_var 的值並將其賦給 psql 變數 psql_var。如果 env_var 在 psql 程序的環境中未定義，則 psql_var 不會更改。示例

=> \getenv home HOME
=> \echo :home
/home/postgres

將當前查詢緩衝區傳送到伺服器，然後將查詢輸出（如果有）的每一行的每一列視為要執行的 SQL 語句。例如，要在 my_table 的每一列上建立一個索引

=> SELECT format('create index on my_table(%I)', attname)
-> FROM pg_attribute
-> WHERE attrelid = 'my_table'::regclass AND attnum > 0
-> ORDER BY attnum
-> \gexec
CREATE INDEX
CREATE INDEX
CREATE INDEX
CREATE INDEX

生成的查詢按行返回的順序執行，如果有多列，則在每行中從左到右執行。NULL 欄位將被忽略。生成的查詢將按字面意思傳送到伺服器進行處理，因此它們不能是 psql 元命令，也不能包含 psql 變數引用。如果任何單個查詢失敗，除非設定了 ON_ERROR_STOP，否則其餘查詢的執行將繼續。每個查詢的執行都受 ECHO 處理的約束。（在使用 \gexec 時，通常建議將 ECHO 設定為 all 或 queries。）查詢日誌記錄、單步模式、計時和其他查詢執行功能也適用於每個生成的查詢。

如果當前查詢緩衝區為空，則會重新執行最近傳送的查詢。

將當前查詢緩衝區傳送到伺服器，並將查詢的輸出儲存到 psql 變數中（參見下面的 變數）。要執行的查詢必須恰好返回一行。行的每一列都儲存在一個單獨的變數中，變數名與列名相同。例如

=> SELECT 'hello' AS var1, 10 AS var2
-> \gset
=> \echo :var1 :var2
hello 10

如果指定 prefix，則該字串會新增到查詢的列名前面，以建立要使用的變數名

=> SELECT 'hello' AS var1, 10 AS var2
-> \gset result_
=> \echo :result_var1 :result_var2
hello 10

如果列結果為 NULL，則相應的變數將被取消設定，而不是被設定。

如果查詢失敗或未返回一行，則不會更改任何變數。

如果當前查詢緩衝區為空，則會重新執行最近傳送的查詢。

\gx 等效於 \g，不同之處在於它強制對該查詢使用擴充套件輸出模式，就像 expanded=on 包含在 \pset 選項列表中一樣。另請參見 \x。

提供有關指定SQL命令的語法幫助。如果未指定 command，則 psql 將列出所有可用的語法幫助命令。如果 command 是星號 (*)，則顯示所有SQL命令的語法幫助。

與大多數其他元命令不同，行的其餘部分始終被視為 \help 的引數，並且在引數中不執行變數插值或反引號擴充套件。

開啟HTML查詢輸出格式。如果HTML格式已開啟，則會切換回預設的對齊文字格式。此命令用於相容性和便利性，但有關設定其他輸出選項的資訊，請參見 \pset。

從檔案 filename 讀取輸入並執行它，就像它是在鍵盤上輸入的一樣。

如果 filename 是 -（連字元），則會讀取標準輸入，直到遇到 EOF 指示或 \q 元命令。這可用於將互動式輸入與檔案輸入交錯。請注意，只有當 Readline 在最外層處於活動狀態時，才會使用 Readline 行為。

這組命令實現了可巢狀的條件塊。條件塊必須以 \if 開頭，以 \endif 結尾。之間可以有任意數量的 \elif 子句，後面可以可選地跟一個 \else 子句。普通查詢和其他型別的反斜槓命令可以（並且通常會）出現在構成條件塊的命令之間。

\if 和 \elif 命令讀取其引數並將其評估為布林表示式。如果表示式產生 true，則處理正常繼續；否則，跳過行直到達到匹配的 \elif、\else 或 \endif。一旦 \if 或 \elif 測試成功，同一塊中後續 \elif 命令的引數將不進行評估，並被視為 false。只有在沒有先前的匹配 \if 或 \elif 成功的情況下，才處理 \else 後面的行。

\if 或 \elif 命令的 expression 引數像任何其他反斜槓命令引數一樣，受變數插值和反引號擴充套件的影響。之後，它像開/關選項變數的值一樣進行評估。因此，有效值是以下任意一個的明確不區分大小寫匹配：true、false、1、0、on、off、yes、no。例如，t、T 和 tR 都將被視為 true。

不能正確評估為 true 或 false 的表示式將生成警告並被視為 false。

被跳過的行會正常解析以識別查詢和反斜槓命令，但查詢不會發送到伺服器，並且條件（\if、\elif、\else、\endif）以外的反斜槓命令將被忽略。條件命令僅檢查有效巢狀。跳過的行中的變數引用不會擴充套件，也不會執行反引號擴充套件。

給定條件塊的所有反斜槓命令必須出現在同一原始檔中。如果在所有本地 \if 塊關閉之前，主輸入檔案或 \include-ed 檔案達到 EOF，則 psql 將引發錯誤。

以下是一個例子

-- check for the existence of two separate records in the database and store
-- the results in separate psql variables
SELECT
    EXISTS(SELECT 1 FROM customer WHERE customer_id = 123) as is_customer,
    EXISTS(SELECT 1 FROM employee WHERE employee_id = 456) as is_employee
\gset
\if :is_customer
    SELECT * FROM customer WHERE customer_id = 123;
\elif :is_employee
    \echo 'is not a customer but is an employee'
    SELECT * FROM employee WHERE employee_id = 456;
\else
    \if yes
        \echo 'not a customer or employee'
    \else
        \echo 'this will never print'
    \endif
\endif

\ir 命令類似於 \i，但以不同的方式解析相對檔名。在互動模式下執行時，這兩個命令的行為相同。但是，從指令碼呼叫時，\ir 將檔名解釋為相對於指令碼所在目錄，而不是當前工作目錄。

列出伺服器中的資料庫，並顯示它們的名稱、所有者、字元集編碼和訪問許可權。如果指定了 pattern，則只列出名稱與模式匹配的資料庫。如果命令名稱後附加 x，則結果以擴充套件模式顯示。如果命令名稱後附加 +，則還會顯示資料庫大小、預設表空間和描述。（大小資訊僅適用於當前使用者可以連線的資料庫。）

從資料庫中讀取具有OID loid 的大物件，並將其寫入 filename。請注意，這與伺服器函式 lo_export 有細微差別，後者以資料庫伺服器執行使用者的許可權和伺服器的檔案系統操作。

將檔案儲存到 PostgreSQL 大物件中。可以選擇將給定的註釋與物件關聯。示例

foo=> \lo_import '/home/peter/pictures/photo.xcf' 'a picture of me'
lo_import 152801

響應表明大物件收到了物件 ID 152801，該 ID 可用於將來訪問新建立的大物件。為了可讀性，建議始終為每個物件關聯一個人類可讀的註釋。OID 和註釋都可以透過 \lo_list 命令檢視。

請注意，此命令與伺服器端 lo_import 有細微差別，因為它在本地檔案系統上作為本地使用者操作，而不是伺服器的使用者和檔案系統。

顯示當前儲存在資料庫中的所有 PostgreSQL 大物件的列表，以及為它們提供的任何註釋。如果命令名稱後附加 x，則結果以擴充套件模式顯示。如果命令名稱後附加 +，則每個大物件都會列出其相關的許可權（如果有）。

從資料庫中刪除具有OID loid 的大物件。

安排將未來的查詢結果儲存到檔案 filename 或將未來的結果透過管道傳輸到 shell 命令 command。如果未指定引數，則查詢輸出將重置為標準輸出。

如果引數以 | 開頭，則行的其餘部分將被視為要執行的 command，並且其中不執行變數插值或反引號擴充套件。行的其餘部分只是按字面意思傳遞給 shell。

“查詢結果” 包括從資料庫伺服器獲得的所有表、命令響應和通知，以及查詢資料庫的各種反斜槓命令的輸出（例如 \d）；但不包括錯誤訊息。

將當前查詢緩衝區列印到標準輸出。如果當前查詢緩衝區為空，則會轉而列印最近執行的查詢。

根據目標預處理語句物件的名稱，從當前查詢緩衝區建立預處理語句。空字串表示未命名預處理語句。

示例：

SELECT $1 \parse stmt1

此命令導致使用擴充套件查詢協議，與通常使用簡單查詢協議的 psql 操作不同。此命令將發出 解析 (F) 訊息，因此測試 psql 中的擴充套件查詢協議可能很有用。此命令僅影響下一個執行的查詢；預設情況下，所有後續查詢都將使用簡單查詢協議。

更改指定使用者（預設為當前使用者）的密碼。此命令會提示輸入新密碼，對其進行加密，並將其作為 ALTER ROLE 命令傳送到伺服器。這可確保新密碼不會以明文形式出現在命令歷史記錄、伺服器日誌或其他任何地方。

提示使用者提供文字，該文字將分配給變數 name。可以指定一個可選的提示字串 text。（對於多詞提示，請用單引號將文字括起來。）

預設情況下，\prompt 使用終端進行輸入和輸出。但是，如果使用了 -f 命令列開關，\prompt 將使用標準輸入和標準輸出。

此命令設定影響查詢結果表輸出的選項。option 指示要設定哪個選項。value 的語義因所選選項而異。對於某些選項，省略 value 會導致選項被切換或取消設定，如特定選項下所述。如果沒有提到這種行為，則省略 value 只會導致顯示當前設定。

不帶任何引數的 \pset 會顯示所有列印選項的當前狀態。

可調整的列印選項是

這些不同格式的外觀示例可以在下面的示例中看到。

退出 psql 程式。在指令碼檔案中，只終止該指令碼的執行。

此命令與 \echo 相同，不同之處在於輸出將寫入到由 \o 設定的查詢輸出通道。

重置（清除）查詢緩衝區。

使用提供的鍵進入“受限”模式。在此模式下，唯一允許的元命令是 \unrestrict，用於退出受限模式。該鍵只能包含字母數字字元。

此命令主要用於 pg_dump、pg_dumpall 和 pg_restore 生成的純文字轉儲中，但也可能在其他地方有用。

將 psql 的命令列歷史記錄列印到 filename。如果省略 filename，則歷史記錄將寫入標準輸出（如果適用，使用尋呼機）。如果 psql 未在 Readline 支援下構建，則此命令不可用。

將 psql 變數 name 設定為 value，或者如果給定多個值，則設定為所有值的串聯。如果只給定一個引數，則變數設定為空字串值。要取消設定變數，請使用 \unset 命令。

不帶任何引數的 \set 顯示所有當前設定的 psql 變數的名稱和值。

有效的變數名可以包含字母、數字和下劃線。有關詳細資訊，請參閱下面的變數。變數名區分大小寫。

某些變數是特殊的，因為它們控制 psql 的行為或自動設定以反映連線狀態。這些變數在下面的變數中進行了說明。

將環境變數 name 設定為 value，如果未提供 value，則取消設定環境變數。示例

testdb=> \setenv PAGER less
testdb=> \setenv LESS -imx4F

此命令以 CREATE OR REPLACE FUNCTION 或 CREATE OR REPLACE PROCEDURE 命令的形式獲取並顯示命名函式或過程的定義。該定義將列印到由 \o 設定的當前查詢輸出通道。

目標函式可以僅透過名稱指定，也可以透過名稱和引數指定，例如foo(integer, text)。如果存在多個同名函式，則必須給出引數型別。

如果命令名稱後附加 +，則輸出行將編號，函式體第一行為第 1 行。

與大多數其他元命令不同，行的其餘部分始終被視為 \sf 的引數，並且在引數中不執行變數插值或反引號擴充套件。

此命令以 CREATE OR REPLACE VIEW 命令的形式獲取並顯示命名檢視的定義。該定義將列印到由 \o 設定的當前查詢輸出通道。

如果命令名稱後附加 +，則輸出行將從 1 開始編號。

與大多數其他元命令不同，行的其餘部分始終被視為 \sv 的引數，並且在引數中不執行變數插值或反引號擴充套件。

這組命令實現了 SQL 語句的管道傳輸。管道必須以 \startpipeline 開始並以 \endpipeline 結束。在這之間可以有任意數量的 \syncpipeline 命令，它傳送一個同步訊息，而不會結束正在進行的管道並刷新發送緩衝區。在管道模式下，語句被髮送到伺服器，而不等待先前語句的結果。有關更多詳細資訊，請參閱第 32.5 節。

在管道進行期間執行的所有查詢都使用擴充套件查詢協議。當以分號結束時，查詢將被附加到管道中。元命令 \bind、\bind_named、\close_prepared 或 \parse 可以在正在進行的管道中使用。當管道正在進行時，\sendpipeline 會將當前查詢緩衝區附加到管道中。其他元命令，如 \g、\gx 或 \gdesc，在管道模式下不允許使用。

\flushrequest 將一個 flush 命令附加到管道中，允許使用 \getresults 讀取結果，而無需發出同步或結束管道。\getresults 將自動將未傳送的資料推送到伺服器。\flush 可用於手動推送未傳送的資料。

\getresults 接受可選的 number_results 引數。如果提供，則只讀取前 number_results 個掛起結果。如果未提供或為 0，則讀取所有掛起結果。

當管道模式處於活動狀態時，可以使用專用提示變數報告管道狀態。有關更多詳細資訊，請參閱%P。

在管道模式下不支援 COPY。

示例：

\startpipeline
SELECT * FROM pg_class;
SELECT 1 \bind \sendpipeline
\flushrequest
\getresults
\endpipeline

切換輸出列名標題和行計數頁尾的顯示。此命令等效於 \pset tuples_only，是為了方便而提供的。

指定要放置在輸出格式的 table 標籤中的屬性。HTML此命令等效於 \pset tableattr table_options。

帶引數時，開啟或關閉顯示每個 SQL 語句所需的時間。不帶引數時，在開和關之間切換顯示。顯示以毫秒為單位；超過 1 秒的間隔也以分鐘:秒格式顯示，如果需要，還會新增小時和天欄位。

退出“受限”模式（即，所有其他元命令都被阻止），前提是指定的鍵與進入受限模式時提供給 \restrict 的鍵匹配。

此命令主要用於 pg_dump、pg_dumpall 和 pg_restore 生成的純文字轉儲中，但也可能在其他地方有用。

取消設定（刪除）psql 變數 name。

大多數控制 psql 行為的變數不能取消設定；相反，\unset 命令被解釋為將它們設定為其預設值。請參閱下面的變數。

將當前查詢緩衝區寫入檔案 filename 或將其透過管道傳輸到 shell 命令 command。如果當前查詢緩衝區為空，則寫入最近執行的查詢。

如果引數以 | 開頭，則行的其餘部分將被視為要執行的 command，並且其中不執行變數插值或反引號擴充套件。行的其餘部分只是按字面意思傳遞給 shell。

此命令與 \echo 相同，不同之處在於輸出將寫入 psql 的標準錯誤通道，而不是標準輸出。

重複執行當前查詢緩衝區（如 \g 所做）直到中斷，或查詢失敗，或達到執行計數限制（如果給定），或查詢不再返回最小行數。每次執行之間等待指定的秒數（預設 2）。可以使用變數 WATCH_INTERVAL 更改預設等待時間。為了向後相容，seconds 可以帶或不帶 interval= 字首指定。每個查詢結果都顯示一個包含 \pset title 字串（如果有）、查詢開始時間以及延遲間隔的標題。

如果當前查詢緩衝區為空，則會重新執行最近傳送的查詢。

設定或切換擴充套件表格式模式。因此，它等效於 \pset expanded。

列出表、檢視和序列及其相關的訪問許可權。如果指定了 pattern，則只列出名稱與模式匹配的表、檢視和序列。預設情況下只顯示使用者建立的物件；提供模式或 S 修飾符以包含系統物件。如果命令名稱後附加 x，則結果以擴充套件模式顯示。

這是 \dp（“顯示許可權”）的別名。

不帶引數時，轉義到子 shell；當子 shell 退出時，psql 恢復。帶引數時，執行 shell 命令 command。

與大多數其他元命令不同，行的其餘部分始終被視為 \! 的引數，並且在引數中不執行變數插值或反引號擴充套件。行的其餘部分只是字面量傳遞給 shell。

顯示幫助資訊。可選的 topic 引數（預設為 commands）選擇要解釋的 psql 部分：commands 描述 psql 的反斜槓命令；options 描述可以傳遞給 psql 的命令列選項；variables 顯示關於 psql 配置變數的幫助。

反斜槓分號不像前面的命令那樣是元命令；相反，它只是導致一個分號被新增到查詢緩衝區，而無需進一步處理。

通常，psql 會在到達命令結束分號後立即將 SQL 命令分派到伺服器，即使當前行上還有更多輸入。因此，例如輸入

select 1; select 2; select 3;

將導致三個 SQL 命令單獨傳送到伺服器，每個命令的結果在繼續到下一個命令之前顯示。但是，作為 \; 輸入的分號不會觸發命令處理，因此它前面的命令和它後面的命令有效地組合在一起，以一個請求傳送到伺服器。例如

select 1\; select 2\; select 3;

導致在到達非反斜槓分號時，將三個 SQL 命令在一個請求中傳送到伺服器。伺服器將此類請求作為單個事務執行，除非字串中包含顯式的 BEGIN/COMMIT 命令將其分成多個事務。（有關伺服器如何處理多查詢字串的更多詳細資訊，請參閱第 54.2.2.1 節。）