psql

如果目前的資料表輸出格式是不對齊的，切換成對齊的。 如果是對齊的，切換成不對齊。這條命令是為了向後兼容。參閱 \pset 獲取一個更通用的解決方法。

把目前工作目錄改變到 directory。 沒有參數是則改變到目前用戶的家目錄。

把正在打印的資料表的標題設置為一個查詢的結果或者取消這樣的設置。 這條命令等效於 \pset title title. （這條命令的名稱源於 "caption"，因為以前只是用於在一個 HTML 資料表裡面設置標題。）

與一個新的資料庫建立一個連線，使用/不用一個用戶名。 前面的連線將關閉。如果 dbname 是 -，那麼就假設是目前資料庫名稱。

如果省略 username，則假設是目前用戶名。

作為一條特殊規則，不帶任何參數執行\connect 將以預設用戶身份與預設資料庫連接（正如您不帶任何參數執行 psql 一樣。）

如果連線失敗（用戶名錯，訪問拒絕等），那麼將保留前面的連線--當且僅當在 psql 處於交互模式下如此。 如果執行的是非交互的腳本，處理會馬上停止，並返回一個錯誤。 選擇這樣的區別是一方面為用戶使用方便考慮，另一方面為保證腳本不會碰巧操作了錯誤的資料庫的安全機制考慮的。

執行前端（客戶端）拷貝。這是一個執行 SQL COPY 命令的操作， 不同的是 SQL COPY 是伺服器在讀寫指明的文件，而 psql 讀寫文件並作為本地的文件系統和伺服器之間的路由取出或寫入資料。 這意味著文件訪問性和權限都是本地用戶的，而不是伺服器的，因此不需要 SQL 超級用戶權限。

這條命令的語法是模擬 SQL COPY 命令的。 要注意的是由此而來，有一些特殊的分析規則應用於 \copy 命令。 尤其是變量替換規則和反斜槓代換規則不起作用。

\copy table from stdin | stdout 分別基於命令輸入和輸出讀/寫。所有行都從發出命令的同一個源讀取，直到讀到了 \. 或者流達到 EOF。 輸出發送到和命令輸出相同的位置。要從 psql 的標準輸入或者輸出讀/寫， 使用 pstdin 或者 pstdout。這個選項用於把和 SQL 腳本嵌在一起的文件填充資料表很有用。

顯示 PostgreSQL 的版權和版本訊息。

對於每個匹配pattern的關係（資料表，視圖，索引或者序列）， 顯示所有列，它們的類型，資料表空間（如果不是預設的）和任何特殊屬性，像NOT NULL或預設等－－只要存在。 如果實際上這個關係是一個資料表，任何已定義的索引，主鍵，唯一約束相關的索引，規則，約束，和觸發器也同樣顯示出來， 如果關係是一個視圖，還顯示視圖的定義。 （"匹配模式"在下面定義。）

從 \d+ 來的命令也是一樣的，只不過顯示更多訊息：任何與資料表的列關聯的註解也都會顯示， 還有就是資料表中出現的 OID。

列出所有可用聚集函數，以及它們操作的資料類型。如果聲明了 pattern，那麼只顯示匹配（正則資料表達式）的聚集函數。

列出所有可用的資料表空間。如果聲明了 pattern， 那麼只顯示那些匹配模式的資料表空間。如果在命令名上附加了 +，那麼每個對象都和與之相關的權限一起列出。

列出所有字元集之間的可用轉換。如果聲明了 pattern， 則只列出那些匹配模式的轉換。

列出所有類型轉換。

顯示所有匹配 pattern 的描述，如果沒有給出參數，顯示所有可視對象。 但是不管怎樣，只有那些有描述內容的對象才顯示出來。 （"對像"包括聚集，函數，操作符，類型， 關係（資料表，視圖，索引，序列，大對像），規則和觸發器。）例如：

=> \dd version
                     Object descriptions
   Schema   |  Name   |  Object  |      Description
------------+---------+----------+---------------------------
 pg_catalog | version | function | PostgreSQL version string
(1 row)

可以用 COMMENT SQL 命令生成對對象的描述。

列出所有可用域。如果聲明了 pattern，那麼只顯示匹配的域。

列出所有可用函數，以及它們的參數和返回的資料類型。如果聲明了 pattern，那麼只顯示匹配（正則資料表達式）的函數。如果使用了 \df+ 的形式，每個函數的附加訊息，包括語言和描述也會顯示出來。

列出所有資料庫組。如果聲明了 pattern， 只顯示那些匹配模式的名字。

這不是實際的命令名稱：字母 i，s， t，v，S 分別代資料表索引（index）， 序列（sequence），資料表（table），視圖（view）和系統資料表（system table）。 您可以以任意順序聲明任意或者所有這些字母獲得這些對象的一個列資料表。 字幕 S 把列資料表限制於系統對像；如果沒有 S，則只顯示非系統對象。 如果在命令名上附加了 +，那麼還會列出和每個對象相關聯的描述，如果有的話。

如果聲明了 pattern，那麼只列出匹配模式的對象。

這是 \lo_list的別名，顯示一個大對象的列資料表。

列出所有可用模式（名字空間）。如果聲明了 pattern （一個正則資料表達式），那麼只列出匹配模式的模式名。不顯示非本地的臨時模式。 如果在命令名上附加了 +，那麼每個對象都和與之相關的權限和註釋一起列出（如果有的話）。

列出所有可用操作符，以及它們的操作數和返回的資料類型。 如果聲明了 pattern，那麼只顯示匹配模式的操作符。

生成一列可用的資料表和它們相關的權限。 如果聲明了 pattern， 那麼只列出名字可以匹配模式的資料表。

