PostgreSQL7.0手冊-用戶手冊-1. 簡介

2019-09-08 23:32:56

字體：大中小

供稿：網(wǎng)友

PostgreSQL
The　PostgreSQL　Development　Team
Edited　by
Thomas　Lockhart
PostgreSQLis　Copyright　?1996-2000　by　PostgreSQL　Inc.　

編譯：何偉平　　laser@zhengmai.com.cn　

中文譯稿版權(quán)聲明：　

本文的中文譯稿版權(quán)屬于其中文譯稿作者。您可對(duì)本手冊進(jìn)行非商業(yè)用途的自由傳播，但務(wù)必保證手冊的完整性，轉(zhuǎn)載時(shí)請保留本版權(quán)聲明．由于譯者水平有限，錯(cuò)誤之處在所難免，希望各位用戶指正．由此帶來的一切后果，本人概不負(fù)責(zé)．　

第一章.　簡介
內(nèi)容　
何為　Postgres？　
　簡單回顧　Postgres　
關(guān)于這個(gè)版本　
資源　
術(shù)語　
符號(hào)　
問題匯報(bào)指導(dǎo)　
Y2K　聲明　
版權(quán)和商標(biāo)　
這份文檔是最初由加州大學(xué)伯克利分校開發(fā)的　PostgreSQL　數(shù)據(jù)庫管理系統(tǒng)的用戶手冊．PostgreSQL以　Postgres　release　4.2為基礎(chǔ)?！‘?dāng)初由　Michael　Stonebraker　教授領(lǐng)導(dǎo)的　Postgres　　項(xiàng)目，是由高級(jí)防務(wù)研究項(xiàng)目局（Defense　Advanced　Research　Projects　Agency）（DARPA）　，　陸軍研究處?。ˋRO?。铱茖W(xué)基金會(huì)?。∟ational　Science　Foundation）（NSF），和　ESL　公司贊助進(jìn)行的?！?
何為　Postgres？
傳統(tǒng)的關(guān)系型數(shù)據(jù)庫管理系統(tǒng)　（　DBMS?。≈С忠粋€(gè)由命名關(guān)系（表）的集合（包括特定類型的屬性/字段）組成的數(shù)據(jù)模型．在現(xiàn)代的商用系統(tǒng)中，可能的類型通常包括浮點(diǎn)數(shù)，　整數(shù)，　字符串，　金額及日期．　現(xiàn)在，　人們普遍認(rèn)為這個(gè)模型已經(jīng)不能滿足未來的數(shù)據(jù)處理應(yīng)用的需要了．而關(guān)系型模型成功地取代了以前的模型在某種程度上來說是因?yàn)樗暮唵危‘?dāng)然，正如我們常說的，　簡單通常會(huì)使某些應(yīng)用的實(shí)現(xiàn)變得非常困難．　Postgres　通過一種讓用戶可以很容易擴(kuò)展系統(tǒng)的方法整合了下面四種基本概念，使其能提供可觀的附加功能：　
　　　
　類/表（classes）　
繼承（inheritance）　
類型（types）　
函數(shù)（functions）　

其他特性還提供了附加的功能和靈活性：　
　　　
　約束（constraints）　
觸發(fā)器（triggers）　
規(guī)則（rules）　
事務(wù)完整（transaction　integrity）　

這些特性將　Postgres　置于對(duì)象－關(guān)系　(object-relational)　型數(shù)據(jù)庫的范疇．　請注意，　這是和那些所謂的面向?qū)ο?object-oriented)　的數(shù)據(jù)庫不同的概念；面向?qū)ο笮蛿?shù)據(jù)庫通常并不適合于支持傳統(tǒng)的關(guān)系型數(shù)據(jù)庫語言．　所以，　盡管　Postgres　有一些面向?qū)ο蟮奶匦?，　它仍然屬于關(guān)系型數(shù)據(jù)庫的范疇，　事實(shí)上，　一些商用數(shù)據(jù)庫最近已經(jīng)集成了一些　Postgres　所領(lǐng)先的特性．

--------------------------------------------------------------------------------
簡單回顧　Postgres
--------------------------------------------------------------------------------

