适用范围: SQL Server

从数据库中提取由一行或多行组成的缓冲区。 此缓冲区中的行组称为游标的 提取缓冲区 sp_cursorfetch 通过在表格数据流(TDS)数据包中指定 ID = 7 来调用。

Transact-SQL 语法约定

sp_cursorfetch cursor
    [ , fetchtype [ , rownum [ , nrows ] ] ]
[ ; ]

cursor

由 SQL Server 生成的句柄值,并由sp_cursoropen该句柄值返回。 cursor 是调用 int 输入值的必需参数。 有关详细信息,请参阅备注部分。

fetchtype

指定要提取的游标缓冲区。 fetchtype 是一个可选参数,需要以下整数输入值之一。

0x0004 提取 nrows 行的上一个缓冲区。

注意:用于PREVFORWARD_ONLY游标会返回错误消息,因为FORWARD_ONLY仅支持在一个方向滚动。 0x0008 提取 nrows 行的最后一个缓冲区。 如果 nrows 等于 0,则游标位于结果集之后,不返回任何行。

注意:用于LASTFORWARD_ONLY游标会返回错误消息,因为FORWARD_ONLY仅支持在一个方向滚动。 ABSOLUTE 提取以行号行开头的 nrows 行的缓冲区。

注意:DYNAMIC游标或FORWARD_ONLY游标使用ABSOLUTE会返回错误消息,因为FORWARD_ONLY仅支持在一个方向滚动。 RELATIVE 从指定为当前块中第一行的行的行数值开始提取 nrows 行的缓冲区。 在这种情况下, rownum 可以是负数。

注意:用于RELATIVEFORWARD_ONLY游标会返回错误消息,因为FORWARD_ONLY仅支持在一个方向滚动。 REFRESH 重新填充基础表中的缓冲区。 0x100 检索有关游标的信息。 此信息是使用 rownumnrows 参数返回的 。 因此,指定时 INFOrownumnrows 将成为输出参数。 0x200 PREV_NOADJUST 使用方式如下 PREV。 但是,如果过早遇到结果集顶部,结果可能有所不同。 0x400 SKIP_UPDT_CNCY 必须与另 一个 fetchtype 值一起使用,但除外 INFO

有关详细信息,请参阅备注部分。

rownum

一个可选参数,用于仅对输入或输出使用整数值来指定和INFO/或提取类型值的行位置ABSOLUTErownum 用作 fetchtype 位值的RELATIVE行偏移量。 对于所有其他值,将忽略 rownum 。 有关详细信息,请参阅备注部分。

nrows

一个可选参数,用于指定要提取的行数。 如果未 指定 nrows ,则默认值为 20 行。 若要在不返回数据的情况下设置位置,请指定值 0。 当 nrows 应用于 fetchtype INFO 查询时,它将返回该查询中的行总数。

fetchtype 位值忽略 REFRESH nrows。 有关详细信息,请参阅备注部分。

返回代码值

指定位值 INFO时,可能会返回的值显示在下表中。

如果未返回任何行,则缓冲区内容将保持不变。

<rownum>

fetchtype 参数

SKIP_UPD_CNCY除提取类型值外,提取类型值是互斥的。

指定时 SKIP_UPDT_CNCY ,提取或刷新行时,时间戳列值不会写入键集表。 如果正在更新键集行,则时间戳列的值保持为先前的值。 如果正在插入键集行,则时间戳列的值不确定。

对于 KEYSET 游标,这意味着键集表在最后一个非skip FETCH期间设置了值(如果已执行)。 否则,它是填充期间设置的值。

对于 DYNAMIC 游标,这意味着如果通过刷新执行跳过,它将生成与 KEYSET相同的结果。 对于任何其他提取类型,键集表会被截断。 这意味着要插入行,时间戳列的值是未定义的。 因此,为游标运行sp_cursorfetchDYNAMIC时,请避免对除任何操作以外的REFRESH任何操作使用SKIP_UPDT_CNCY

如果由于所请求的游标位置超出结果集而导致提取操作失败,则应将游标位置设置为恰好在最后一行的后面。 如果由于所请求的游标位置位于结果集的前面而导致提取操作失败,则应将游标位置设置在第一行的前面。

rownum 参数

使用 rownum 时,缓冲区从指定的行开始填充。

fetchtypeABSOLUTE是指整个结果集中行的位置。 一个负数, ABSOLUTE 指定操作对结果集末尾的行进行计数。

fetchtypeRELATIVE是指行数相对于游标在当前缓冲区开头的位置的位置 一个负数, RELATIVE 指定游标从当前游标位置向后移动。

nrows 参数

fetchtypeREFRESHINFO忽略此参数。

当指定该值为 0 的 FIRST fetchtype 值时,游标位于提取缓冲区中没有行的结果集之前。

当指定为 nrow 值为 0 的 LAST fetchtype 值时,游标位于当前提取缓冲区中没有行的结果集之后。

对于 fetchtype 值,、PREVABSOLUTERELATIVEPREV_NOADJUSTnrow 类型的值NEXT0无效。

RPC 注意事项

RPC 返回状态指示密钥集大小参数是否为最终参数;也就是说,如果以异步方式填充键集或临时表。

RPC 状态参数设置为下表中显示的值之一。

由于 TDS 协议无法发送尾随状态列而不发送上一列,因此会针对缺失行发送虚拟数据。 可以为 null 的字段设置为 null,固定长度字段设置为 0、空白或该列的默认值(视情况而定)。

DONE 计数始终 0为 。 该 DONE 消息包含实际的结果集行计数,并且任何 TDS 消息之间可能会出现错误或信息性消息。

若要请求在 TDS 流中返回有关游标选择列表的元数据,请将 RPC RETURN_METADATA 输入标志设置为 1

A. 使用 PREV 更改光标位置

假定游标 h2 将生成具有以下内容的结果集,且当前位置如下所示:

row 1 contents
row 2 contents
row 3 contents
row 4 contents  <-- current position
row 5 contents
row 6 contents

接下来, sp_cursorfetch PREV nrows5 逻辑上将游标定位到结果集的第一行之前两行。 在此类情况下,游标将调整为从第一行开始,并返回请求的行数。 这通常意味着它返回提取缓冲区中的 PRIOR 行。

这是 RPC 状态参数设置为 2 时的确切情况。

B. 使用PREV_NOADJUST返回的行数少于 PREV

PREV_NOADJUST 从不包括它返回的行块中当前游标位置或之后的任何行。 如果PREV返回当前位置后的行,PREV_NOADJUST则返回的行数少于 nrows 中请求的行数。 假设前面在示例 A 中的当前位置,应用时 PREVsp_cursorfetch (h2, 4, 1, 5) 提取以下行:

row1 contents
row2 contents
row3 contents
row4 contents
row5 contents

但是,应用后 PREV_NOADJUSTsp_cursorfetch (h2, 512, 6, 5) 仅提取以下行:

row1 contents
row2 contents
row3 contents
  • sp_cursoropen (Transact-SQL)
  • 系统存储过程 (Transact-SQL)
  •