API 服务器游标

API 服务器游标限制

使用 API 服务器游标时，应用程序不能执行下列语句：

• 服务器游标中 SQL Server 不支持的 Transact-SQL 语句。

• 返回多个结果集的批处理或存储过程。

• 包含 COMPUTE、COMPUTE BY、FOR BROWSE 或 INTO 子句的 SELECT 语句。

• 引用远程存储过程的 EXECUTE 语句。

API 服务器游标实现

SQL Server Native Client OLE DB 访问接口和 SQL Server Native Client ODBC 驱动程序使用下面这些特殊的系统存储过程向服务器发出游标操作信号：

• sp_cursoropen 定义与游标和游标选项相关联的 SQL 语句，然后填充游标。

• sp_cursorfetch 从游标中提取一行或一个行块。

• sp_cursorclose 关闭并释放游标。

• sp_cursoroption 用于设置各种游标选项。

• sp_cursor 用于请求定位更新。

• sp_cursorprepare 将与游标有关的 Transact-SQL 语句或批处理编译成执行计划，但并不创建游标。

• sp_cursorexecute 从 sp_cursorprepare 创建的执行计划中创建并填充游标。

• sp_cursorunprepare 丢弃 sp_cursorprepare 生成的执行计划。

• sp_cursorprepexec 为提交的与游标相关联的 Transact-SQL 语句或批处理编译计划，创建并填充游标。sp_cursorprepexec 结合了 sp_cursorprepare 和 sp_cursorexecute 的行为。

这些系统存储过程将出现在使用 API 服务器游标的 ADO、OLE DB 和 ODBC 应用程序的 SQL Server Profiler 跟踪中。它们仅供 SQL Server Native Client OLE DB 访问接口和 SQL Server Native Client ODBC 驱动程序内部使用。应用程序可通过数据库 API 的游标功能来使用这些过程的完整功能。不支持在应用程序中直接指定过程。

当 SQL Server 执行某个连接中的一个语句时，只有先处理完或取消第一个语句的所有结果才能执行连接中的其他语句。此规则在使用 API 服务器游标时仍然适用，但从应用程序的角度看，好像 SQL Server 已经开始支持一个连接中存在多个活动语句。这是因为完整的结果集存储在服务器游标中，并且只有传送给 SQL Server 的语句才执行 sp_cursor 系统存储过程。SQL Server 将执行存储过程，并且只要客户端检索到结果集，它就能执行任何其他语句。OLE DB 访问接口和 ODBC 驱动程序则在将控制返回给应用程序之前始终检索来自 sp_cursor 存储过程的所有结果集。这使应用程序可以插空在多个活动服务器游标中进行提取操作。

下表说明了应用程序如何利用两个语句句柄在一个连接上同时处理两个游标。

由于调用 sp_cursor 存储过程之后连接中不再有未完成的结果，因此可以在一个连接中并发执行多个 Transact-SQL 语句，只要它们都是使用 API 服务器游标执行的。

指定 API 服务器游标

下面是有关如何在 API 中使用 API 服务器游标的摘要：

• OLE DB

  • 打开会话对象，然后打开命令对象并指定命令文本。

  • 设置行集属性（例如 DBPROP_OTHERINSERT、DBPROP_OTHERUPDATEDELETE、DBPROP_OWNINSERT、DBPROP_OWNUDPATEDELETE 等）以控制游标行为。

  • 执行命令对象。

  • 使用下列方法提取结果集中的行，如 IRowset::GetNextRows、IRowsetLocate::GetRowsAt、IRowsetLocate::GetRowsAtBookmark 和 IRowsetScroll::GetRowsAtRatio。

• ODBC

  • 打开一个连接，然后调用 SQLAllocHandle 以分配语句句柄。

  • 调用 SQLSetStmtAttr 以设置 SQL_ATTR_CURSOR_TYPE、SQL_ATTR_CONCURRENCY 和 SQL_ATTR_ROW_ARRAY_SIZE 特性。也可以通过设置 SQL_ATTR_CURSOR_SCROLLABLE 和 SQL_ATTR_CURSOR_SENSITIVITY 特性来指定游标行为。

  • 使用 SQLExecDirect 或 SQLPrepare 和 SQLExecute 执行 Transact-SQL 语句。

  • 使用 SQLFetch 或 SQLFetchScroll 提取行或行块。

• ADO

  • 定义 Connection 对象和 Recordset 对象，然后对 Connection 对象执行 Open 方法。

  • 指定 CursorType 和/或 LockType 参数，对 Recordset 对象执行 Open 方法。

  • 使用 Move、MoveFirst、MoveLast、MoveNext 和 MovePrevious 记录集方法提取行。

API 服务器游标和 SET 选项

在 SQL Server 中，如果发出提取语句，并且对下列影响计划的任何选项或索引视图或计算列需要的选项进行了更改，游标将使用打开时生效的选项值的快照。这些值将用于所有后续的提取操作，在当前上下文中所做的更改将被忽略。

请参阅

概念