現(xiàn)在被稱為　PostgreSQL　的對(duì)象-關(guān)系型數(shù)據(jù)庫管理系統(tǒng)（有一段時(shí)間被稱為Postgres95　）是從伯克利寫的　Postgres　軟件包發(fā)展而來的。經(jīng)過十幾年的發(fā)展，PostgreSQL世界上可以獲得的最先進(jìn)的開放源碼的數(shù)據(jù)庫系統(tǒng)，它提供了多版本并行控制，支持幾乎所有　SQL　構(gòu)件（包括子查詢，事務(wù)和用戶定義類型和函數(shù)），并且可以獲得非常廣闊范圍的（開發(fā)）語言綁定（包括　C，C++，Java，perl，tcl，和python）?！?
伯克利的　Postgres　項(xiàng)目
PostgresDBMS　的實(shí)現(xiàn)始于1986年，　該系統(tǒng)最初的概念詳見　Postgres的設(shè)計(jì)．最早的數(shù)據(jù)模型定義見Postgres　數(shù)據(jù)模型．當(dāng)時(shí)的規(guī)則系統(tǒng)設(shè)計(jì)在　Postgres　規(guī)則系統(tǒng)設(shè)計(jì)　里描述．存儲(chǔ)管理器的理論基礎(chǔ)和體系結(jié)構(gòu)在　Postgres　存儲(chǔ)系統(tǒng)　里有詳細(xì)描述．　
從那以后，　Postgres　經(jīng)歷了幾次主要的版本更新．第一個(gè)演示性的系統(tǒng)在1987年便可用了，　并且在1988年的ACM-SIGMOD　大會(huì)上展出．　我們在1989年發(fā)布版本　1（在　Postgres的實(shí)現(xiàn)里有描述）給一些外部的用戶使用．作為對(duì)第一個(gè)規(guī)則系統(tǒng)的批評(píng)的響應(yīng)，（對(duì)　Postgres　規(guī)則系統(tǒng)的討論），我們重新設(shè)計(jì)了規(guī)則系統(tǒng)（On　Rules,　Procedures,　Caching　and　Views　in　Database　Systems）并在1990年6月發(fā)布了使用新規(guī)則系統(tǒng)的版本　2．　版本　3　在1991年出現(xiàn)，　增加了多存儲(chǔ)管理器的支持，　并且改進(jìn)了查詢執(zhí)行器，重新編寫了重寫規(guī)則系統(tǒng)．　從那以后，　直到　Postgres95發(fā)布發(fā)布前（見下文），工作都集中在移植性和可靠性上?！?

Postgres　已經(jīng)被用于許多研究或?qū)嶋H的應(yīng)用中去了．這些應(yīng)用包括：　一個(gè)財(cái)務(wù)數(shù)據(jù)分析系統(tǒng)，　一個(gè)噴氣引擎性能監(jiān)控軟件包，　一個(gè)小行星跟蹤數(shù)據(jù)庫，一個(gè)醫(yī)療信息數(shù)據(jù)庫和一些地理信息系統(tǒng)．　Postgres　還被許多大學(xué)用于教學(xué)用途．　最后，Illustra　Information　Technologies?。ê髞聿⑷搿nformix　）拿到代碼并使之商業(yè)化．　在1992年末Postgres　成為　Sequoia　2000　科學(xué)計(jì)算項(xiàng)目的首要數(shù)據(jù)管理器．　

到了1993年，　外部用戶的數(shù)量幾乎翻番．　隨著用戶的增加．　用于源代碼維護(hù)的時(shí)間日益增加占用了太多本應(yīng)該用于數(shù)據(jù)庫研究的時(shí)間，　于是該項(xiàng)目在版本4.2時(shí)正式終止．

Postgres95
在1994年，Andrew　Yu　和　Jolly　Chen　向　Postgres中增加了SQL語言的解釋器．并隨后將Postgres95源代碼發(fā)布到互聯(lián)網(wǎng)上供大家使用，成為一個(gè)開放源碼的，原先伯克利Postgres代碼的繼承者．　
Postgres95　所有源代碼都是完全的　ANSI　C　，　而且代碼量減少了25%．　并且有許多內(nèi)部修改以利于提高性能和代碼的維護(hù)性．Postgres95　v1.0.x　在進(jìn)行Wisconsin　Benchmark　測試時(shí)大概比　v4.2快30-50%．　除了修正了一些錯(cuò)誤，其他的一些主要改進(jìn)還有：　
原來的查詢語言　Postquel　被　SQL　取代（在　server　端實(shí)現(xiàn)）．在PostgreSQL　之前還不支持子查詢（但這個(gè)功能可以在　Postgres95　里面由用戶定義的　SQL　函數(shù)實(shí)現(xiàn)）。重新實(shí)現(xiàn)了聚集。同時(shí)還增加了對(duì)　``GROUP　BY''的支持．　C　程序仍可以調(diào)用　libpq　接口函數(shù)．　
在監(jiān)控程序方面，　增加了新利用　GNUreadline　進(jìn)行交互查詢的監(jiān)控程序（psql）?！?
增加了新的前端庫，　libpgtcl，　用以支持以　Tcl為基礎(chǔ)的客戶端．一個(gè)樣本shell，pgtclsh，提供了新的　Tcl命令用于　tcl　程序和　Postgres95　后端之間的交互．　