命令 GRANT 和 REVOKE 用於設置訪問權限。參閱 GRANT 獲取更多訊息。

列出所有資料類型或只顯示那些匹配 pattern的。這條命令的 \dT+ 形式顯示更多訊息。

列出所有已配置用戶或者只列出那些匹配 pattern 的用戶。

如果聲明了 filename， 則編輯此文件並且在編輯器退出後將其內容拷貝回查詢緩衝區。 如果沒有給出參數，則把目前查詢緩衝區內容拷貝到一個臨時文件然後以相同方式編輯。

然後根據一般的psql規則重新分析查詢緩衝區， 這時整個緩衝區當作一個單行。（因此您無法用這個方法製作「腳本」，用 \i 做腳本。） 這還意味著如果該查詢以分號結尾（或者包含分號），它就會馬上被執行。否則它只是在查詢緩衝區裡等待。

向標準輸出打印參數，用一個空格分隔並且最後跟著一個新行。 這個特性在顯示腳本的輸出時會有用。例如：

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

果第一個參數是一個無引號的 -n，那麼不會寫出結尾的新行。

設置客戶端字元編碼方式。不帶參數時，這條命令顯示目前的編碼方式。

為不對齊的查詢輸出設置域分隔符。預設時是豎條（|）。 參閱 \pset 獲取設置輸出選項的通用方法。

把目前的查詢輸入緩衝區的內容發送給伺服器並且把查詢的輸出儲存到可選的 filename 或者把輸出定向到一個獨立的在執行 command 的 Unix shell。 單獨一個 \g 實際上等效於一個分號。一個帶有參數的\g 是"一次性"的 \o命令的代用品。

給出指定 SQL 命令的語法幫助。如果沒有給出 command ，那麼 psql 將列出可獲得語法幫助的所有命令。如果 command 是一個星號（"*"），則顯示所有 SQL 命令的語法幫助。

打開 HTML 查詢輸出格式。如果 HTML 格式已經打開，則切換回預設的對齊的文本格式。 這個命令是為了兼容和方便，參閱 \pset 獲取設置其他輸出選項的內容。

從文件filename中讀取並把其內容當作從鍵盤輸入的那樣執行查詢。

列出伺服器上所有資料庫的名字和它們的所有者以及字元集編碼。在命令名稱後面加一個 "+" 還可以看到對資料庫的描述。

從資料庫裡讀取 OID 為 loid 的大對象並把她寫到 filename裡。 注意這個功能與伺服器函數 lo_export 有些微小的區別， lo_export 執行時帶著執行資料庫伺服器的用戶權限， 而且是在伺服器的文件系統上。

把文件儲存為一個 PostgreSQL 大對象。可以帶著一個該對象的註解選項。例如：

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

響應資料表明此大對像得到一個對像標識 152801，如果您還想訪問該對象，就應該把這個對象標識記住。 因此，我們建議總是給每個對象關聯一個人類可讀的註解。那樣就可以用 \lo_list 命令看到這些註解。

注意這條命令與伺服器端的 lo_import 有一些區別，因為這條命令是本地用戶在本地文件系統上操作， 而不是以伺服器用戶在伺服器文件系統上操作。

顯示一個目前儲存在該資料庫裡的所有 PostgreSQL 大對像和它們的所有者的列資料表。

從資料庫裡刪除OID為 loid 的大對象。

把後面的查詢結果保存到文件 filename 裡或者把後面的查詢結果定向到一個獨立的 Unix shell 執行 command。 如果沒有聲明參數，查詢輸出重置為標準輸出。

"查詢結果"包括所有資料表，命令響應和從資料庫伺服器來的提示， 同樣還有各種各樣查詢資料庫的反斜槓命令的輸出（如 \d），但是沒有錯誤訊息。

打印目前查詢緩衝區到標準輸出。

這條命令設置影響查詢結果資料表輸出的選項。parameter 描述要設置的選項是哪一個。value 的語意也取決於它。

可調節的打印選項有：

可以在 例子 節看到這些不同格式輸出的示例。

退出psql程序。

這條命令等效於 \echo ，區別是所有輸出將寫入由 \o設置的輸出通道。

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

將命令行歷史打印出或是存放到 filename。 如果省略 filename， 歷史將輸出到標準輸出。這個選項只有在 psql 配置成使用 GNU Readline 庫後才生效。

設置內部變量 name 為 value 或著如果給出了多於一個值， 設置為所有這些值的連線結果。如果沒有給出第二個參數，只設變量不設值。要重置一個變量，使用 \unset 命令。

有效的變量名可以包含字元，數字和下劃線。 參閱下面的 變量 獲取細節。

儘管您可以設置任何變量為任意值， psql對一些變量特殊對待。它們在關於變量的節裡面有文件。

切換輸出的列/字串名的訊息頭和行記數腳注。 這條命令等效於 \pset tuples_only，提供主要為了方便。

允許您在使用HTML輸出模式時聲明放在 table 標記裡的屬性。 這條命令等效於 \pset tableattr table_options。

將目前查詢緩衝區輸出到文件 filename 或者定向到 Unix 命令 command。

切換擴展行格式。等效於 \pset expanded。

生成一個帶有訪問權限列資料表的資料庫中所有資料表，視圖和序列的列資料表。 如果給出任何pattern，則被當成一個規則資料表達式， 只顯示匹配的資料表，視圖和序列。

命令 GRANT 和 REVOKE 用於設置訪問權限。 參閱 GRANT 獲取更多訊息。

這是 \dp（"顯示權限"）的別名。

返回到一個獨立的 Unix shell 或者執行 Unix 命令 command。 參數不會被進一步解釋，shell 將看到全部參數。

獲得關於反斜槓命令的幫助訊息。