****

\echo text [ ... ]

向標(biāo)準(zhǔn)輸出打印參數(shù)，用一個空格分隔并且最后跟著一個新行。 這個特性在顯示腳本的輸出時會有用。例如：

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

果第一個參數(shù)是一個無引號的 -n，那么不會寫出結(jié)尾的新行。

    提示: 如果你使用 \o 命令重定向你的查詢的輸出，你可能會用 \qecho取代這條命令。

\encoding [ encoding ]

設(shè)置客戶端字符編碼方式。不帶參數(shù)時，這條命令顯示當(dāng)前的編碼方式。

\f [ string ]

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

\g [ { filename | |command } ]

把當(dāng)前的查詢輸入緩沖區(qū)的內(nèi)容發(fā)送給服務(wù)器并且把查詢的輸出存儲到可選的 filename 或者把輸出定向到一個獨(dú)立的在執(zhí)行 command 的 Unix shell。 單獨(dú)一個 \g 實際上等效于一個分號。一個帶有參數(shù)的\g 是"一次性"的 \o命令的代用品。

\help （或者 \h） [ command ]

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

    注意: 為簡化敲擊，包含多個單字的命令不需要引起。因此鍵入 \help alter table 是正確的。

\H

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

\i filename

從文件filename中讀取并把其內(nèi)容當(dāng)作從鍵盤輸入的那樣執(zhí)行查詢。

    注意: 如果你想在屏幕上看到讀入的行，你必須對所有行設(shè)置變量 ECHO 為 all。

\l （或 \list）
\l+ （或 \list+）

列出服務(wù)器上所有數(shù)據(jù)庫的名字和它們的所有者以及字符集編碼。在命令名稱后面加一個 "+" 還可以看到對數(shù)據(jù)庫的描述。

\lo_export loid filename

從數(shù)據(jù)庫里讀取 OID 為 loid 的大對象并把她寫到 filename里。 注意這個功能與服務(wù)器函數(shù) lo_export 有些微小的區(qū)別， lo_export 運(yùn)行時帶著運(yùn)行數(shù)據(jù)庫服務(wù)器的用戶權(quán)限， 而且是在服務(wù)器的文件系統(tǒng)上。

    提示: 使用 \lo_list 查看大對象的 OID。

\lo_import filename [ comment ]

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

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

響應(yīng)表明此大對象得到一個對象標(biāo)識 152801，如果你還想訪問該對象，就應(yīng)該把這個對象標(biāo)識記住。 因此，我們建議總是給每個對象關(guān)聯(lián)一個人類可讀的注解。 那樣就可以用 \lo_list 命令看到這些注解。

注意這條命令與服務(wù)器端的 lo_import 有一些區(qū)別， 因為這條命令是本地用戶在本地文件系統(tǒng)上操作， 而不是以服務(wù)器用戶在服務(wù)器文件系統(tǒng)上操作。

\lo_list

顯示一個目前存儲在該數(shù)據(jù)庫里的所有 PostgreSQL 大對象和它們的所有者的列表。

\lo_unlink loid

從數(shù)據(jù)庫里刪除OID為 loid 的大對象。

    提示: 使用 \lo_list 查找大對象的 OID。

\o [ {filename | |command} ]

把后面的查詢結(jié)果保存到文件 filename 里或者把后面的查詢結(jié)果定向到一個獨(dú)立的 Unix shell 執(zhí)行 command。 如果沒有聲明參數(shù)，查詢輸出重置為標(biāo)準(zhǔn)輸出。

"查詢結(jié)果"包括所有表，命令響應(yīng)和從數(shù)據(jù)庫服務(wù)器來的提示， 同樣還有各種各樣查詢數(shù)據(jù)庫的反斜杠命令的輸出（如 \d），但是沒有錯誤信息。

    提示: 要用文本分散查詢結(jié)果之間的輸出，用 \qecho。

\p

打印當(dāng)前查詢緩沖區(qū)到標(biāo)準(zhǔn)輸出。

\pset parameter [ value ]

這條命令設(shè)置影響查詢結(jié)果表輸出的選項。parameter 描述要設(shè)置的選項是哪一個。value 的語意也取決于它。

可調(diào)節(jié)的打印選項有：

format

設(shè)置輸出格式為 unaligned，aligned，html， latex 或 troff-ms 之一。允許使用唯一的縮寫。 （這也意味著一個字母就夠了。）

"Unaligned" （不對齊）把一條記錄的所有字段都輸出到一行， 用當(dāng)前有效的域分隔符分隔。這主要用于生成那些要被其他程序讀取的輸出（tab分隔，逗號分隔）。 "Aligned" （對齊）模式是標(biāo)準(zhǔn)的，人類可讀的，格式化好了的文本輸出，也是缺省。 "HTML" 和 "LaTeX" 模式把表輸出為可用于文檔里的對應(yīng)標(biāo)記語言。它們還不是完整的文檔！ （可能對于 HTML 變化還不是太大， 但是在 LaTeX 里，你必須有一個完整的文檔包裝器。）