徹底重寫了大對(duì)象的接口．　保留了將大對(duì)象轉(zhuǎn)置（Inversion　）作為存儲(chǔ)大對(duì)象的唯一機(jī)制．（去掉了的轉(zhuǎn)置（Inversion?。┪募到y(tǒng)。）　

去掉了記錄級(jí)（instance-level?。┑囊?guī)則系統(tǒng)．　但通過重寫規(guī)則仍可以使用規(guī)則．　

在發(fā)布的源碼中增加了一個(gè)簡短的常用　SQL　和　Postgres95　特有的　SQL　特性的教程．　

用GNU　make?。ㄈ〈薆SD　make）用于制作．　同樣，　Postgres95　可以使用不加補(bǔ)丁的gcc（修正了偶數(shù)字節(jié)數(shù)據(jù)（　doubles?。┑膶?duì)齊問題）．

PostgreSQL
到了1996年，　我們很明顯的看出“Postgres95”這個(gè)名字已經(jīng)不能經(jīng)得起時(shí)間的考驗(yàn)了．于是我們起了一個(gè)新名字PostgreSQL　用于反映最初的　Postgres　和最新的使用　SQL的版本之間的關(guān)系．　同時(shí)版本號(hào)也重新從6.0開始，　將版本號(hào)放回到最初的由　Postgres項(xiàng)目開始的順序中去．　
Postgres95　的版本的開發(fā)重點(diǎn)放在標(biāo)明和理解現(xiàn)有的后端代碼上．　PostgreSQL　開發(fā)重點(diǎn)轉(zhuǎn)到了一些有爭議的特性和功能上了，當(dāng)然各個(gè)方面的工作都在同時(shí)進(jìn)行．　

PostgreSQL　主要的改進(jìn)有：　

表級(jí)鎖被多版本并行控制取代，這樣就允許讀操作在寫操作活躍時(shí)連續(xù)地讀取一致的數(shù)據(jù)，并且令數(shù)據(jù)庫等待執(zhí)行查詢時(shí)用　pg_dump　進(jìn)行熱備份成為可能?！?
許多重要的后端特性，包括子查詢，缺?。ㄖ担s束和觸發(fā)器都實(shí)現(xiàn)了．　

增加了附加的　SQL92－兼容的語言特性，包括主鍵，引用標(biāo)識(shí)，強(qiáng)制的語義字符串類型轉(zhuǎn)換(?literal　string　type　coersion)，類型轉(zhuǎn)換，以及二進(jìn)制和十六進(jìn)制整數(shù)的輸入．　

改進(jìn)了內(nèi)建的數(shù)據(jù)類型，　包括新的大范圍日期/時(shí)間類型和附加幾何數(shù)據(jù)類型的支持．　

總體上后端代碼的速度提高了大約20-40%，而且自v6.0起后端的啟動(dòng)時(shí)間縮短了80%．
--------------------------------------------------------------------------------
關(guān)于這個(gè)版本
--------------------------------------------------------------------------------

PostgreSQL　可免費(fèi)獲得．　這個(gè)手冊描述了版本　7.0　的PostgreSQL．　
我們將用　Postgres　代表發(fā)布了的　PostgreSQL．　

有關(guān)當(dāng)前支持的平臺(tái)，　請參閱管理員手冊．　一般說來　，　Postgres　可以移植到任何有完全　libc　庫支持的　Unix/Posix－兼容的系統(tǒng)上．

--------------------------------------------------------------------------------
資源
--------------------------------------------------------------------------------

本手冊由以下幾部分組成：　
教程　
給新用戶的介紹，不包括高級(jí)特性．　
用戶手冊　
　　
用戶需要了解的常用信息，包括可用的命令和類型．　
程序員手冊　
　　
　　
　　
　　

　　　　　　　　　　　　　　應(yīng)用程序員需要的高級(jí)信息．包括類型和函數(shù)擴(kuò)展，庫接口以及應(yīng)用設(shè)計(jì)方面的內(nèi)容．　

