# SPI_cursor_open ## Name SPI_cursor_open?--?用`SPI_prepare`創建的語句設置一個游標 ## Synopsis ``` Portal SPI_cursor_open(const char * name, SPIPlanPtr plan, Datum * values, const char * nulls, bool read_only) ``` ## 描述 `SPI_cursor_open`設置一個游標(內部叫入口)， 這個游標可以執行`SPI_prepare`準備的語句。 參數和對應的`SPI_execute_plan`參數具有相同的含義。 使用游標而不是直接執行語句有兩個優點。首先，結果行可以每次檢索一小部分， 避免那些返回大量數據行的查詢造成的內存缺乏。第二， 一個入口可以在當前過程之外存活(實際上，它可以活到當前事務的結尾)。 給過程的調用者返回一個入口名是一種返回行結果集的方法。 傳入參數數據將被拷貝到游標的入口，所以它在游標仍然存在時可以被釋放。 ## 參數 `const char *` `name` 入口的名字，或者是用`NULL`讓系統選擇一個名字 `SPIPlanPtr` `plan` 預備語句（`SPI_prepare`返回的） `Datum *` `values` 一個實際參數值的數組。必須和語句的參數個數相等。 `const char *` `nulls` 一個描述哪些參數是 NULL 的數組。必須和語句的參數個數相等。 如果`nulls`是`NULL`，那么`SPI_cursor_open` 假設沒有參數為空。否則，如果對應的參數值是非空的，那么`nulls` 數組的每一項都應該是`'?'`，或者如果對應的參數值為空，那么 `nulls`數組的每一項都是`'n'`。 （在后面這種情況下，對應的`values`項中的實際值無關緊要。） 請注意，`nulls`不是文本字符串，只是一個數組： 它不需要`'\0'`終止符。 `bool` `read_only` `true`用于只讀的執行 ## 返回值 指向包含游標入口的指針。請注意，這里沒有錯誤返回約定； 任何錯誤都將通過`elog`報告。