border

第二個參數(shù)必須是一個數(shù)字。通常，數(shù)字越大，表就有越寬的邊界和越多的線， 但是這個參數(shù)取決于實際的格式。在HTML模式里， 這個參數(shù)會直接翻譯成border=...屬性，在其他的模式里， 只有值 0 （無邊界），1 （內(nèi)部分隔線）和 2 （表框架）有意義。

expanded ）（或者 x）

在正常和擴(kuò)展格式之間切換。當(dāng)打開擴(kuò)展格式時，查詢結(jié)果用兩列顯示， 字段名稱在左，數(shù)據(jù)在右。這個選項只影響正常查詢結(jié)果的顯示方式； psql 元命令的輸出總是使用正常的格式。 這個模式在數(shù)據(jù)無法放進(jìn)通常的"水平"模式的屏幕時很有用。

所有四種輸出模式都支持?jǐn)U展格式。

null

第二個參數(shù)是一個字串，用以代表字段的值為 null 時的打印輸出。 缺省是什么都不打，這樣很容易和類似一個空字串混淆。 因此，我們可能選擇 \pset null '(null)'。

fieldsep

聲明在非對齊模式時的域分隔符。 這樣我們就可以創(chuàng)建其他程序希望的tab或逗號分隔的輸出。要設(shè)置 tab 域分隔符， 鍵入 \pset fieldsep '\t'。缺省域分隔符是 '|' （一個豎條符號）。

footer

切換缺省腳注 (x rows)。

recordsep

聲明在非對齊模式時的記錄分隔符。缺省是換行符。

tuples_only （或者 t）

在完全顯示和只顯示記錄之間切換。 完全顯示將顯示象列頭，標(biāo)題和各種腳注等信息。 在這個模式下，只顯示記錄模式將只顯示實際的表數(shù)據(jù)。

title [ text ]

為任何隨后打印的表設(shè)置標(biāo)題。 這個參數(shù)可以用于給你的輸出一個描述性標(biāo)記。 如果不帶參數(shù)，重置標(biāo)題。

tableattr （或者 T）[ text ]

允許你聲明放在 HTML table 標(biāo)記里的任何屬性。例如，可以是 cellpadding 或 bgcolor。注意你可能不需要在這里聲明 border ，因為已經(jīng)在 \pset border 里用過了。

pager

控制查詢和psql幫助輸出的分頁器。如果設(shè)置了環(huán)境變量 PAGER， 輸出被定向到指定程序，否則使用系統(tǒng)缺省（比如 more）。

如果關(guān)閉了分頁器，則不使用它，如果打開了，程序只在需要的時候使用分頁器，也就是說， 輸出是到終端，而且那個表很可能無法與屏幕匹配。 （psql 在決定何時分頁時不是很完美。） \pset pager 開關(guān)分頁器。我們也可以把分頁器設(shè)置為 always，導(dǎo)致我們在任何情況下都使用分頁器。

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

提示: 有很多用于\pset的快速命令。參閱 \a，\C，\H， \t，\T，和 \x。

注意: 無參數(shù)運(yùn)行 \pset是錯誤的。 以后這樣調(diào)用將顯示當(dāng)前打印選項狀態(tài)。

\q

退出psql程序。

\qecho text [ ... ]

這條命令等效于 \echo ，區(qū)別是所有輸出將寫入由 \o設(shè)置的輸出通道。

\r

重置（清空）查詢緩沖區(qū)。

\s [ filename ]

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

    注意: 在當(dāng)前版本里，這個（ GNU 歷史庫）不再是必須的了， 實際上，在程序結(jié)束時自動保存命令行歷史。每次 psql 啟動都會裝載命令行歷史。

\set [ name [ value [ ... ] ] ]

設(shè)置內(nèi)部變量 name 為 value 或著如果給出了多于一個值， 設(shè)置為所有這些值的聯(lián)接結(jié)果。如果沒有給出第二個參數(shù)，只設(shè)變量不設(shè)值。要重置一個變量，使用 \unset 命令。

有效的變量名可以包含字符，數(shù)字和下劃線。 參閱下面的 變量 獲取細(xì)節(jié)。

盡管你可以設(shè)置任何變量為任意值， psql對一些變量特殊對待。它們在關(guān)于變量的節(jié)里面有文檔。

    注意: 這條命令是完全和 SQL 命令 SET 不一樣的。

\t

切換輸出的列/字段名的信息頭和行記數(shù)腳注。 這條命令等效于 \pset tuples_only，提供主要為了方便。

\T table_options

允許你在使用HTML輸出模式時聲明放在 table 標(biāo)記里的屬性。 這條命令等效于 \pset tableattr table_options。