管理員手冊　
　　
安裝和管理信息，所支持的平臺(tái)的列表．　
開發(fā)人員手冊　
　　
　　

Postgres　開發(fā)者所需的信息．這部分內(nèi)容是給那些有志于參與Postgres項(xiàng)目開發(fā)的人員看的；應(yīng)用開發(fā)的信息應(yīng)該包括在程序員手冊內(nèi)．　這部分內(nèi)容包含在程序員手冊中．　

參考手冊　
　　
　　

命令語法的詳細(xì)參考信息，當(dāng)前包含在用戶手冊中．

除了上述手冊外，其他的一些資源也可以幫助你安裝和使用Postgres：　
手冊頁　
　　
手冊頁包含常用信息和命令語法．　
FAQs　
　　
常問的問題（FAQ）文檔包含常見問題和平臺(tái)相關(guān)問題的解答．　
READMEs　
　　
一些貢獻(xiàn)的包包含README文件．　
站點(diǎn)　
　　
　　

Postgres　網(wǎng)站有一些在發(fā)布版里沒有的信息．在網(wǎng)站上有一個(gè)mhonarc郵件列表的目錄，通常是解決問題的很好的地方?！?

郵件列表　
　　
　　

　pgsql-general?。w檔）郵件列表是解決用戶問題的好地方；同時(shí)還有其他的郵件列表，詳見　PostgreSQL　網(wǎng)站的　Info　Central　部分?！?

你自己！　
　　
　　

Postgres　是一個(gè)開放源碼的東西．　也就是說，它靠用戶群體進(jìn)行支持工作．當(dāng)你剛開始使用Postgres　時(shí)，你將依靠其他人的幫助，或者是通過文檔，或者是通過郵件列表．同時(shí)請也將你的知識(shí)貢獻(xiàn)出來，如果你學(xué)到了一些文檔里沒有提到的東西，請將其寫下來并貢獻(xiàn)出來．如果你給代碼增加了特性，請貢獻(xiàn)出來．　

甚至沒有很多經(jīng)驗(yàn)的人也可以提供文檔的修正和小修改，這就是好的開始．pgsql-docs（歸檔）郵件列表就是開始的地方．

--------------------------------------------------------------------------------
術(shù)語
--------------------------------------------------------------------------------

在下面的文檔中，節(jié)點(diǎn)(?site)　可以理解為安裝　Postgres　的機(jī)器．　由于我們可以在一臺(tái)機(jī)器上安裝多套　Postgres　數(shù)據(jù)庫，　所以，準(zhǔn)確地說這個(gè)詞代表所安裝的某一套Postgres　的二進(jìn)制文件和數(shù)據(jù)庫的集合．　
Postgres　超級(jí)用戶　是叫　postgres　的用戶，他擁有　Postgres的二進(jìn)制文件和數(shù)據(jù)庫文件．作為數(shù)據(jù)庫超級(jí)用戶，他擁有超越所有保護(hù)機(jī)制和訪問任何數(shù)據(jù)的特權(quán)．另外，　Postgres　超級(jí)用戶可以執(zhí)行一些并非所有用戶可以執(zhí)行的程序．要注意的是　Postgres超級(jí)用戶和　Unix　超級(jí)用戶?。ㄍǔ＝凶觥oot）并不相同．　出于安全的原因數(shù)據(jù)庫的超級(jí)用戶應(yīng)該有一個(gè)非零的用戶標(biāo)識(shí)（UID）?！?

數(shù)據(jù)庫管理員　或稱之為　DBA，負(fù)責(zé)安裝　Postgres　和制定這個(gè)數(shù)據(jù)庫的安全策略．DBA　可以用下面描述的方法增加用戶和維護(hù)一套用于　createdb　的模板庫。　

postmaster　是充當(dāng)發(fā)往　Postgres　系統(tǒng)的請求的凈化間的進(jìn)程．前端應(yīng)用與postmaster　相連，由它監(jiān)控任何系統(tǒng)錯(cuò)誤和與后端進(jìn)程的通訊．postmaster　可由一些命令行參數(shù)來調(diào)節(jié)其特性．不過，只有你試圖同時(shí)運(yùn)行多套數(shù)據(jù)庫或某一套非缺省的數(shù)據(jù)庫時(shí)才需要設(shè)置參數(shù)．　

Postgres　的后端進(jìn)程（實(shí)際上是可執(zhí)行文件　postgres）可由　Postgres　超級(jí)用戶直接在命令行上運(yùn)行（以數(shù)據(jù)庫名為參數(shù)）．不過，這樣做繞過了與　postmaster/節(jié)點(diǎn)（site）相連的共享緩沖池和鎖表，因而不推薦在一個(gè)多用戶節(jié)點(diǎn)上這么做．

