# dblink_fetch ## Name dblink_fetch?--?從遠程數據庫中打開的游標中返回行 ## Synopsis ``` dblink_fetch(text cursorname, int howmany [, bool fail_on_error]) returns setof record dblink_fetch(text connname, text cursorname, int howmany [, bool fail_on_error]) returns setof record ``` ## 描述 `dblink_fetch`通過`dblink_open`預先建立的游標中抓取行。 ## 參數 `conname` 要使用的連接名稱；省略這個參數使用未命名連接。 `cursorname` 獲取游標名稱。 `howmany` 要檢索的最大行數。抓取下一個`howmany`行， 從當前光標位置開始，向前移動。一旦游標已經到達末尾，不會產生更多行。 `fail_on_error` 如果真（忽略時缺省）那么在連接的遠程端拋出的錯誤也會導致本地拋出錯誤， 如果假，那么遠程錯誤在本地作為NOTICE被報告， 并且函數沒有返回行。 ## 返回值 該函數返回從游標中抓取的行。要使用該函數，你將需要 指定預期的字段集，正如前面討論的`dblink`。 ## 注意 在`FROM`子句上指定的返回列數之間的不匹配，并且通過遠程游標返回實際列數，將拋出一個錯誤。在這種情況下，遠程游標仍然按照沒有產生錯誤時一樣的行增長。 同樣的在遠程`FETCH`執行后本地查詢產生的任何其他錯誤也是這樣。 ## 例子 ``` SELECT dblink_connect('dbname=postgres'); dblink_connect ---------------- OK (1 row) SELECT dblink_open('foo', 'select proname, prosrc from pg_proc where proname like ''bytea%'''); dblink_open ------------- OK (1 row) SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text); funcname | source ----------+---------- byteacat | byteacat byteacmp | byteacmp byteaeq | byteaeq byteage | byteage byteagt | byteagt (5 rows) SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text); funcname | source -----------+----------- byteain | byteain byteale | byteale bytealike | bytealike bytealt | bytealt byteane | byteane (5 rows) SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text); funcname | source ------------+------------ byteanlike | byteanlike byteaout | byteaout (2 rows) SELECT * FROM dblink_fetch('foo', 5) AS (funcname name, source text); funcname | source ----------+-------- (0 rows) ```