\w {filename | |command}

將當(dāng)前查詢緩沖區(qū)輸出到文件 filename 或者定向到 Unix 命令 command。

\x

切換擴(kuò)展行格式。等效于 \pset expanded。

\z [ pattern ]

生成一個帶有訪問權(quán)限列表的數(shù)據(jù)庫中所有表，視圖和序列的列表。 如果給出任何pattern，則被當(dāng)成一個規(guī)則表達(dá)式， 只顯示匹配的表，視圖和序列。

命令 GRANT 和 REVOKE 用于設(shè)置訪問權(quán)限。 參閱 GRANT 獲取更多信息。

這是 \dp（"顯示權(quán)限"）的別名。

! [ command ]

返回到一個獨(dú)立的 Unix shell 或者執(zhí)行 Unix 命令 command。 參數(shù)不會被進(jìn)一步解釋，shell 將看到全部參數(shù)。

\?

獲得關(guān)于反斜杠命令的幫助信息。

各種 \d 命令都接受一個 pattern 參數(shù)，聲明要顯示的對象名字。* 表示"任何字符序列"， 而 ? 表示"任何單個字符"。（這個表示法和 Unix 的 shell 文件名模式兼容。） 高級用戶也可以使用正則表達(dá)式表示法，比如字符表，[0-9] 這樣的東西來匹配"任意數(shù)字"。 要讓任何這些模式匹配字符可以安字面方式解析，那就應(yīng)該用雙引號包圍它們。

一個包含（無引號的）句點的模式會被解析承一個模式名的模式后面跟著一個對象名的模式。 比如， \dt foo.bar 顯示所有以foo 開頭的模式里的以 bar 開頭的表名字。 如果沒有出現(xiàn)句點，那么這個模式只匹配在當(dāng)前模式搜索路徑中可見的對象。

如果完全省略 pattern 參數(shù)， 那么 \d 命令顯示所有在當(dāng)前模式搜索路徑中可見的對象。 要查閱在數(shù)據(jù)庫中的所有對象，使用模式 .。
高級特性
變量

psql 提供類似通常 Unix 命令 shell 那樣的變量替換特性。 變量只是簡單的名稱/數(shù)值對， 這里的值可以是任何長度的任何值。要設(shè)置一個變量，使用 psql 元命令 \set：

testdb=> \set foo bar

把變量"foo" 設(shè)置為值 "bar"。 要檢索變量的內(nèi)容，在變量名前面放上冒號然后把它用在任意斜杠命令里：

testdb=> \echo :foo
bar

注意: \set 的參數(shù)服從和其他命令一樣的替換規(guī)則。 因此你可以構(gòu)造有趣的引用，象 \set :foo 'something' 這樣， 獲得分別象Perl或 PHP那樣有名的"軟連接（soft links）"或"變量 變量"。 不幸的是（或者 萬幸的？），用這些構(gòu)造不能做任何有用的事情。另一方面， \set bar :foo 是一個非常有效的拷貝變量的方法。

如果你不帶第二個參數(shù)調(diào)用\set， 那么只是設(shè)置這個變量而沒有值。 要重置（或刪除）一個變量，使用命令 \unset。

psql的內(nèi)部變量可以包括任意順序， 任意數(shù)量的字母，數(shù)字和下劃線。 有一些常用變量被 psql 另眼相待。它們是一些選項設(shè)置， 這些選項在運(yùn)行時可以通過改變變量的值或者改變一些應(yīng)用的表現(xiàn)狀態(tài)而改變。 盡管你可以把這些變量用于其他用途，但是我們不鼓勵這么做，因為程序的特性可能會很快變得非常奇怪。 通常，所有特殊對待的變量都是由大寫字母組成（可能還有數(shù)字和下劃線）。 為了保證和未來的最大限度的兼容性，請避免使用這樣的變量。 下面是一個所有特殊對待的變量列表。

AUTOCOMMIT

如果是 on（缺省），那么每個 SQL 命令都在成功完成后自動提交。 要推遲這種模式下的提交，你必須輸入一個 BEGIN 或者 START TRANSACTION SQL 命令。 如果是 off 或者未設(shè)置，SQL 命令不會提交，知道你明確地發(fā)出 COMMIT 或者 END。 關(guān)閉自動提交的模式是通過為你明確發(fā)出一個 BEGIN 實現(xiàn)的， 它是放在任何尚未在一個事務(wù)塊中并且自己不是 BEGIN 或者其它事務(wù)控制命令也不是那些不能在事務(wù)塊里執(zhí)行的命令 （比如 VACUUM）的前面。

    注意: 在關(guān)閉自動提交的模式下，你必須明確放棄任何失敗的事務(wù)，方法是執(zhí)行 ABORT 或者 ROLLBACK。 還要注意如果你不提交就退出會話，你的工作會丟失。

    注意: 自動提交打開方式是 PostgreSQL 傳統(tǒng)的行為， 但是關(guān)閉自動提交更接近 SQL 規(guī)范。如果你喜歡關(guān)閉自動提交，你應(yīng)該在你的 .psqlrc 文件里設(shè)置它。