--------------------------------------------------------------------------------
符號(hào)
--------------------------------------------------------------------------------

“...”　或在文件名前面的　/usr/local/pgsql/　用于代表Postgres　超級(jí)用戶的家目錄．　
在命令行參數(shù)里，方括號(hào)　（“[”　和　“]”）　表示一個(gè)可選詞或關(guān)鍵字．任何用花括號(hào)（“{”　和　“}”）　括起來的包含豎直條（“|”）　的內(nèi)容表示你必須選擇一個(gè)．　

在例子里，圓括號(hào)?。ā?”　和　“)”）用于組合布爾表達(dá)式．　“|”　是布爾計(jì)算符"或"（OR）．　

例子將演示從不同用戶和程序執(zhí)行命令的結(jié)果．root用戶執(zhí)行的命令將由“>”開頭．Postgres　超級(jí)用戶執(zhí)行的命令將由“%”開頭，普通用戶執(zhí)行的命令由　“$”開頭．　SQL　命令視情況由“=>”開頭或沒有前導(dǎo)字符．　

注意：　當(dāng)我們寫這些時(shí)?。≒ostgres　v7.0）還沒有在整個(gè)文檔集中通盤考慮符號(hào)標(biāo)志命令(flagging　commands)的使用．請向　文檔郵件列表　反映問題．　

--------------------------------------------------------------------------------

問題匯報(bào)指導(dǎo)
當(dāng)你在PostgreSQL　里碰到問題時(shí)，我們也希望聽到它。你的臭蟲匯報(bào)是將　PostgreSQL　做得更加可靠的一個(gè)非常重要的部分，因?yàn)榧词故羌?xì)致到極限的工作也不能保證在任何情況任何平臺(tái)下　PostgreSQL　的每一個(gè)部分都能正常工作?！?
下面的建議試圖幫助你正確格式化臭蟲報(bào)告，這樣這些報(bào)告就能夠以一種有效的方法處理。我們不強(qiáng)迫任何人遵循這些東西，但是這樣做對(duì)我們每個(gè)人都有好處?！?

我們不能保證能夠正確修補(bǔ)每個(gè)臭蟲。如果臭蟲是顯而易見的，很關(guān)鍵的或者影響許多用戶，那么很有可能有些人會(huì)認(rèn)真檢查它們。同樣也可能是我們告訴你升級(jí)到一個(gè)新版本，看看臭蟲是否仍然存在。否則，我們可能會(huì)說這個(gè)臭蟲在我們正計(jì)劃的幾個(gè)主要改寫之前不會(huì)得到修補(bǔ)?；蛘哌@個(gè)臭蟲只是太費(fèi)事了，而且目前的日程表上有更重要的事情要做。如果你立即需要幫助，考慮獲取一個(gè)商業(yè)性的支持?！?

標(biāo)識(shí)臭蟲
在你發(fā)出"這是個(gè)臭蟲嗎？"這樣的問題之前，請一再仔細(xì)地讀文檔，以確認(rèn)你確實(shí)可以做你想做的事情。如果文檔中對(duì)你能否處理你所做的事情并不清楚，也請你匯報(bào)過來；因?yàn)檫@個(gè)是文檔的臭蟲。如果發(fā)現(xiàn)你的程序的表現(xiàn)不象文檔里說的那樣，那就是一個(gè)臭蟲。這時(shí)可能包括（不過不一定局限于）下面的現(xiàn)象：　
程序帶著一個(gè)致命信號(hào)或者一個(gè)指向程序錯(cuò)誤的操作系統(tǒng)錯(cuò)誤信息（一個(gè)反例是一個(gè)"disk　full"（磁盤滿）信息，因?yàn)檫@樣的錯(cuò)誤必須在Postgres　外部進(jìn)行修復(fù)）退出?！?

程序?qū)o出的任何輸入都產(chǎn)生錯(cuò)誤的輸出?！?

程序拒絕接收有效的輸入?！?

程序?qū)Ψ欠ㄝ斎霙]有生成任何提示或者錯(cuò)誤信息?！?

在支持的平臺(tái)上根據(jù)指導(dǎo)未能成功地編譯、制作或安裝PostgreSQL。

