![[ 永遠的UNIX::UNIX技術資料的寶庫 ]](/images/title.gif) GB | BIG5
|
| 首頁 > 數據庫 > 其它 > 正文 |
 |
| PostgreSQL7.0手冊-用戶手冊-20. 應用 - psql |
| 編譯：何偉平 laser@zhengmai.com.cn (2001-04-21 22:23:36) |
psql
名稱
psql PostgreSQL 交互終端
語法
psql [ options ] [ dbname [ user ] ]
概述
psql 是一個以基終端的 PostgreSQL 前端。它允許你交互地輸入查詢，將它們提交給 PostgreSQL 然閱讀查詢結果．輸入也可以來自一個文件。另外，它還提供一些專有命令（meta-commands）和許多類似 shell 風格的特性供你書寫腳本和完成非常廣泛任務的自動化工作。
描述
與一個數據庫聯接
psql 是一個普通的 Postgres 客戶端應用。為了與一個數據庫聯接，你需要知道你的目標數據庫，服務器的主機名和端口號以及你希望以哪個用戶的身份進行聯接等信息。我們可以通過命令行參數告訴psql 這些信息，分別是 -d，-h，-p，和 -U。如果有個參數不屬任何選項開關，那它會被解釋成數據庫名（或者是用戶名－如果數據庫名稱也給出了．）。不是所有這些選項都是必須的，缺省的也可以。如果你省略主機名，psql 將通過域套接字與本地主機的服務器相聯。缺省的端口號是編譯時確定的。因為數據庫服務器使用同樣的缺省值，所以在大多數設置下，你可能不需要聲明端口號。缺省的用戶名是你的 Unix 用戶名，與數據庫同名。要注意的是你不能用任意用戶名與任何數據庫相聯。你的數據庫管理員應該告訴你你的訪問權限。你可以通過設置幾個環境變量 PGDATABASE，PGHOST，PGPORT，PGUSER 為對應的值的方法節約幾次敲擊。
如果因為任何原因而無法與數據庫相聯（例如，權限不夠，postmaster 沒有運行等），psql 將返回一個錯誤並退出。
輸入查詢
通常狀況下，psql 提供一個帶有 psql 正在與之聯接的接數據庫名的，綴 "=>" 的提示符．例如，
$ psql testdb
Welcome to psql, the PostgreSQL interactive terminal.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help on internal slash commands
\g or terminate with semicolon to execute query
\q to quit
testdb=>
用戶可以在這個提示符下鍵入 SQL 查詢．通常，輸入的行將在查詢終止分號出現時送到端．一行的終止並不結束查詢！因此查詢可以因清晰起見跨越好幾行。如果查詢發送出去而且沒有錯誤，查詢結果會顯示在屏幕上。
當查詢正在進行時，psql 同樣還輪詢由 LISTEN 和 NOTIFY 生成的異步通知信號．
psql 專有命令
你在 psql 裡輸入的任何以不帶引號的反斜槓（'\'）開頭的東西都是psql 專有命令，這些命令是由 psql 自己處理的。這些命令也是令 psql可用管理或書寫腳本的原因。專有命令更常見的叫法是斜槓或反斜槓命令。
一個 psql 命令的格式是反斜槓面緊跟一個命令動詞，然是任意參數．參數與命令動詞和其他參數以任意個空白字符間隔．
要在參數裡面包含空白，你必須用單引號把它包圍起來。要在這樣的參數裡包含單引號，前面加一個反斜槓。任何包含在單引號裡的東西會被進一步進行類 C 的替換，把 \n （新行），\t （tab）， \digits，\0digits 和 \0xdigits （給出的十進制，八進制，或十六進制碼的字符）替換掉。
如果一個不帶引號的參數以冒號（:）開頭，它會被當作一個變量，並且該變量的值會最終成為真正的參數值。（譯注：類似嵌入SQL的變量用法。）
用“反勾號” （backticks（`））引起的內容被當作一個命令行傳入 shell。該命令的輸出（刪除了結尾的新行）被當作參數值。上面描述的轉意（字符）序列在反勾號裡也生效。（譯注：與 shell 程序類似）
有些命令以一個 SQL 標識的名稱（如，一個表名）為參數。這些參數遵循SQL 語法關雙引號的規則：不帶雙引號的標識強制成小寫。對所有其他命令，雙引號沒有特殊含義並且將被當成參數的一部分。
對參數的分析在碰到另一個不帶引號的反斜槓時停止。這裡會認為是一個新的專有命令的開始。特殊序列 \\ （雙反斜槓）標識參數的結尾並將繼續分析面的SQL 查詢（如果存在的話）。這樣 SQL 和 psql 命令可以自由的在一行裡面混合。但是在任何情況下，一條專有命令的參數不能延續超過行尾。
下列專有命令是已定義的：
\a
如果目前的表輸出格式是不對齊的，切換成對齊的。如果是對齊的，切換成不對齊。這條命令是為了向兼容。參閱 \pset 獲取一個通用的解決方法。
\C [ title ]
把正在打印的表的標題設置為一個查詢的結果或者取消這樣的設置。這條命令等效 \pset title title。（這條命令的名稱源“caption”，因為以前只是用在一個HTML 表裡面設置標題。）
\connect (or \c) [ dbname [ username ] ]
與一個新的數據庫建立一個聯接，使用/不用一個用戶名。前面的聯接將關閉。如果 dbname 是 -，那就假設是當前數據庫名稱。
如果省略 username，則假設是當前用戶名。
作為一條特殊規則，不帶任何參數運行 \connect 將以缺省用戶身份與缺省數據庫連接（正如你不帶任何參數運行psql 一樣。）
如果聯接失敗（用戶名錯，訪問拒絕等），那將保留前面的聯接--僅僅是在psql 處交互模式下如此。如果運行的是非交互的腳本，處理會馬上停止，並返回一個錯誤。選擇這樣的區別是一方面為用戶使用方便考慮，另一方面為保証腳本不會碰巧操作了錯誤的數據庫的安全機制考慮的。
\copy table [ with oids ] { from | to } filename | stdin | stdout [ with delimiters 'characters' ] [ with null as 'string' ]
執行前端（客戶端）拷貝．這是一個運行 SQLCOPY 命令的操作，不同的是 SQL COPY 是端在讀寫指明的文件，對應地需要訪問端和特殊的用戶權限，以及受到端對文件系統的訪問權限的限制，而在此命令中 psql 讀寫文件並通過一個本地的文件系統路由從端中取出或寫入的數據．
這條命令的語法是模擬SQL COPY 命令的，參考它的描述獲取細節。要注意的是由此而來，有一些特殊的分析規則應用 \copy 命令。尤其是變量替換規則和反斜槓代換規則不起作用。
小技巧：此操作不象 SQLCOPY 命令這樣高效，因為所有數據必須通過（客戶/服務器)）client/server IP 或套接字聯接．對大數據量的操作，另一種方法更可行。
注意：注意在前端和端拷貝時對 stdin 和 stdout 的解釋的區別：在前端拷貝時，這些總是指psql 的輸入和輸出流。在端拷貝時 stdin 來自 COPY 本身的標準輸入（比如，一個帶有-f 選項的腳本），而 stdout 指的是查詢輸出流（參閱下面的 \o 專有命令）。
\copyright
顯示 PostgreSQL 的版權和版本信息。
\d relation
顯示 relation （可以是表，視圖，索引或序列）的所有列，如果存在地話，它們的類型和存在的任何特殊屬性（象 NOT NULL 或缺省等）也顯示出來。如果實際上這個關系是一個表，任何已定義的索引也會列出來。如果該關系是一個視圖，視圖的定義也會顯示出來。
從 \d+ 來的命令也是一樣的，只不過還顯示與表的列關聯的注解。
注意：如果不帶任何參數調用 \d，等效 \dtvs，將顯示一個所有表，視圖和序列的列表。這完全是出方便的考慮。
\da [ pattern ]
列出所有可用聚集函數，以及它們操作的數據類型。如果聲明了 pattern （一個規則表達式），那只顯示匹配（規則表達式）的聚集函數。
\dd [ object ]
顯示對 object （可以是一個規則表達式）的描述，如果沒有給出參數，顯示所有對象。（“對象”包括聚集，函數，操作符，類型，關系（表，視圖，索引，序列，大對象），規則和觸發器。）例如：
=> \dd version
Object descriptions
Name | What | Description
---------+----------+---------------------------
version | function | PostgreSQL version string
(1 row)
可以用 COMMENT ONSQL 命令生成對對象的描述。
注意：PostgreSQL 在 pg_description 系統表裡存儲對象描述。
\df [ pattern ]
列出所有可用函數，以及它們的參數和返回的數據類型。如果聲明了 pattern （一個規則表達式），那只顯示匹配（規則表達式）的函數。如果使用了 \df+ 的形式，每個函數的附加信息，包括語言和描述也會顯示出來。
\distvS [ pattern ]
這不是一個實際上的命令名稱：字母 i，s，t，v，S 分別代表索引（index），序列（sequence），表（table），視圖（view）和系統表（system table）。你可以以任意順序聲明任意或者所有這些字母獲得這些對象的一個列表，以及它們的所有者。
如果聲明了 pattern，它是一個規則表達式把輸出限制在那些匹配的條目上。如果我們在命令名稱面加一個 "+" ，那每個對象存在的相關描述也會顯示出來。
\dl
這是 \lo_list 的別名，顯示一個大對象的列表。
\do [ name ]
列出所有可用操作符，以及它們的操作數和返回的數據類型。如果聲明了 pattern ，那只顯示匹配的操作符。?/dd>
\dp [ pattern ]
這是一個 \z 的別名，包括它是為了保留其巨大的記憶性價值（顯示權限"display permissions"）。\dT [ pattern ]
列出所有數據類型或那些匹配 pattern 的。這條命令的 \dT+ 形式顯示更多信息。
\edit (or \e) [ filename ]
如果聲明了 filename，則編輯此文件並且在編輯器退出將其內容拷貝回查詢緩沖區。如果沒有給出參數，則把當前查詢緩沖區內容拷貝到一個臨時文件然以相同方式編輯。
然根據一般的psql 規則重新分析查詢緩沖區，這時整個緩沖區當作一個單行。（因此你無法用這個方法制作“腳本”，用 \i 做腳本。）這還意味著如果該查詢以分號結尾（或者包含分號），它就會馬上被執行。否則它只是在查詢緩沖區裡等待。
小技巧：psql 搜索環境變量 PSQL_EDITOR，EDITOR 和 VISUAL（以此順序）查找要用到哪個編輯器。如果上面的都沒有設置，使用 /bin/vi。
\echo text [ ... ]
向標準輸出打印參數，用一個空格分隔並且最跟著一個新行。這個特性在顯示腳本的輸出時會有用。例如：
=> \echo `date`
Tue Oct 26 21:40:57 CEST 1999
如果第一個參數是一個無引號的 -n，那不會寫出結尾的新行。
小技巧：如果你使用 \o 命令重定向你的查詢的輸出，你可能會用 \qecho 取代這條命令。
\encoding [ encoding ]
如果你使用多字節編碼，設置客戶端編碼方式。不帶參數時，這條命令顯示當前的編碼方式。
\f [ string ]
為不對齊的查詢輸出設置域分隔符。缺省時是“|”（一個“管道”符號）。參閱 \pset 獲取設置輸出選項的通用方法。
\g [ { filename | |command } ]
把當前的查詢輸入緩沖區的內容發送給端並且把輸出輸出到可選的 filename 或者把輸出定向到一個獨立的 Unix shell 執行 command。單獨一個 \g 實際上等效一個分號。一個帶有參數的 \g 是“一次性”的 \o 命令的代用品。
\help (or \h) [ command ]
給出指定 SQL 命令的語法幫助。如果沒有給出 command敲?span CLASS="APPLICATION">psql 將列出可獲得語法幫助的所有命令。如果 command 是一個星號（"*"），則顯示所有SQL命令的語法幫助。
注意：為簡化敲擊，包含多個單字的命令不需要引起。因此鍵入 \help alter table 是正確的。
\H
打開 HTML 查詢輸出格式。如果 HTML 格式已經打開，則切換回缺省的對齊的文本格式。這個命令是為了兼容和方便，參閱 \pset 獲取設置其他輸出選項的內容。
\i filename
從文件 filename 中讀取並把其內容當作從鍵盤輸入的那樣執行查詢。
注意：如果你想在屏幕上看到讀入的行，你必須對所有行設置變量 ECHO 。
\l (or \list)
列出服務器上所有數據庫和它們的所有者。在命令名稱面加一個 "+" 還可以看到對數據庫的任何描述。如果你的Postgres 節點是帶著多字節支持編譯的，還可以看到每個數據庫的編碼方式。
\lo_export loid filename
從數據庫裡讀取 OID 為 loid 的大對象並把她寫到 filename 裡。注意這個功能與服務器函數 lo_export 有些微小的區別， lo_export 運行時帶著運行數據庫服務器的用戶權限，而且是在服務器的文件系統上。
小技巧：使用 \lo_list 查看大對象的 OID。
注意：參閱變量 LO_TRANSACTION 的描述獲取關所有大對象操作的重要信息。
\lo_import filename [ comment ]
把文件存儲為一個 PostgreSQL “大對象”。可以帶著一個該對象的注解選項。例如：
foo=> \lo_import '/home/peter/pictures/photo.xcf' 'a picture of me'
lo_import 152801
響應表明此大對象得到一個對象標識 152801，如果你還想訪問該對象，就應該把這個對象標識記住。因此，我們建議總是給每個對象關聯一個人類可讀的注解。那樣就可以用 \lo_list 命令看到這些注解。
注意這條命令與服務器端的 lo_import 有一些區別，因為這條命令是本地用戶在本地文件系統上操作，而不是以服務器用戶在服務器文件系統上操作。
注意：參閱變量 LO_TRANSACTION 的描述獲取關所有大對象操作的重要信息。
\lo_list
顯示一個目前存儲在該數據庫裡的所有 PostgreSQL “大對象”和它們的所有者的列表。
\lo_unlink loid
從數據庫裡刪除 OID 是 loid 的大對象。
小技巧：使用 \lo_list 查找大對象的 OID。
注意：參閱變量 LO_TRANSACTION 的描述獲取關所有大對象操作的重要信息。
\o [ {filename | |command} ]
把面的查詢結果保存到文件 filename 裡或者把面的查詢結果定向到一個獨立的 Unix shell 執行 command。如果沒有聲明參數，查詢輸出重置為 stdout。
“查詢結果”包括所有表，命令響應和從數據庫服務器來的提示，同樣還有各種各樣查詢數據庫的反斜槓命令的輸出（如 \d），但是沒有錯誤信息。
小技巧：要分散查詢結果之間的輸出，用 \qecho。
\p
打印當前查詢緩沖區到標準輸出．
\pset parameter [ value ]
這條命令設置影響查詢結果表輸出的選項。parameter 描述要設置的選項是哪一個。value 的語意也取決它。
可調節的打印選項有：
format
設置輸出格式為 unaligned，aligned，html 或 latex 之一。允許使用唯一的縮寫。（這也意味著一個字母就夠了。）
“Unaligned” （不對齊）把一條記錄的所有域都都輸出到一行，用當前有效的域分隔符分隔。這主要用生成那些要被其他程序讀取的輸出（tab分隔，逗號分隔）。“Aligned”（對齊）模式是標準的，人類可讀的，格式化好了的文本輸出，也是缺省。“HTML” 和“LaTeX” 模式把表輸出為可用文檔裡的對應標記語言。它們還不是完整的文檔！（可能對HTML 變化還不是太大，但是在 LaTeX 裡，你必須有一個完整的文檔包裝器。）
border
第二個參數必須是一個數字。通常，數字越大，表就有越寬的邊界和越多的線，但是這個參數取決實際的格式。在HTML 模式裡，這個參數會直接翻譯成 border=... 屬性，在其他的模式裡，只有值 0 （無邊界），1 （內部分隔線）和 2 （表框架）有意義。
expanded (or x)
在正常和擴展格式之間切換。當打開擴展格式時，所有的輸出都是兩列，域名稱在左，數據在右。這個模式在數據無法放進通常的“水平”模式的屏幕時很有用。
所有四種輸出模式都支持擴展模式。
null
第二個參數是一個字串，用以代表域的值為 null 打印。缺省是什都不打，這樣很容易和類似一個空字串混淆。因此，我們可能選擇 \pset null "(null)"。
fieldsep
聲明在非對齊模式時的域分隔符。這樣我們就可以創建其他程序希望的 tab- 或逗號分隔的輸出。要設置 tab 域分隔符，鍵入 \pset fieldsep "\t"。缺省域分隔符是“|” （一個“管道”符號）。
recordsep
聲明在非對齊模式時的記錄分隔符。缺省是新行字符。
tuples_only (or t)
在完全顯示和只顯示記錄之間切換。完全顯示將顯示象列頭，標題和各種腳注等信息。只顯示記錄模式將只顯示實際的表數據。
title [ text ]
為任何隨打印的表設置標題。這個參數可以用給你的輸出一個描述性標記。如果不帶參數，重置標題。
注意：以前這個參數只影響HTML 模式，現在你可以在任何輸出模式裡設置標題。
tableattr (or T) [ text ]
允許你聲明放在 HTML table 標記裡的任何屬性。例如，可以是 cellpadding 或者 bgcolor。注意你可能不需要在這裡聲明 border，因為已經在 \pset border 裡用過了。
pager
激活分頁器進行表輸出。如果設置了環境變量 PAGER，輸出被定向到指定程序，否則使用 more。
不管怎樣，psql 只在它認為需要的時候使用分頁器。這意味著輸出是到終端去的而那個表很可能無法與屏幕匹配。因為打印過程的模塊化天性，我們不可能每次都準確預計出實際打印的行數。因此psql 在決定何時分頁時可能顯得不是很有識別力。
可以在 Examples 節看到這些不同格式輸出的示例。
小技巧：有很多用 \pset 的快速命令。參閱 \a，\C，\H，\t，\T 和 \x。
注意：無參數運行 \pset 是錯誤的。以這樣調用將顯示當前打印選項狀態。
\q
退出 psql 程序．
\qecho text [ ... ]
這條命令等效 \echo，區別使所有輸出將寫入由 \o 設置的輸出通道。
\r
重置（清空）查詢緩沖區。
\s [ filename ]
將命令行歷史打印出或是存放到 filename。如果省略 filename，歷史將輸出到標準輸出。這個選項只有在psql 配置成使用 GNU 歷史庫才生效。
注意：對 psql v7.0，這個（ GNU 歷史庫）不再是必須的了，實際上，在程序結束時自動保存命令行歷史。每次psql 啟動都會裝載命令行歷史。
\set [ name [ value [ ... ]]]
設置內部變量 name 為 value 或著如果給出了多一個值，設置為所有這些值的聯接結果。如果沒有給出第二個參數，只設變量不設值。要重置一個變量，使用 \unset 命令。
有效的變量名可以包含字符，數字和下劃線。參閱關psql 變量的章節獲取細節。
盡管你可以設置任何變量為任意值，psql 對一些變量特殊對待。它們在關變量的節裡面有文檔。
注意：這條命令是完全和 SQL 命令 SET不一樣的。
\t
切換輸出的列/字段名的信息頭和行記數腳注。這條命令等效 \pset tuples_only，提供主要為了方便。
\T table_options
允許你在使用 HTML 輸出模式時聲明放在 table 標記裡的選項。這條命令等效 \pset tableattr table_options。
\w {filename | |command}
將當前查詢緩沖區輸出到文件 filename 或者定向到 Unix 命令 command。
\x
切換擴展行格式．等效 \pset expanded。
\z [ pattern ]
生成一個帶有訪問權限列表的數據庫中所有表的列表。如果給出任何參數，則被當成一個規則表達式，把列表輸出限制為那些可以匹配的表。
test=> \z
Access permissions for database "test"
Relation | Access permissions
----------+-------------------------------------
my_table | {"=r","joe=arwR", "group staff=ar"}
(1 row )
意思如下：
"=r": PUBLIC 擁有對此表的讀（SELECT）權限。
"joe=arwR": 用戶 joe 擁有讀，寫（UPDATE，DELETE），“追加”（INSERT）權限，以及在表上創建規則的權限。
"group staff=ar": 組 staff 擁有 SELECT 和 INSERT 權限。
命令 GRANT 和 REVOKE 用設置訪問權限。
\! [ command ]
返回到一個獨立的 Unix shell 或者執行 Unix 命令 command。參數不會被進一步解釋，shell 將看到全部參數。
\?
獲得關反斜槓 ("\") 命令的幫助信息。
命令行選項
如果配置好了，psql 理解標準的 Unix 短選項和 GNU 風格的長選項。者不是在所有系統上都能獲得。
-a, --echo-all
在讀取行時想屏幕打印所有內容。這個選項在腳本處理時比交互模式時更有用。這個選項等效設置變量 ECHO 為 all。
-A, --no-align
切換為非對齊輸出模式。（缺省輸出模式是對齊的。）
-c, --command query
聲明 psql 將執行一條查詢字串，query，然退出．這一點在 shell 腳本裡很有用。
query 必須是一條完全可以被端分析的查詢字串（也就是說，它不包含psql 特有的特性），或者是一個反斜槓命令。這樣你就不會混合SQL 和 psql 專有命令。要想混合使用，你可以把字串定向到psql 裡，象這樣：echo "\x \\ select * from foo;" | psql。
-d, --dbname dbname
聲明想要聯接的數據庫名稱．等效在命令行行上把 dbname 聲明為第一個無選項參數.
-e, --echo-queries
聲明要聯接的數據庫名．等效把變量 ECHO 設置為 queries。
-E, --echo-hidden
回顯由 \d 和其他反斜槓命令生成的實際查詢。如果你希望在你自己的程序裡包含類似的功能，你就可以使用這個選項。這等效在psql 裡設置變量 ECHO_HIDDEN。
-f, --file filename
使用 filename 作為查詢的語句源而不是交互式讀入查詢。在處理完文件，psql 結束。這個選項在很多方面等效內部命令 \i。
使用這個選項與用 psql < filename 有微小的區別。通常，兩者都回按照你預期那樣運行，但是使用 -f 打開了一些很好的特性，比如帶行號的錯誤信息。而且，使用這個選項還有可能有減小啟動負荷的機會。另一方面，如果你把所有內容手工輸入，使用 shell 輸入定向的方式（理論上）能保証生成和你已經得到的完全一樣的輸出（譯注：重復運行命令）。
-F, --field-separator separator
使用 separator 作為域分隔符．等效 \pset fieldsep 或 \f。
-h, --host hostname
聲明正在運行 postmaster 的主機名．如果沒有此選項，將使用本地的Unix域套接字進行通訊．
-H, --html
打開 HTML 格式輸出。等效 \pset format html 或 \H 命令。
-l, --list
列出所有可用的數據庫，然退出．其他非聯接選項將被忽略．類似內部命令 \list。
-o, --output filename
將所有查詢輸出定向到文件 filename。這個選項等效命令 \o。
-p, --port port
聲明被 postmaster 用偵聽的 TCP/IP 端口或使用的缺省本地Unix主控套接字文件句柄．缺省的是環境變量 PGPORT 的值，如果沒有設置的話是編譯是聲明的端口，通常是5432。
-P, --pset assignment
允許你在命令行上以 \pset 的風格設置打印選項。要注意的是你在這裡用等號分割名稱和值，而不能用空格。因此要把輸出格式設置為 LaTeX，你可以敲入 -P format=latex。
-q
聲明 psql 將"安靜地"執行處理任務．缺省時psql將打印歡迎和許多其他輸出信息。如果使用了此選項，這些都不出現。這在和 -c 選項一起使用時很有效．在 psql 裡，你可以通過設置 QUIET 變量實現同樣效果。
-R, --record-separator separator
使用 separator 做為記錄分隔符。等效 \pset recordsep 命令。
-s, --single-step
進入單步模式運行。意味著每個查詢在發往端之前都要提示用戶，用這個選項也可以取消執行。此選項主要用調試腳本。
-S, --single-line
進入單行運行模式，這時每個查詢都將由換行符結束，象分號那樣。
注意：注意這個模式是給那些堅持要這個特性的人的，我們不鼓勵你這用。實際上，如果你在一行裡混合使用SQL 和專有命令，執行的順序對不熟練的用戶而言不總是清晰的。
-t, --tuples-only
關閉打印列名稱和結果行計數腳注等信息。完全等效 \t。
-T, --table-attr table_options
允許你聲明放在 HTML table 標記裡的選項。參閱 \pset 獲取細節。
-u
讓 psql 在和數據庫聯接之提示輸入用戶的用戶名和口令。
我們不讚成使用這個選項，因為它在概念上有漏洞。（提示輸入非缺省用戶名和提示輸入端要求的口令是完全兩碼事。）我們鼓勵你用-U 和 -W 選項取代。
-U, --username username
以用戶 username 代替缺省用戶與數據庫聯接。（當然，你必須有這做的權限。）
-v, --variable, --set assignment
進行一次變量分配，象內部命令 \set 那樣。注意，如果有變量名和值的話，你必須在命令行上用等號分隔它們。要重置一個變量，去掉等號。這個分配是在啟動的很早的階段進行的，所以為內部使用保留的變量可能被再次覆蓋。
-V, --version
顯示 psql 版本。
-W, --password
要求 psql 在與一個數據庫聯接前提示輸入口令。這個選項將在整個會話過程中有效，即使你用專有命令 \connect 改變了所聯接的數據庫。
對版本7.0，如果端要求口令認証，psql 自動提出一個口令提示符。因為目前這個特性是以一個“hack”為基礎，自動識別有可能神秘地失效，因此用這個選項強制一個提示符。如果沒有聲明口令提示符而端要求口令認証，那聯接企圖將失敗。
-x, --expanded
打開擴展行格式模式．等效 \x。
-X, --no-psqlrc
不讀取啟動文件 ~/.psqlrc。
-?, --help
顯示關 psql 命令行參數的幫助。
高級特性
變量
psql 提供類似通常 Unix 命令 shell 那樣的變量替換特性。這個特性是新引入的還不是很復雜，但是我們計劃在今擴展它。變量只是簡單的名稱/值的對，這裡的值可以是任何長度的任何值。要設置一個變量，使用psql 專有命令 \set：
testdb=> \set foo bar
把變量“foo” 設置為值“bar”。要檢索變量的內容，在變量名前面放上冒號然把它用在任意斜槓命令裡：
testdb=> \echo :foo
bar
注意：\set 的參數服從和其他命令一樣的替換規則。因此你可以構造有趣的引用，象 \set :foo 'something' 這樣，獲得分別象Perl 或 PHP那樣有名的“軟鏈接”（“soft links”）或“變量 變量”（“variable variables”）。不幸的是（或者 萬幸的？），用這些構造不能做任何有用的事情。另一方面，\set bar :foo 是一個非常有效的拷貝變量的方法。
如果你不帶第二個參數調用 \set，那只是設置這個變量而沒有值。要重置（或刪除）一個變量，使用命令 \unset。
psql 的內部變量可以包括任意順序，任意數量的字母，數字和下劃線。有一些常用變量被psql 另眼相待。它們是一些選項設置，這些選項在運行時可以通過改變變量的值或者改變一些應用的表現狀態而改變。盡管你可以把這些變量用其他用途，但是我們不鼓勵這做，因為程序的特性可能會很快變得非常奇怪。通常，所有特殊對待的變量都是由大寫字母組成（可能還有數字和下劃線）。為了保証和未來的最大限度的兼容性，請避免使用這樣的變量。下面是一個所有特殊對待的變量列表。
DBNAME
你正在聯接著的數據庫名稱。每次你與一個數據庫聯結都會設置這個值（包括程序啟動），但是可以刪除。
ECHO
如果置為“all”，輸入的或者來自一個腳本的所有行在分析或執行前都寫到標準輸出。要在程序啟動時聲明這些，使用-a 開關。如果設置為“queries”，psql 只是在查詢發送給端之前打印出來。實現這個功能的命令行選項是-e。
ECHO_HIDDEN
當設置了這個變量並且一個反斜槓命令查詢數據庫時，首先顯示查詢。這樣你可以學習PostgreSQL 內部的東西並且在你自己的程序裡提供類似功能。如果你設置該變量的值為“noexec”，查詢只是顯示出來但是實際上不發送到端和執行。
ENCODING
當前的客戶端多字節編碼方式。如果你沒有設置使用多字節字符，這個變量將總是包含“SQL_ASCII”。
HISTCONTROL
如果這個變量設置為 ignorespace，以空格開始的行將不會進入歷史列表。如果設置為變量 ignoredups，與以前歷史記錄裡匹配的行也不會進入歷史記錄。值 ignoreboth 是上面兩個的結合。如果刪除此變量或者其值為任何與上面的值不同的東西，所有交互模式讀入的行都被保存入歷史列表。
注意：這個特性是無恥地從 bash 裡剽竊來的。（譯注：老兄，太客氣了吧，要不freesoft有何意義？！：）
HISTSIZE
存在命令歷史裡的命令的個數。缺省值是 500。
注意：這個特性是無恥地從 bash 裡剽竊來的。：-）
HOST
當前你正聯接的數據庫服務器主機。這是在每次你與數據庫聯接時（包括程序啟動）設置的，但是可以刪除。
IGNOREEOF
如果刪除此變量，向一個交互的 psql 會話發送一個 EOF 字符（通常是 Control-D）將終止應用。如果設置為一個數字值，那在應用終止前該數值的 EOF 字符將被忽略。如果設置了此變量但是沒有數字值，缺省是 10。
注意：這個特性是無恥地從 bash 裡剽竊來的。
LASTOID
最影響的 oid 值，即為從一條 INSERT 或 lo_insert 命令返回的值。此變量只保証在下一條 SQL 命令的結果顯示之前有效。
LO_TRANSACTION
如果你使用 PostgreSQL 大對象接口存儲無法放進一條記錄裡的特殊數據，所有操作必須包含在一個事務塊裡面。（參閱關大對象接口的文檔獲取更多信息。）因為psql 在你調用它的內部命令 \lo_export，\lo_import，\lo_unlink 之一時無法跟蹤你是否有一個正在處理的事務，所以它必須採取一些任意的動作。這個動作可能是回卷任何正在處理的事務，或者提交這樣的事務，或者什也不做。對面一種情況，你必須提交你自己的 BEGIN TRANSACTION/COMMIT 塊否則結果將是不可預料的（通常導致在任何情況下希望的動作都不會發生）。
要選擇你希望做的事，你可以把此變量設置為“rollback”，“commit”或“nothing”之一。缺省是回卷事務。如果你只是希望裝載一個或者少數幾個對象，這個方法很好。但是如果你希望傳輸許多大對象，我們建議給所有命令提供一個顯式的事務塊。
ON_ERROR_STOP
缺省時，如果非交互的腳本碰到一個錯誤，象一條錯誤的SQL 查詢或者內部專有命令，處理會繼續進行。這是psql 的傳統特性，但是有時候我們不太希望這樣。如果設置了這個變量，腳本處理將馬上停止。如果該腳本是從另外一個腳本調用的，那個腳本也會按同樣的方式停止。如果最外層的腳本不是從一次交互的psql 會話中調用的而是用 -f 選項調用的，psql 將返回錯誤代碼 3，以示這個情況與致命錯誤條件的區別（錯誤代碼 1）。
PORT
當前你正在聯接的數據庫服務器的端口。這是在每次你與數據庫聯接時（包括程序啟動）設置的，但是可以刪除。
PROMPT1, PROMPT2, PROMPT3
這些指明 psql 顯示的提示符看上去象什。參閱下面的 "提示（符）" 。
QUIET
這個變量等效命令行選項 -q。可能在交互模式下沒有什用。
SINGLELINE
這個變量等效設置命令行選項 -S。你可以在運行時刪除或設置它。
SINGLESTEP
這個變量等效命令行選項 -s。
USER
當前你正用聯接的數據庫用戶。這是在每次你與數據庫聯接時（包括程序啟動）設置的，但是可以刪除/重置。
SQL Interpolation
一個附加的 psql 變量的有用特性是你可以把它們替換（“改寫”）成正規的SQL 語句。這樣做的語法同樣還是變量名前面加一個冒號（：）。
testdb=> \set foo 'my_table'
testdb=> SELECT * FROM :foo;
將會查詢表 my_table。變量的值是逐字拷貝的，所以它甚至可以包含不對稱的引號或反斜槓命令。你必須保証你輸入的東西是有意義的。變量替換將不會在引起來的SQL 語句裡面發生。
利用這個功能的一個時髦的應用是通過使用一個隨的語句中最插入的OID 建立一個外鍵（scenario ？）。另一個可能用到這個機制的地方是把一個文件的內容拷貝到一個域裡面去。首先把文件裝載到一個變量然想上面那樣處理。
testdb=> \set content '\'' `cat my_file.txt` '\''
testdb=> INSERT INTO my_table VALUES (:content);
這樣處理的一個可能問題是 my_file.txt 可能包含單引號。這些需要被轉意以免在處理第三行時不會導致語法錯誤。可以使用程序sed 來做這個處理：
testdb=> \set content `sed -e "s/'/\\\\\\'/g" < my_file.txt`
觀察正確數量的反斜槓（6）！你可以這樣解釋它：在psql 分析完這行，它把 sed -e "s/'/\\\'/g" < my_file.txt 傳遞給 shell。shell 將對雙引號裡的東西做其處理然用參數 -e 和 s/'/\\'/g 執行 sed。當sed 分析這些時它將把雙反斜槓替換為單個反斜槓然進行替換。可能有時候你認為所有 Unix 命令使用同一個轉意字符是個好事。但具有諷刺意味的事實是你可能不得不轉意所有反斜槓，因為SQL 文本常量同樣也慘遭這種解釋。這種情況下你可能最好在外部準備文件。
因為冒號也可以合法的出現在查詢裡，便有下面規則的應用：如果沒有設置變量，字符序列“冒號+名稱”不會被改變。在任何情況下你都可以用反斜槓轉意冒號以保護它免被解釋。（變量的冒號語法是SQL 用嵌入查詢語言的標準，如 ecpg。用數組片段和類型轉換的冒號語法是PostgreSQL 擴展，因此有沖突。）
提示（符）
psql 使用的提示符可以根據你的喜好客戶化。三個變量 PROMPT1，PROMPT2 和 PROMPT3 包含描述提示符的外觀的字串和特殊轉意序列。Prompt 1 是 psql 請求一個新查詢時的使用的正常提示符。Prompt 2 是在一個查詢輸入期待更多輸入時（因為查詢沒有用一個分號結束或者引號沒有關閉）顯示的提示符。Prompt 3 在你運行一個 SQL COPY 命令和等待你在終端上鍵入記錄時使用。
相應的提示符變量的值是按字面打印的，除非碰到一個百分號（“%”）。這時某些其他的文本被替換，替換為何物取決下一個字符。已定義的替換是：
%M
數據庫服務器的主機名（或者是“localhost”如果使用的是 Unix 域套接字）。
%m
數據庫服務器的主機名刪去第一個點面的部分剩下的東西。（譯注：短域名）
%>
數據庫服務器正在偵聽的端口號。
%n
你聯接使用的用戶名（不是你的本地系統用戶名）。
%/
當前數據庫名稱。
%~
類似 %/，但如果數據庫是你的缺省數據庫輸出是“~” （波浪線（tilde））。
%#
如果當前用戶是數據庫超級用戶，使用“#”，否則用“>”。
%R
對 prompt 1 通常是“=”，但是如果是單行模式則是“^”，而如果會話與數據庫斷開（如果 \connect 失敗可能發生）是“!”。對 prompt 2 該序列被“-”，“*”，一個單引號或者一個雙引號代替，這取決psql 是否等待更多的輸入（因為查詢沒有終止，或著正在一個 /* ... */ 注釋裡面，或者因為你在引號裡面）。對 prompt 3 該序列不解釋成任何東西。
%digits
如果 digits 以 0x 開頭，那其余字符被解釋成一個十六進制數字並且替換為對應（十六進制碼）的字符。如果第一個數字是 0 ，該字符被解釋成一個八進制數字並且替換為對應的（八進制碼）的字符。否則認為是一個十進制數字。
%:name:
psql 變量 name 的值。參閱 "變量" 節獲取細節。
%`command`
command 的輸出，類似通常的反勾號（“back-tick”）替換。
要在提示符裡插入百分號，鍵入 %%。缺省提示符等效 '%/%R%# ' 用 prompts 1 和 2，以及 '>> ' 用 prompt 3。
注意：這個特性是無恥地從 tcsh 裡剽竊來的。
雜項
psql 正常結束時向 shell 返回 0，發生自身致命錯誤（用光內存，文件沒有找到）時返回 1，與端聯接出錯和會話不是交互的時候返回 2，如果在一個腳本裡面發生錯誤或者變量 ON_ERROR_STOP 被設置了返回 3。
在啟動之前，psql 試圖讀取並執行文件 $HOME/.psqlrc 裡的命令。這個特性可以用來按口味設置客戶端或者服務器（用 \set 和 SET 命令）。
GNU readline
psql 為了編輯和檢索命令行的方便支持 readline 和歷史庫。命令歷史存放在你的家目錄的一個叫 .psql_history 的文件裡，並且當 psql 啟動的時候會裝載進來。Tab-補齊同樣也被支持，盡管該補齊邏輯並不是一個SQL 分析器必備的。如果可能，psql 會自動制作成使用這些特性。如果因某些原因你不喜歡 tab 補齊，你可以把下面幾行放在你的家目錄的一個叫 .inputrc 的文件裡關閉這個特性：
$if psql
set disable-completion on
$endif
（這不是 psql 的特性，是 readline 的。參考它的文檔獲取更多細節。）
如果你安裝了行讀（readline）庫，但是 psql 好象沒有使用它，你必須確保 PostgreSQL 的頂級 configure 腳本可以找到該庫。configure 需要能夠在合適的目錄裡找到庫 libreadline.a （或者一個等效的共享庫）和 頭文件 readline.h 和 history.h （或者 readline/readline.h 和 readline/history.h）。如果你的庫和頭文件安裝在某個陰暗的角落，你必須告訴 configure 它們在哪裡，例如：
$ ./configure --with-includes=/opt/gnu/include --with-libs=/opt/gnu/lib ...
然你不得不重新編譯 psql （不必重新編譯整個代碼樹）。
GNU 行讀庫可以從 GNU 計劃的 FTP 服務器 ftp://ftp.gnu.org 得到。
例子
注意：本節只是顯示了 psql 少數幾個例子。如果你希望學習 SQL 或者熟悉 Postgres，你可能願意閱讀一下包含在這個版本裡的教程。
第一個例子演示了如何把一個查詢分成多個行進行輸入。注意提示符的變化。
testdb=> CREATE TABLE my_table (
testdb-> first integer not null default 0,
testdb-> second text
testdb-> );
CREATE
現在再看看表定義：
testdb=> \d my_table
Table "my_table"
Attribute | Type | Modifier
-----------+---------+--------------------
first | integer | not null default 0
second | text |
這裡你決定把提示符變成更有趣的東西：
testdb=> \set PROMPT1 '%n@%m %~%R%# '
peter@localhost testdb=>
假設你用數據填充了表並且想看一眼：
peter@localhost testdb=> SELECT * FROM my_table;
first | second
-------+--------
1 | one
2 | two
3 | three
4 | four
(4 rows)
注意 int4 列是怎樣右對齊的以及 text 列是如何左對齊的。你可以用 \pset 命令讓這個查詢看起來不一樣。
peter@localhost testdb=> \pset border 2
Border style is 2.
peter@localhost testdb=> SELECT * FROM my_table;
+-------+--------+
| first | second |
+-------+--------+
| 1 | one |
| 2 | two |
| 3 | three |
| 4 | four |
+-------+--------+
(4 rows)
peter@localhost testdb=> \pset border 0
Border style is 0.
peter@localhost testdb=> SELECT * FROM my_table;
first second
----- ------
1 one
2 two
3 three
4 four
(4 rows)
peter@localhost testdb=> \pset border 1
Border style is 1.
peter@localhost testdb=> \pset format unaligned
Output format is unaligned.
peter@localhost testdb=> \pset fieldsep ","
Field separator is ",".
peter@localhost testdb=> \pset tuples_only
Showing only tuples.
peter@localhost testdb=> SELECT second, first FROM my_table;
one,1
two,2
three,3
four,4
還可以用短（縮寫）命令：
peter@localhost testdb=> \a \t \x
Output format is aligned.
Tuples only is off.
Expanded display is on.
peter@localhost testdb=> SELECT * FROM my_table;
-[ RECORD 1 ]-
first | 1
second | one
-[ RECORD 2 ]-
first | 2
second | two
-[ RECORD 3 ]-
first | 3
second | three
-[ RECORD 4 ]-
first | 4
second | four
附錄
毛病和聲明
一些 psql 的早期版本允許第一個參數（單字母）直接跟在命令面。出兼容性原因，這個特性仍然在某些程度上被支持，但是我不準備在這裡詳細解釋，因為我不鼓勵這樣使用。不過如果你收到莫名其妙的信息，想想這個用法。例如
testdb=> \foo
Field separator is "oo".
可能不是你想要的東西。
psql 只能與同版本的服務器平穩地工作。這不意味著其他組合會完全失敗，但是可能有微小的或者不那微小的問題。
在一個“拷貝入”（數據發送給服務器）過程中按下 Control-C 並不顯示出最典型的特征。如果你收到一條類似下面這樣的信息“PQexec: you gotta get out of a COPY state yourself”，只需要輸入 \c - - 重置聯接即可。
(http://www.fanqiang.com)
進入【UNIX論壇】
|
|
| 相關文章 |
PostgreSQL7.0手冊-附錄-文檔 (2001-04-21 23:50:44)
PostgreSQL7.0手冊-附錄-日期/時間支持-CVS 倉庫 (2001-04-21 23:48:48)
PostgreSQL7.0手冊-教程 -73. Postgres SQL 高級特性 (2001-04-21 23:45:36)
PostgreSQL7.0手冊-教程 -72. 查詢語言 (2001-04-21 23:44:40)
PostgreSQL7.0手冊-教程 -71. 開始 (2001-04-21 23:42:54)
PostgreSQL7.0手冊-教程 -70. 體系結構 (2001-04-21 23:41:58)
PostgreSQL7.0手冊-教程 -69. SQL (2001-04-21 23:41:23)
PostgreSQL7.0手冊-開發者手冊 -68. 分頁文件 (2001-04-21 23:39:22)
PostgreSQL7.0手冊-開發者手冊 -67. 端接口 (2001-04-21 23:38:34)
PostgreSQL7.0手冊-開發者手冊 -66. gcc 缺省優化 (2001-04-21 23:37:20)
|
===更多相關=== |
|
|
|
★ 樊強制作 歡迎分享 ★ |