DBNAME

你正在聯(lián)接著的數(shù)據(jù)庫名稱。 每次你與一個數(shù)據(jù)庫聯(lián)結(jié)都會設(shè)置這個值（包括程序啟動），但是可以刪除。

ECHO

如果置為 all， 輸入的或者來自鍵盤或者一個腳本的所有行在分析或執(zhí)行前都寫到標(biāo)準(zhǔn)輸出。 要在程序啟動時聲明這些，使用 -a如果設(shè)置為 queries， psql 只是在查詢發(fā)送給服務(wù)器之前打印出來。 實現(xiàn)這個功能的命令行選項是 -e。

ECHO_HIDDEN

當(dāng)設(shè)置了這個變量并且一個反斜杠命令查詢數(shù)據(jù)庫時，首先顯示查詢。 這樣你可以學(xué)習(xí) PostgreSQL 內(nèi)部的東西并且在你自己的程序里提供類似功能。如果你設(shè)置該變量的值為 "noexec"，查詢只是顯示出來但是實際上不發(fā)送到服務(wù)器和執(zhí)行。

ENCODING

當(dāng)前的客戶端字符集編碼。

HISTCONTROL

如果這個變量設(shè)置為 ignorespace， 以空格開始的行將不會進(jìn)入歷史列表。 如果設(shè)置為變量 ignoredups， 與以前歷史記錄里匹配的行也不會進(jìn)入歷史記錄。值 ignoreboth是上面兩個的結(jié)合。 如果刪除此變量或者其值為任何與上面的值不同的東西， 所有交互模式讀入的行都被保存入歷史列表。

    注意: 這個特性是無恥地從 Bash 里剽竊來的。

HISTFILE

此文件將用于存儲歷史列表。缺省值是 ~/.psql_history。 比如，在 ~/.psqlrc 里使用：

\set HISTFILE ~/.psql_history- :DBNAME

將令 psql 為每個數(shù)據(jù)庫維護(hù)一個獨(dú)立的歷史。

    注意: 這個特性是從 Bash 里偷學(xué)來的。

HISTSIZE

存在命令歷史里的命令的個數(shù)。缺省值是 500。

    Note: 這個特性是無恥地從 Bash里剽竊來的。

HOST

當(dāng)前你正聯(lián)接的數(shù)據(jù)庫服務(wù)器主機(jī)。 這是在每次你與數(shù)據(jù)庫聯(lián)接時（包括程序啟動）設(shè)置的，但是可以刪除。

IGNOREEOF

如果刪除此變量，向一個交互的 psql會話發(fā)送一個 EOF （通常是 Control-D）將終止應(yīng)用。如果設(shè)置為一個數(shù)字值，那么在應(yīng)用終止前該數(shù)值的 EOF 字符將被忽略。 如果設(shè)置了此變量但是沒有數(shù)字值，缺省是 10。

    注意: 這個特性是無恥地從 Bash 里剽竊來的。

LASTOID

最后影響的oid值，即為從一條 INSERT 或 lo_insert 命令返回的值。 此變量只保證在下一條 SQL 命令的結(jié)果顯示之前有效。

ON_ERROR_ROLLBACK

如果是 on，如果一個事務(wù)塊里的語句產(chǎn)生一個錯誤， 那么這個錯誤被忽略而事務(wù)講繼續(xù)。如果是 interactive， 那么這樣的錯誤只是在交互的會話里忽略，而不是在從讀取腳本文件的時候。 如果是 off（缺省），事務(wù)塊里一個語句生成的錯誤將會回滾整個事務(wù)。 on_error_rollback-on 的模式是通過在一個事務(wù)塊的每個命令前為你隱含地發(fā)出一個 SAVEPONT 的方式工作的，在發(fā)生錯誤的時候回滾到該事務(wù)塊。

ON_ERROR_STOP

缺省時，如果非交互的腳本碰到一個錯誤，象一條錯誤的 SQL 命令或者內(nèi)部元命令，處理會繼續(xù)進(jìn)行。 這是 psql 的傳統(tǒng)特性， 但是有時候我們不太希望這樣。如果設(shè)置了這個變量，腳本處理將馬上停止。 如果該腳本是從另外一個腳本調(diào)用的，那個腳本也會按同樣的方式停止。 如果最外層的腳本不是從一次交互的 psql 會話中調(diào)用的而是用 -f 選項調(diào)用的，psql 將返回錯誤代碼 3，以示這個情況與致命錯誤條件的區(qū)別（錯誤代碼 1）。

PORT