這里的"程序"代表任何可執(zhí)行文件，而不僅僅是后端服務(wù)器?！?
速度慢或者資源消耗大不算是臭蟲。請閱讀文檔或者提交郵件列表之一獲取調(diào)節(jié)你的應(yīng)用（的性能）的幫助。未能遵循　SQL　也不算是一個(gè)臭蟲，除非顯式聲明了遵守該特定特性?！?

在你繼續(xù)準(zhǔn)備匯報(bào)臭蟲之前，請檢查　TODO　列表和　FAQ，看看你報(bào)告的臭蟲是否已知。如果你不能解析　TODO　列表里面的信息，請匯報(bào)你的問題。最少我們可以把　TODO　列表做得更清晰?！?

匯報(bào)什么
關(guān)于匯報(bào)臭蟲需要記住的最重要事就是寫出所有事實(shí)并且只寫事實(shí)。不要推測你認(rèn)為是什么錯(cuò)了，什么"看起來象"，或者是推測程序的哪一部分失靈了。如果你不熟悉　Postgres　的實(shí)現(xiàn)，你很可能猜錯(cuò)因而不能幫我們?nèi)魏蚊?。而且即使你熟悉　Postgres　的實(shí)現(xiàn)，提煉出來的解釋也只是事實(shí)的補(bǔ)充而不是代替。如果我們準(zhǔn)備修理這個(gè)臭蟲，我們?nèi)匀恍枰紫扔H自看到臭蟲的出現(xiàn)。報(bào)告簡單的事實(shí)相對(duì)而言比較直接（你可以從屏幕上拷貝和粘貼），不過經(jīng)常發(fā)生的是很多人認(rèn)為這些事實(shí)不重要而忽略了重要的細(xì)節(jié)，否則匯報(bào)總是能夠被我們理解?！?
下面的條目應(yīng)該包含在所有臭蟲匯報(bào)里面：　

從程序啟動(dòng)開始到重現(xiàn)問題的準(zhǔn)確步驟順序。這應(yīng)該自包含；要知道如果輸出將依賴于表中的數(shù)據(jù)時(shí)，光把一個(gè)光禿禿的　select　語句發(fā)過來而不吧前面的創(chuàng)建表和插入語句發(fā)過來是不夠的。我們沒有時(shí)間分析你的數(shù)據(jù)庫結(jié)構(gòu)，而且如果我們試著建立我們自己的數(shù)據(jù)，那我們就有可能錯(cuò)過問題。測試與查詢語言有關(guān)的問題的最好的格式是一個(gè)可以通過　psql　前端運(yùn)行并顯示問題的文件。（確保在你的　~/.psqlrc　啟動(dòng)文件里面沒有任何東西。）我們鼓勵(lì)你最小化你的例子，但這不是非做不可的事情。如果臭蟲是可以復(fù)現(xiàn)的，那么兩種方式都能幫助我們找到它?！?

如果你的應(yīng)用使用其他客戶端接口，比如說　PHP，那么請?jiān)O(shè)法隔離出有毛病的查詢。我們可能不會(huì)設(shè)置一個(gè)　web　服務(wù)器來復(fù)現(xiàn)你的問題。不管怎么說，請記住提供準(zhǔn)確的輸入文件，而不要猜測問題會(huì)在"大文件"或者"中等尺寸的數(shù)據(jù)庫"等等的身上發(fā)生。因?yàn)檫@樣的信息太不確切，因而沒有什么用處?！?

你得到的輸出。請不要說它"不起作用"或者"失靈了"。如果有錯(cuò)誤信息，請寫明，即使你不能理解也一樣。如果程序帶著操作系統(tǒng)錯(cuò)誤退出，也請寫清楚。如果什么也沒有發(fā)生，就照直說。即使你的測試實(shí)例是程序崩潰或者其他顯而易見的現(xiàn)象，它也有可能不會(huì)在我們的平臺(tái)上發(fā)生。如果可能，最簡單的事情是從終端拷貝輸出?！?

