PostgreSQL 缺陷報(bào)告指南

一個(gè)程序帶有一個(gè)致命信號或者一個(gè)操作系統(tǒng)錯誤消息終止，它們會指出程序中的一個(gè)問題（一個(gè)反例是一個(gè)“磁盤滿”消息，因?yàn)槟阒荒茏约盒迯?fù)它）。

一個(gè)程序?qū)θ魏谓o定的輸入產(chǎn)生錯誤的輸出。

一個(gè)程序拒絕接受合法的輸入（按文檔定義）。

一個(gè)程序接受非法輸入，并且沒有提示或者錯誤消息。但是記住你對非法輸入的概念可能是我們認(rèn)為的一個(gè)擴(kuò)展或兼容性。

PostgreSQL根據(jù)在被支持平臺上的指導(dǎo)無法編譯、建立或者安裝。

從程序啟動開始的準(zhǔn)確步驟序列，我們需要它們來重現(xiàn)問題。這應(yīng)該是自包含的，如果輸出是依賴于表中的數(shù)據(jù)，那么只發(fā)送一個(gè)裸的SELECT語句而不發(fā)送前面的CREATE TABLE和INSERT語句是不夠的。我們沒有時(shí)間來對你的數(shù)據(jù)庫模式做逆向工程，而且即使我們能夠通過我們自己的數(shù)據(jù)來彌補(bǔ)，我們也很可能會錯過問題。

SQL 相關(guān)問題的一個(gè)測試樣例的最佳格式是一個(gè)可以通過psql前端運(yùn)行并展示該問題的文件（注意不要在你的~/.psqlrc啟動文件中包含任何東西）。一種簡單的創(chuàng)建該文件的方法是使用pg_dump來轉(zhuǎn)儲出表聲明和設(shè)置場景的數(shù)據(jù)，然后增加問題查詢。我們鼓勵你最小化你的例子的尺寸，但是這不是絕對必要的。如果缺陷是可重現(xiàn)的，我們以兩種方法都可以找到它。

如果你的應(yīng)用使用某些其他客戶端接口（例如PHP），那么請嘗試隔離出錯的查詢。我們將可能無法設(shè)置一個(gè)網(wǎng)頁服務(wù)器來重現(xiàn)你的問題。在任何情況中記住提供準(zhǔn)確的輸入文件，不要猜測問題是因?yàn)?span id="cku22q3" class="quote">“大文件”或“中等大小的數(shù)據(jù)庫”等而發(fā)生，因?yàn)檫@些信息用起來太不準(zhǔn)確。

你得到的輸出。請不要說它“無法工作”或者“崩潰了”。如果有一個(gè)錯誤消息，請展示它，即使你不理解它。如果程序帶著一個(gè)操作系統(tǒng)錯誤而終止，請說出它。如果根本沒有發(fā)生任何事情，也說出來。雖然你的測試樣例的結(jié)果是一次程序崩潰，但是顯然它不一定會在我們的平臺上發(fā)生。如果可能的話，最簡單的事情就是從終端上復(fù)制你的輸出。

你所期望的輸出也是需要說明的很重要的內(nèi)容。如果你只寫“這個(gè)命令給我那個(gè)輸出。”或“這不是我所期待的。”，我們可能自己運(yùn)行它、掃描輸出并且認(rèn)為它看起來 OK 并且正是我們期望的。我們不會花時(shí)間來理解你的命令背后的準(zhǔn)確語義。特別是避免僅僅說“這不是 SQL 所說的/Oracle 所作的。”從 SQL中挖掘出正確的行為不是一個(gè)有趣的工作，我們也沒法去了解所有的其他關(guān)系型數(shù)據(jù)庫的行為（如果你的問題是一個(gè)程序崩潰，你顯然可以忽略這一項(xiàng)）。

任何命令行選項(xiàng)和其他啟動選項(xiàng)，包括任何相關(guān)的環(huán)境變量或者你從默認(rèn)修改過的配置文件。再次，請?zhí)峁?zhǔn)確的信息。如果你在使用一個(gè)預(yù)打包的發(fā)布并且它在系統(tǒng)啟動時(shí)自動開始數(shù)據(jù)庫服務(wù)器，你應(yīng)當(dāng)嘗試找出它是怎樣啟動的。

任何你做的和安裝指導(dǎo)上不同的地方。

PostgreSQL的版本。你可以運(yùn)行命令SELECT version();來找出你連接到的服務(wù)器的版本。大部分可執(zhí)行程序也支持一個(gè)--version選項(xiàng)，至少postgres --version和psql --version可以工作。如果該函數(shù)或選項(xiàng)不存在，那么你的版本就已經(jīng)老得無法保證可以升級了。如果你運(yùn)行的是一個(gè)預(yù)打包的版本（如 RPM），請說明并且包括該包的任何子版本。如果你在談?wù)撘粋€(gè) Git 快照，也請說明并且包括提交哈希值。

如果你的版本比 13.1 更老，我們將幾乎肯定會告訴你進(jìn)行升級。在每一個(gè)新的發(fā)布中都包含很多缺陷修復(fù)和改進(jìn)，因此很有可能你在舊版本PostgreSQL中碰到的一個(gè)缺陷已經(jīng)被修復(fù)了。我們對使用舊版本PostgreSQL的站點(diǎn)只提供有限的支持。如果你需要更多支持，請考慮咨詢一個(gè)商業(yè)支持。

平臺信息。這包括內(nèi)核名稱和版本、C 庫、處理器、內(nèi)存信息等等。在大部分情況中，提供廠家和版本就足夠了，但是不要假定每個(gè)人都了解“Debian”中到底包含什么或者每個(gè)人都運(yùn)行在 x86_64 上。如果你碰到的是安裝問題，那么你機(jī)器上的工具鏈（編譯器、make等等）的信息也是需要被報(bào)告的。