當(dāng)前你正在聯(lián)接的數(shù)據(jù)庫服務(wù)器的端口。 這是在每次你與數(shù)據(jù)庫聯(lián)接時（包括程序啟動）設(shè)置的，但是可以刪除。

PROMPT1
PROMPT2
PROMPT3

這些指明psql 顯示的提示符看上去象什么。 參閱下面的 提示符。

QUIET

這個變量等效于命令行選項 -q。 可能在交互模式下沒有什么用。

SINGLELINE

這個變量等效于設(shè)置命令行選項 -S。你可以在運(yùn)行時刪除或設(shè)置它。

SINGLESTEP

這個變量等效于命令行選項 -s。

USER

當(dāng)前你正用于聯(lián)接的數(shù)據(jù)庫用戶。 這是在每次你與數(shù)據(jù)庫聯(lián)接時（包括程序啟動）設(shè)置的，但是可以刪除/重置。

VERBOSITY

這個選項可以設(shè)置為值 default，verbose，或者 terse 以控制錯誤報告的冗余行。

SQL 代換

一個附加的 psql 變量的有用特性是你可以把它們替換（"代換"）成正規(guī)的 SQL 語句。這樣做的語法同樣還是變量名前面加一個冒號（:）。

testdb=> \set foo 'my_table'
testdb=> SELECT * FROM :foo;

將會查詢表my_table。變量的值是逐字拷貝的， 所以它甚至可以包含不對稱的引號或反斜杠命令。你必須保證你輸入的東西是有意義的。 變量替換將不會在引號引起來的 SQL 語句里面發(fā)生。

利用這個功能的一個時髦的應(yīng)用是通過使用一個隨后的語句中最后插入的 OID 建立一個外鍵仿真場景。 另一個可能用到這個機(jī)制的地方是把一個文件的內(nèi)容拷貝到一個字段里面去。 首先把文件裝載到一個變量然后象上面那樣處理。

testdb=> \set content '\'' cat my_file.txt '\''
testdb=> INSERT INTO my_table VALUES (:content);

這樣處理的一個可能問題是 my_file.txt 可能包含單引號。這些需要被逃逸以免在處理第三行時不會導(dǎo)致語法錯誤。 可以使用程序 sed來做這個處理：

testdb=> \set content '\'' sed -e "s/'/\\\\\\'/g" < my_file.txt '\''

觀察正確數(shù)量的反斜杠（6）！你可以這樣解釋它：在 psql 分析完這行后，它把 sed -e "s/'/\\'/g" < my_file.txt 傳遞給shell。 shell 將對雙引號里的東西做其處理然后用參數(shù) -e 和 s/'/\'/g執(zhí)行 sed。當(dāng) sed分析這些時， 它將把雙反斜杠替換為單個反斜杠然后進(jìn)行替換。 可能有時候你認(rèn)為所有 Unix 命令使用同一個逃逸字符是個好事。 但具有諷刺意味的事實是你可能不得不逃逸所有反斜杠，因為 SQL 文本常量同樣也慘遭這種解釋。 這種情況下你可能最好在外部準(zhǔn)備文件。

因為冒號也可以合法的出現(xiàn)在 SQL 命令里，便有下面規(guī)則的應(yīng)用： 如果沒有設(shè)置變量，字符序列 "冒號+名稱" 不會被改變。 在任何情況下你都可以用反斜杠逃逸冒號以保護(hù)它免于被解釋。 （變量的冒號語法是 SQL 用于嵌入查詢語言的標(biāo)準(zhǔn)，如ECPG。用于數(shù)組片段和類型轉(zhuǎn)換的冒號語法是 PostgreSQL 擴(kuò)展，因此有沖突。）
提示符

psql使用的提示符可以根據(jù)你的喜好客戶化。三個變量 PROMPT1，PROMPT2，和 PROMPT3 包含描述提示符的外觀的字串和特殊逃逸序列。Prompt 1 是 psql 請求一個新命令時的使用的正常提示符。 Prompt 2 是在一個命令輸入期待更多輸入時（因為查詢沒有用一個分號結(jié)束或者引號沒有關(guān)閉）顯示的提示符。 Prompt 3 在你運(yùn)行一個 SQL COPY 命令和等待你在終端上鍵入記錄時使用。

相應(yīng)的提示符變量的值是按字面打印的，除非碰到一個百分號（%）。這時某些其他的文本被替換， 替換為何物取決于下一個字符。已定義的替換是：

%M

數(shù)據(jù)庫服務(wù)器主機(jī)名全名（帶著域名），如果聯(lián)接是通過 Unix 域套接字進(jìn)行的就是 [local]， 或者如果 Unix 域套接字不是編譯的缺省位置，就是 [local:/dir/name]。

%m

數(shù)據(jù)庫服務(wù)器的主機(jī)名刪去第一個點后面的部分剩下的東西。 或者如果聯(lián)接是通過 Unix 域套接字，就是 [local]。

