SQL Server 系統預存程序管理游標全攻略：sp_cursor_list、sp_describe_cursor 系列詳解

游標建立後，SQL Server 提供一組系統預存程序供開發者檢視、監控與診斷游標狀態與結構。掌握這些工具對於除錯複雜游標邏輯、分析效能瓶頸至關重要。本文詳細解析四大核心系統預存程序的用法與實戰範例。

核心系統預存程序一覽

13.8.1 sp_cursor_list：掌握作用域內所有游標

語法格式

sp_cursor_list [@cursor_return =] cursor_variable OUTPUT,
               [@cursor_scope =] scope_value

參數說明

• @cursor_return：游標型別輸出參數，接收包含游標清單的結果集游標（必須宣告為 CURSOR 型別變數並加 OUTPUT）
• @cursor_scope：作用域範圍（1=區域、2=全域、3=兩者皆含）

實戰範例 13-11

重要提示：sp_cursor_list 本身包含游標型別變數 @cursor_return 並帶有 OUTPUT 關鍵字。此變數接收的結果集游標，與被檢查的目標游標（如範例中的 pub_cur）是完全不同的兩個游標物件。

13.8.2 sp_describe_cursor：深度剖析單一游標屬性

語法格式

sp_describe_cursor [@cursor_return =] cursor_variable OUTPUT,
                   [@cursor_source =] N'local' | N'global' | N'variable',
                   [@cursor_identity =] N'cursor_name' | @cursor_variable

回傳結果集關鍵欄位

• reference_name：游標參考名稱
• cursor_scope：1(區域) / 2(全域)
• cursor_type：INSENSITIVE、SCROLL、FORWARD_ONLY、DYNAMIC、KEYSET、STATIC 等
• concurrency_type：READ_ONLY、SCROLL_LOCKS、OPTIMISTIC
• is_open、fetch_status、row_count 等執行狀態資訊

13.8.3 關聯預存程序：同構語法，不同焦點

sp_describe_cursor_tables 與 sp_describe_cursor_columns 的語法格式與 sp_describe_cursor 完全一致，差別僅在於回傳結果集的焦點：

• sp_describe_cursor_tables：回傳游標涉及的基礎資料表、檢視表、資料行存取類型（唯讀/可更新）
• sp_describe_cursor_columns：回傳結果集每個欄位的 column_name、data_type、precision、scale、is_nullable、is_identity 等中繼資料

實戰應用場景

• 動態 SQL 除錯：執行期檢視動態建立的游標屬性是否符合預期
• 效能調校：透過 cursor_type 與 concurrency_type 確認是否使用高成本游標類型（如 STATIC、KEYSET）
• 資料行影響分析：使用 sp_describe_cursor_columns 快速掌握游標結果集結構，輔助下游處理邏輯開發
• 並發問題排查：結合 sp_describe_cursor_tables 分析游標鎖定的資料表與模式

最佳實踐提醒

1. 宣告接收結果集的游標變數時，務必指定 LOCAL 且加上 OUTPUT
2. 使用完畢務必 CLOSE 並 DEALLOCATE 接收結果集的游標，避免洩漏
3. 生產環境謹慎使用全域游標，優先採用區域游標限制作用域
4. 搭配 sys.dm_exec_cursors DMV 進行更細緻的執行期監控