注意：如果是致命錯(cuò)誤，客戶端提供的信息可能不會(huì)包含所有能得到的信息。這種情況下，還要看看數(shù)據(jù)庫服務(wù)器的輸出。如果你沒有保留你的服務(wù)器輸出，那么現(xiàn)在是做這件事的好機(jī)會(huì)。
還有一樣很重要去聲明的是你期望的輸出。如果你只是寫到"這條命令給我這樣的輸出。"或者"這不是我期望的。"，我們可能自己運(yùn)行它，檢查輸出，然后認(rèn)為看上去很好并且正是我們所期望的輸出。我們不應(yīng)該把時(shí)間花在解析你的命令的語義上。特別是要避免僅僅說"這不是　SQL　說的/Oracle　做的那樣。"　從　SQL　里挖掘出正確的特性可不是好玩的事情，我們也不能知道所有其他的關(guān)系數(shù)據(jù)庫的特性是怎樣的。（如果你的問題是程序崩潰，你顯然可以忽略這個(gè)條目。）　
任何命令行選項(xiàng)和其他啟動(dòng)選項(xiàng)，包括相關(guān)的環(huán)境變量或者你從缺省值修改以后的配置文件。同時(shí)，還要準(zhǔn)確。如果你使用啟動(dòng)系統(tǒng)時(shí)自動(dòng)啟動(dòng)數(shù)據(jù)庫服務(wù)器的預(yù)打包的版本，你應(yīng)該試著找出這些是怎樣實(shí)現(xiàn)的?！?

任何你做得與安裝指導(dǎo)不一樣的東西。　

PostgreSQL　版本。你可以運(yùn)行命令　SELECT　version()；來檢查你正在運(yùn)行的版本是什么。如果這個(gè)函數(shù)不存在，請說明，這樣我們就知道你的版本有夠老。如果你無法啟動(dòng)服務(wù)器或者客戶端，參閱源碼目錄里面的　README　文件或者看看你的發(fā)布文件的名稱或包名稱。如果你的版本早于　7.0，我們幾乎可能會(huì)告訴你去升級(jí)。每個(gè)新版本都會(huì)有成噸的臭蟲被修理掉，這也是我們寫（新版本）的原因。　

如果你運(yùn)行預(yù)打包的版本，例如　RPM，請說明，包括那個(gè)包可能有的任何子版本號(hào)。如果你說的是　CVS　快照，說明之，包括它的日期和時(shí)間?！?

平臺(tái)信息。這包括內(nèi)核名稱和版本，C　庫，處理器，存儲(chǔ)器信息。大多數(shù)情況下只需要匯報(bào)供應(yīng)商和版本，但是不要指望每個(gè)人都很清楚　"Debian"　包括什么東西或者說每個(gè)人都運(yùn)行在　Pentium　上。如果你還有關(guān)于編譯器，make等安裝的問題信息，也有必要詳細(xì)匯報(bào)。

不要怕你的臭蟲匯報(bào)變得很長。這就是生活。一開始就匯報(bào)所有的事情要比讓我們從你那里擠出事實(shí)要好。另外，如果你的輸入文件非常巨大，先問問有沒有人有興趣查看它也是合理的?！?
不要把你的時(shí)間花在尋找如何通過修改輸入來消除問題的方法上。這樣很有可能不能對(duì)解決問題有任何幫助。如果發(fā)現(xiàn)不能直接修理臭蟲，你還有時(shí)間來查找和共享你的繞過方法。還有，我們再說一便，不要在猜測臭蟲的位置上面浪費(fèi)時(shí)間。我們能夠及時(shí)找到錯(cuò)誤?！?

當(dāng)你書寫臭蟲匯報(bào)時(shí)，請選用不易混淆的術(shù)語。軟件包本身被稱為"PostgreSQL"，有時(shí)稱為　"Postgres"。（有些時(shí)候用縮寫　"Pgsql"，但是請不要這么使用。）當(dāng)你特指后端服務(wù)器時(shí)，請明確說明，而不要僅僅是說　"Postgres　崩潰了"。交互前端（SQL　界面）叫做　"psql"　而且在所有用法和用途上都是和后端完全分離的?！?

到哪里匯報(bào)臭蟲
通常，把匯報(bào)發(fā)到臭蟲匯報(bào)郵件列表。我們建議你為你的電子郵件消息選用一個(gè)描述性的題目，也許就用錯(cuò)誤信息的一部分?！?
不要把臭蟲匯報(bào)發(fā)送到任何用戶郵件列表里，例如　SQL　語言郵件列表　或　通用話題郵件列表。這些郵件列表用于回答用戶問題，而且那些訂閱者通常不希望接收臭蟲匯報(bào)。更重要的是，他們很可能不會(huì)修理這些臭蟲。　

還有，請不要向　開發(fā)者郵件列表　發(fā)送臭蟲匯報(bào)。這個(gè)列表用于討論　PostgreSQL　的開發(fā)，因而我們很希望能和臭蟲匯報(bào)分離開。如果修理這個(gè)臭蟲需要更多評(píng)論，我們可能會(huì)在這個(gè)列表開一個(gè)關(guān)于你的臭蟲的討論會(huì)?！?