%>

數(shù)據(jù)庫服務(wù)器正在偵聽的端口號。

%n

數(shù)據(jù)庫會話的用戶名。 （這個值的擴(kuò)展可能在一個數(shù)據(jù)庫會話過程中因為 SET SESSION AUTHORIZATION 命令而改變。）

%/

當(dāng)前數(shù)據(jù)庫名稱。

%~

類似 %/， 但如果數(shù)據(jù)庫是你的缺省數(shù)據(jù)庫輸出是"~" （波浪線（tilde））。

%#

如果會話用戶是數(shù)據(jù)庫超級用戶，使用 "#"，否則用">"。 （這個值的擴(kuò)展可能在一個數(shù)據(jù)庫會話過程中因為 SET SESSION AUTHORIZATION 命令而改變。）

%R

對于 prompt 1 通常是 =，但是如果是單行模式則是 ^，而如果會話與數(shù)據(jù)庫斷開（如果 \connect 失敗可能發(fā)生）是 !。對于 prompt 2 該序列被 -，*，一個單引號，一個雙引號或者一個美元符代替，這取決于 psql是否等待更多的輸入（因為查詢沒有終止，或著正在一個 /* ... */注釋里面，或者因為你在引號或者美元符擴(kuò)展里面）。對于 prompt 3 該序列不解釋成任何東西。

%x

事務(wù)狀態(tài)：如果不在事務(wù)塊里，是一個空字串，如果在事務(wù)塊里，是 *， 如果在一個失敗的事務(wù)塊里是 !，或者無法判斷事務(wù)狀態(tài)時為 ? （比如，因為沒有連接）。

%digits

指定字節(jié)值的字符被替換到該位置。

%:name:

psql變量name的值。參閱 變量 節(jié)獲取細(xì)節(jié)。

%command

command的輸出， 類似于通常的"反勾號（back-tick）" 替換。

%[ ... %]

提示可以包含終端控制字符，這些字符可以改變顏色，北京，或者提示文本的風(fēng)格， 或者改變終端窗口的標(biāo)題。為了讓 Readline 的行編輯特性正確運(yùn)行， 這些不可打印的控制字符必須設(shè)計成不可見的，方法是用 %[ 和 %] 包圍它們。 在提示符里可能出現(xiàn)這些東西的多個配對。

testdb=> \set PROMPT1 '%[%033[1;33;40m%]%n@%/%R%[%033[0m%#%] '

這樣的結(jié)果是在 VT100 兼容的可顯示彩色的終端上的一個寬體（1;）黑底黃字（33;40）。

要在提示符里插入百分號，鍵入%%。缺省提示符等效于 '%/%R%# ' 用于 prompts 1 和 2，以及'>> ' 用于 prompt 3。

注意: 這個特性是無恥地從tcsh 里剽竊來的。

命令行編輯

psql 為了編輯和檢索命令行的方便支持 Readline 和歷史庫。 命令歷史在 psql 退出的時候自動保存，在 psql 啟動的時候裝載。 還支持 Tab 補(bǔ)齊，盡管該補(bǔ)齊邏輯并不是一個 SQL 分析器必備的。 如果因某些原因你不喜歡 tab 補(bǔ)齊，你可以把下面幾行放在你的家目錄的一個叫 .inputrc 的文件里關(guān)閉這個特性：

$if psql
set disable-completion on
$endif

（這不是psql 的特性， 是 Readline 的。參考它的文檔獲取更多細(xì)節(jié)。）
環(huán)境

PAGER

如果查詢結(jié)果在一頁里放不下，那么它們被定向到這個命令。 典型的值是 more 或者 less。 缺省的是平臺相關(guān)的。我們可以用 \pset 命令關(guān)閉分頁器。

PGDATABASE

缺省數(shù)據(jù)庫

PGHOST
PGPORT
PGUSER

缺省連接參數(shù)

PSQL_EDITOR
EDITOR
VISUAL

\e 命令使用的編輯器。這些變量是按照上面的順序檢查的；設(shè)置最早的最先使用。

SHELL

\! 命令執(zhí)行的命令。

TMPDIR

存儲臨時文件的目錄。缺省是 /tmp。

文件

在啟動之前，psql 視圖讀取系統(tǒng)的 psqlrc 文件和執(zhí)行來自用戶家目錄的文件 ~/.psqlrc 里面的命令。 （在 Windows 里，用戶的啟動文件名字叫 %APPDATA%\postgresql\psqlrc.conf。） 參閱 PREFIX/share/psqlrc.sample 獲取如何設(shè)置全系統(tǒng)的文件的信息。 可將它用于設(shè)置客戶端或者服務(wù)器的風(fēng)格（使用 \set和SET命令）。

