PostgreSQL DECLARE

描述

DECLARE允許用戶創(chuàng)建游標(biāo)， 游標(biāo)可以被用來在大型查詢暫停時檢索少量的行。游標(biāo)被創(chuàng)建后， 可以用FETCH從中取得行。

參數(shù)

關(guān)鍵詞BINARY、 INSENSITIVE和SCROLL 可以以任意順序出現(xiàn)。

注解

普通游標(biāo)以文本格式返回數(shù)據(jù)，這和SELECT產(chǎn)生的數(shù)據(jù)一樣。 BINARY選項(xiàng)指定游標(biāo)應(yīng)該以二進(jìn)制格式返回數(shù)據(jù)。這減少了服務(wù) 器和客戶端的轉(zhuǎn)換負(fù)擔(dān)，但程序員需要付出更多工作來處理與平臺相關(guān)的二進(jìn)制 數(shù)據(jù)格式。例如，如果一個查詢從一個整數(shù)列中返回一個值一，用一個默認(rèn)游標(biāo) 將得到一個字符串1，而使用一個二進(jìn)制游標(biāo)將得到該值的四字節(jié) 內(nèi)部表示（big-endian 大端字節(jié)順序）。

使用二進(jìn)制游標(biāo)時應(yīng)該小心。很多應(yīng)用（包括 psql）還沒有準(zhǔn)備好處理二進(jìn)制游標(biāo)， 它們?nèi)匀黄诖龜?shù)據(jù)以文本格式到來。

除非指定了WITH HOLD，這個命令創(chuàng)建的游標(biāo) 只能在當(dāng)前事務(wù)中使用。因此，沒有WITH HOLD 的DECLARE在事務(wù)塊外是沒有用的：游標(biāo)只會生存 到該語句結(jié)束。因此如果這種命令在事務(wù)塊之外被使用， PostgreSQL會報告一個錯誤。 定義事務(wù)塊需要使用 BEGIN 和 COMMIT（或者ROLLBACK）。

如果指定了WITH HOLD并且創(chuàng)建游標(biāo)的事務(wù) 成功提交，在同一個會話中的后續(xù)事務(wù)中還能夠繼續(xù)訪問該游標(biāo)（ 但是如果創(chuàng)建事務(wù)被中止，游標(biāo)會被移除）。一個用 WITH HOLD創(chuàng)建的游標(biāo)可以用一個顯式的 CLOSE命令關(guān)閉，或者會話結(jié)束時它 也會被關(guān)閉。在當(dāng)前的實(shí)現(xiàn)中，由一個被保持游標(biāo)表示的行會被復(fù) 制到一個臨時文件或者內(nèi)存區(qū)域中，這樣它們才會在后續(xù)事務(wù)中保 持可用。

當(dāng)查詢包括FOR UPDATE或FOR SHARE時， 不能指定WITH HOLD。

在定義一個將被反向取元組的游標(biāo)時，應(yīng)該指定SCROLL 選項(xiàng)。這是 SQL 標(biāo)準(zhǔn)所要求的。不過，為了和早期版本兼容， 如果游標(biāo)的查詢計(jì)劃足夠簡單到支持它不需要額外的開銷， PostgreSQL會允許在沒有 SCROLL的情況下反向取元組。不過，建議應(yīng)用開發(fā)者 不要依賴于從沒有用SCROLL創(chuàng)建的游標(biāo)中反向取 元組。如果指定了NO SCROLL，那么任何情況下都不 允許反向取元組。

當(dāng)查詢包括FOR UPDATE或FOR SHARE時， 也不允許反向取元組。因此在這種情況下不能指定 SCROLL。

如果游標(biāo)的查詢包括FOR UPDATE或者FOR SHARE，那么被返回的行會在它們第一次被取得時被鎖定，這和帶有 這些選項(xiàng)的常規(guī)SELECT命令一樣。此外，被返回的 行將是最新的版本，因此這些選項(xiàng)提供了被 SQL 標(biāo)準(zhǔn)稱為 “敏感游標(biāo)”的等效體（把 INSENSITIVE與 FOR UPDATE或者FOR SHARE一起指定是錯誤）。

SQL 標(biāo)準(zhǔn)只對嵌入式SQL中的游標(biāo)做出了規(guī)定。 PostgreSQL服務(wù)器沒有為游標(biāo)實(shí)現(xiàn) OPEN語句。當(dāng)游標(biāo)被聲明時就被認(rèn)為已經(jīng) 被打開。不過，ECPG（ PostgreSQL的嵌入式 SQL 預(yù)處理器） 支持標(biāo)準(zhǔn) SQL 游標(biāo)習(xí)慣，包括那些DECLARE 和OPEN語句。

你可以通過查詢pg_cursors 系統(tǒng)視圖可以看到所有可用的游標(biāo)。

示例

聲明一個游標(biāo)：

DECLARE liahona CURSOR FOR SELECT * FROM films;

更多游標(biāo)的例子請見FETCH。

兼容性

SQL 標(biāo)準(zhǔn)認(rèn)為游標(biāo)是否默認(rèn)對底層數(shù)據(jù)的并發(fā)更新敏感是與實(shí)現(xiàn)相關(guān)的。在 PostgreSQL中，默認(rèn)游標(biāo)對此是不敏 感的，并且可以通過指定FOR UPDATE讓它變得對此敏感。其他 產(chǎn)品的行為可能有所不同。

SQL 標(biāo)準(zhǔn)只允許在嵌入式SQL和模塊中使用游標(biāo)。 PostgreSQL允許以交互的方式使用游標(biāo)。

二進(jìn)制游標(biāo)是一種PostgreSQL 擴(kuò)展。

另見