如果你覺得文檔有問題，請發(fā)電子郵件到　文檔郵件列表。在你的問題匯報(bào)里面指明文檔、章、節(jié)?！?

如果你的臭蟲是一個(gè)在不支持平臺(tái)上的移植性問題，向　移植性問題郵件列表　發(fā)送電子郵件，這樣我們（還有你）可以一起嘗試把　PostgreSQL　移植到你的平臺(tái)上。　

注意：由于我們不愿意看到的各種各樣的垃圾郵件，上面的所有電子郵件地址都是封閉的郵件地址。也就是說，你需要先申請，然后才能發(fā)帖子。如果你只是想發(fā)送郵件而不想接受列表的往來的郵件，你可以提交特殊的　pgsql-loophole　郵件列表，那里允許你向所有　PostgreSQL　郵件列表發(fā)信而接收不到任何信息。向　pgsql-loophole-request@postgresql.org　發(fā)郵件來申請。　
（譯注：這里用"assume"這個(gè)詞真多，讓我想起一個(gè)老外給我講解"assume"的意思："ass-u-me"　:-D）

--------------------------------------------------------------------------------
--------------------------------------------------------------------------------

Y2K　聲明
作者：Thomas　Lockhart　于　1998-10-22?！「掠凇?000-03-31。
PostgreSQL　全球開發(fā)隊(duì)伍將提供　Postgres　軟件的代碼樹作為一種公眾服務(wù)，對(duì)其特性和性能不做任何保證和承諾，但是，到我們寫這些為止：　
這些聲明的作者，作為一個(gè)從1996年11月開始從事Postgres支持的志愿者，并未發(fā)現(xiàn)任何　Postgres　的代碼與2000年1月1日的時(shí)間切換(Y2K)相關(guān)．　
本聲明的作者并未收到當(dāng)前或最近版本的Postgres　任何與　Y2K　問題相關(guān)的報(bào)告，不論是在做遞歸測試還是在其他領(lǐng)域的使用中．考慮到我們的裝機(jī)量和我們的郵件列表的活躍性，如果問題存在，我們應(yīng)該可以獲得消息．　
據(jù)作者所知，Postgres　對(duì)兩位數(shù)年份的一些假設(shè)的文檔在　用戶手冊　中的日期類型章節(jié)中。就兩位數(shù)年份而言，　關(guān)鍵的切換年份是1970年，而不是2000年；比如"70-01-01"被看作是　1970-01-01，　而"69-01-01"將被看作是　2069-01-01。　
任何因OS取　"當(dāng)前時(shí)間"　造成的Y2K問題都可能傳染到Postgres．　
請參考　Gnu　工程　和　Perl　大學(xué)　進(jìn)一步討論Y2K問題，尤其是開放源碼（免費(fèi)）軟件．　

--------------------------------------------------------------------------------
--------------------------------------------------------------------------------

版權(quán)和商標(biāo)
（譯注：具體的版權(quán)譯文請參閱　FAQ。）
PostgreSQL　is　Copyright　(C)　1996-2000　by　PostgreSQL　Inc.　and　is　distributed　under　the　terms　of　the　Berkeley　license.　

Postgres95　is　Copyright　(C)　1994-5　by　the　Regents　of　the　University　of　California.　Permission　to　use,　copy,　modify,　and　distribute　this　software　and　its　documentation　for　any　purpose,　without　fee,　and　without　a　written　agreement　is　hereby　granted,　provided　that　the　above　copyright　notice　and　this　paragraph　and　the　following　two　paragraphs　appear　in　all　copies.　

In　no　event　shall　the　University　of　California　be　liable　to　any　party　for　direct,　indirect,　special,　incidental,　or　consequential　damages,　including　lost　profits,　arising　out　of　the　use　of　this　software　and　its　documentation,　even　if　the　University　of　California　has　been　advised　of　the　possibility　of　such　damage.　

The　University　of　California　specifically　disclaims　any　warranties,　including,　but　not　limited　to,　the　implied　warranties　of　merchantability　and　fitness　for　a　particular　purpose.　The　software　provided　hereunder　is　on　an　"as-is"　basis,　and　the　University　of　California　has　no　obligations　to　provide　maintainance,　support,　updates,　enhancements,　or　modifications.　

All　trademarks　are　the　property　of　their　respective　owners.　

--------------------------------------------------------------------------------

上一篇：PostgreSQL7.0手冊-用戶手冊-2. SQL 語法

下一篇：PostgreSQL 常見問題（FAQ）