系統(tǒng)的 psqlrc 和用戶自己的 ~/.psqlrc 都可以通過在后面附著一個劃線和 PostgreSQL 版本號的方法變得與版本相關(guān)， 比如 ~/.psqlrc-8.1。 匹配版本相關(guān)的文件比無版本的文件優(yōu)先讀取。

命令行歷史存儲在 ~/.psql_history，或者在 Windows 里是 %APPDATA%\postgresql\psql_history。

注意

一些 psql的早期版本允許一個單字母的反斜杠命令（元命令）的第一個參數(shù)直接跟在命令后面， 而不用空白間隔。出于兼容性原因，這個特性仍然在某些程度上被支持，但是我不準(zhǔn)備在這里詳細(xì)解釋，因為我不鼓勵這樣使用。 不過如果你收到莫名其妙的信息，想想這個用法。例如

testdb=> \foo
Field separator is "oo".

可能不是你想要的東西。

psql 只能與同版本的服務(wù)器平穩(wěn)地工作。 這不意味著其他組合會完全失敗，但是可能有微小的或者不那么微小的問題。 如果服務(wù)器的版本不同，反斜杠命令是特別容易失效的。

$ \l #列出所有的數(shù)據(jù)庫
$ \d #查看表的結(jié)構(gòu)
$ \d 表名 #查看指定表的具體結(jié)構(gòu)
$ create database 新數(shù)據(jù)庫名 #創(chuàng)建新的數(shù)據(jù)庫
$ \c 已經(jīng)有的數(shù)據(jù)庫名 #切換當(dāng)前數(shù)據(jù)庫到指定的數(shù)據(jù)庫
$ psql -h 主機(jī)名/ip地址 -p 端口號 數(shù)據(jù)庫名稱 用戶名稱 #連接到指定的數(shù)據(jù)庫
$ \d #顯示所有的表
$ \d 表名 #顯示指定的表的結(jié)構(gòu)
$ \d 索引名 #顯示指定索引的結(jié)構(gòu)
$ \d 后跟通配符或者?等 #？代表匹配一個 代表匹配多個，如\d s*會匹配以s開頭后跟任意個字符的表或者索引并顯示出來，\d s?會匹配以s開頭后跟一個字符的表或者索引并顯示出來
$ \d+ #該命令會比\d命令顯示更詳細(xì)的信息，除了前面介紹的那些，它還會顯示任何與表相關(guān)聯(lián)的注釋，以及表中出現(xiàn)的OID，\d+可以代替之前的任意以\d開頭的命令
$ \dt #只顯示表
$ \di #只顯示所有的索引
$ \ds #只顯示序列
$ \dv #只顯示視圖
$ \df #只顯示函數(shù)
$ \timing on #顯示SQL的執(zhí)行時間
$ \timing off #關(guān)閉顯示SQL的執(zhí)行時間
$ \dn #顯示所有的schema
$ \db #顯示所有的表空間
$ \du 或者 \dg #顯示數(shù)據(jù)庫中的所有角色和用戶
$ \dp 或者 \z 表名 #顯示表的權(quán)限分配情況
$ \encoding utf8 #當(dāng)客戶端的字符編碼和服務(wù)器的不一樣時，可能會顯示亂碼，可以使用\encoding命令來指定客戶端的字符編碼，如使用\encoding utf8來指定客戶端的編碼方式為utf8
\pset命令用于指定輸出的格式，具體如下：
\pset border 0 : 表示輸出內(nèi)容物邊框
\pset border 1 : 表示邊框只在內(nèi)部，默認(rèn)情況下采用的是該條命令
\pset border 2 : 表示內(nèi)外都存在邊框
歷史命令與補(bǔ)全功能
使用上下鍵可以查看歷史命令
兩次tab鍵可以實現(xiàn)命令補(bǔ)全或者給出輸入提示
在psql中事務(wù)是自動提交的，比方說，執(zhí)行完一條create table語句之后，事務(wù)就會被自動的提交，如果不想自動的提交，方法有兩種：
方案一：運(yùn)行begin命令，然后執(zhí)行相應(yīng)的SQL語句，最后在執(zhí)行commit或者rollback語句
方案二：直接使用psql中的命令關(guān)閉自動提交的功能，\set AUTOCOMMIT off ，該命令設(shè)置自動提交關(guān)閉
實際上，MySQL等數(shù)據(jù)庫也是這樣的情況，當(dāng)我們不使用顯示的事務(wù)語句時，每一條SQL語句都被作為一個事務(wù)，或者說數(shù)據(jù)庫內(nèi)部將每一個SQL語句封裝為一個事務(wù)，在PostgreSQL中仍然是這樣的，平時使用時要注意。
得到psql中真實執(zhí)行的SQL語句
aoldbs=# help
You are using psql, the command-line interface to PostgreSQL.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit
aoldbs=#

eg：查看SQL commands
aoldbs=# \h drop table
Command: DROP TABLE
Description: remove a table
Syntax:
DROP TABLE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]

aoldbs=#

\?查看PSQL命令

General
\copyright show PostgreSQL usage and distribution terms
\g [FILE] or ; execute query (and send results to file or |pipe)
\gset [PREFIX] execute query and store results in psql variables
\q quit psql
\watch [SEC] execute query every SEC seconds

Help
\? [commands] show help on backslash commands
\? options show help on psql command-line options
\? variables show help on special variables
\h [NAME] help on syntax of SQL commands, * for all commands

Query Buffer
\e [FILE] [LINE] edit the query buffer (or file) with external editor
\ef [FUNCNAME [LINE]] edit function definition with external editor
\p show the contents of the query buffer
\r reset (clear) the query buffer
\w FILE write query buffer to file

Input/Output
\copy ... perform SQL COPY with data stream to the client host
\echo [STRING] write string to standard output
\i FILE execute commands from file
\ir FILE as \i, but relative to location of current script
\o [FILE] send all query results to file or |pipe
\qecho [STRING] write string to query output stream (see \o)

Informational
(options: S = show system objects, + = additional detail)
\d[S+] list tables, views, and sequences
\d[S+] NAME describe table, view, sequence, or index
\da[S] [PATTERN] list aggregates
\db[+] [PATTERN] list tablespaces
\dc[S+] [PATTERN] list conversions
\dC[+] [PATTERN] list casts
\dd[S] [PATTERN] show object descriptions not displayed elsewhere
\ddp [PATTERN] list default privileges
\dD[S+] [PATTERN] list domains
\det[+] [PATTERN] list foreign tables
\des[+] [PATTERN] list foreign servers
\deu[+] [PATTERN] list user mappings
\dew[+] [PATTERN] list foreign-data wrappers
\df[antw][S+] [PATRN] list [only agg/normal/trigger/window] functions
\dF[+] [PATTERN] list text search configurations
\dFd[+] [PATTERN] list text search dictionaries
\dFp[+] [PATTERN] list text search parsers
\dFt[+] [PATTERN] list text search templates
\dg[+] [PATTERN] list roles
\di[S+] [PATTERN] list indexes
\dl list large objects, same as \lo_list
\dL[S+] [PATTERN] list procedural languages
\dm[S+] [PATTERN] list materialized views
\dn[S+] [PATTERN] list schemas
\do[S] [PATTERN] list operators
\dO[S+] [PATTERN] list collations
\dp [PATTERN] list table, view, and sequence access privileges
\drds [PATRN1 [PATRN2]] list per-database role settings
\ds[S+] [PATTERN] list sequences
\dt[S+] [PATTERN] list tables
\dT[S+] [PATTERN] list data types
\du[+] [PATTERN] list roles
\dv[S+] [PATTERN] list views
\dE[S+] [PATTERN] list foreign tables
\dx[+] [PATTERN] list extensions
\dy [PATTERN] list event triggers
\l[+] [PATTERN] list databases
\sf[+] FUNCNAME show a function's definition
\z [PATTERN] same as \dp

Formatting
\a toggle between unaligned and aligned output mode
\C [STRING] set table title, or unset if none
\f [STRING] show or set field separator for unaligned query output
\H toggle HTML output mode (currently off)
\pset [NAME [VALUE]] set table output option
(NAME := {format|border|expanded|fieldsep|fieldsep_zero|footer|null|
numericlocale|recordsep|recordsep_zero|tuples_only|title|tableattr|pager|
unicode_border_linestyle|unicode_column_linestyle|unicode_header_linestyle})
\t [on|off] show only rows (currently off)
\T [STRING] set HTML <table> tag attributes, or unset if none
\x [on|off|auto] toggle expanded output (currently off)

Connection
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently "aoldbs")
\encoding [ENCODING] show or set client encoding
\password [USERNAME] securely change the password for a user
\conninfo display information about current connection

Operating System
\cd [DIR] change the current working directory
\setenv NAME [VALUE] set or unset environment variable
\timing [on|off] toggle timing of commands (currently off)
! [COMMAND] execute command in shell or start interactive shell

Variables
\prompt [TEXT] NAME prompt user to set internal variable
\set [NAME [VALUE]] set internal variable, or list all if no parameters
\unset NAME unset (delete) internal variable

Large Objects
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID large object operations

標(biāo)題名稱：PSQL工具使用技巧
轉(zhuǎn)載源于：http://www.2m8n56k.cn/article18/joocdp.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供網(wǎng)站策劃、Google、全網(wǎng)營銷推廣、網(wǎng)站排名、面包屑導(dǎo)航、品牌網(wǎng)站制作

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請盡快告知，我們將會在第一時間刪除。文章觀點不代表本網(wǎng)站立場，如需處理請聯(lián)系客服。電話：028-86922220；郵箱：[email protected]。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時需注明來源： 創(chuàng)新互聯(lián)