大网数据广告活动
数据库与应用安全

SQL Server 数据库 — sp_cursorfetch (TRANSACT-SQL)

· 52CE 我爱测

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

适用对象:yesSQL Server(从 2008 版开始)noAzure SQL 数据库noAzure SQL 数据仓库no并行数据仓库

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

主题链接图标 TRANSACT-SQL 语法约定

语法

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

参数

cursor
是处理生成的值SQL Server并由 sp_cursoropen 返回。 游标是一个必需的参数,为调用int输入值。 有关详细信息,请参阅本主题后面备注部分。

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

ReplTest1 “属性” Description
0x0001 FIRST 提取的第一个缓冲区nrows行。 如果nrows等于 0,游标位于结果集前面且不返回任何行。
0x0002 NEXT 提取的下一个缓冲区nrows行。
0x0004 PREV 提取的上一缓冲区nrows行。 请注意: 将 PREV 用于 FORWARD_ONLY 游标返回一条错误消息,因为 FORWARD_ONLY 仅支持单向滚动。
0x0008 LAST 最后一个缓冲区中提取nrows行。 如果nrows等于 0,则游标位于结果集并不返回行之后。 请注意: 将 LAST 用于 FORWARD_ONLY 游标返回一条错误消息,因为 FORWARD_ONLY 仅支持单向滚动。
0x10 ABSOLUTE 提取的缓冲区nrows开头的行rownum行。 请注意: 将 ABSOLUTE 用于 DYNAMIC 游标或 FORWARD_ONLY 游标返回一条错误消息,因为 FORWARD_ONLY 仅支持单向滚动。
0x20 RELATIVE 提取的缓冲区nrows行的行的指定作为起始rownum从当前块中的第一行的行的值。 在这种情况下rownum可以是负数。 请注意: 将 RELATIVE 用于 FORWARD_ONLY 游标返回一条错误消息,因为 FORWARD_ONLY 仅支持单向滚动。
0x80 REFRESH 重新填充基础表中的缓冲区。
0x100 INFO 检索有关游标的信息。 使用返回此信息rownum并nrows参数。 因此,指定信息时, rownum并nrows成为输出参数。
0x200 PREV_NOADJUST 用法类似于 PREV。 但是,如果过早遇到结果集顶部,结果可能有所不同。
0x400 SKIP_UPDT_CNCY 必须使用与其他fetchtype值,INFO 除外。

Note:
不支持值 0x40。

有关详细信息,请参阅本主题后面备注部分。

rownum
是一个可选参数,用于指定行位置为 ABSOLUTE 和 INFO fetchtype通过只将整数值用于输入或输出,或两者的值。 rownum用作的行偏移fetchtype位值 RELATIVE。 rownum忽略所有其他值。 有关详细信息,请参阅本主题后面备注部分。

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

Note:
nrows忽略 refresh fetchtype位值。

有关详细信息,请参阅本主题后面备注部分。

返回代码值

当指定位值 INFO 时,以下各表显示可能返回的值。

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

<rownum > 设置为
如果未打开 0
如果定位在结果集前面 0
如果定位在结果集后面 -1
对于 KEYSET 游标和 STATIC 游标 结果集中当前位置的绝对行号
对于 DYNAMIC 游标 1
对于 ABSOLUTE -1 返回集中的最后一行。 -2 返回集中的倒数第二行,依此类推。 注意: 如果多个行请求提取这种情况下,则返回结果集的最后两行。
<nrows > 设置为
如果未打开 0
对于 KEYSET 游标和 STATIC 游标 通常为当前键集大小。 – m如果光标位于异步创建的m到此点找不到行。
对于 DYNAMIC 游标 -1

备注

cursor 参数

在执行任何提取操作之前,游标的默认位置位于结果集第一行的前面。

fetchtype 参数

除了 skip_upd_cncy 以外, fetchtype是互斥的值。

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

对于 KEYSET 游标,这意味着在执行最后一个非跳过 FETCH 的过程中(如果已执行一个),键集表设置了值。 否则,将在填充过程中设置值。

对于 DYNAMIC 游标,这意味着如果使用刷新来执行跳过,则它生成与 KEYSET 相同的结果。 对于任何其他提取类型,键集表会被截断。 这意味着正在插入行,且时间戳列的值不确定。 因此,当您针对 DYNAMIC 游标运行 sp_cursorfetch 时,对于除 REFRESH 之外的任何操作应避免使用 SKIP_UPDT_CNCY。

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

rownum 参数

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

Fetchtype值 ABSOLUTE 表示的位置rownum在整个结果集。 具有 ABSOLUTE 的负数指定该操作从结果集的末尾开始对行进行计数。

Fetchtype值 RELATIVE 表示的位置rownum相对于当前缓冲区开头的游标的位置。 具有 RELATIVE 的负数指定该游标从当前游标位置向后计数。

nrows 参数

Fetchtype值 REFRESH 和 INFO 忽略此参数。

当指定fetchtype第一个具有的值nrow值为 0,将光标定位在提取缓冲区中不包含行的结果集之前。

当指定fetchtype的最后一个具有值nrow值为 0,光标位于当前提取缓冲区中不包含行的结果集之后。

有关fetchtype的下一步、 PREV、 ABSOLUTE、 RELATIVE 和 PREV_NOADJUST,值nrow为 0 的值无效。

RPC 注意事项

RPC 返回状态指示键集大小参数是否为最终的(也即,键集表或临时表是否异步填充)。

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

ReplTest1 Description
0 过程已成功执行。
0x0001 过程失败。
0x0002 当处于负方向中的提取在逻辑上应位于结果集前面时,该提取可能导致将游标位置设置在结果集的开头。
0x10 快进游标自动关闭。

这些行将作为典型的结果集返回,也即:列格式 (0x2a)、行 (0xd1),后跟完成 (0xfd)。 元数据标记使用与为 sp_cursoropen 指定的相同格式发送,也即:对于 SQL Server 7.0 用户为 0x81、0xa5 和 0xa4 等。 行状态指示器在具有列名称 rowstat 和数据类型 INT4 的每一行的末尾作为隐藏列发送(类似于 BROWSE 模式)。 此 rowstat 列具有下表中显示的值之一。

ReplTest1 Description
0x0001 FETCH_SUCCEEDED
0x0002 FETCH_MISSING

因为 TDS 协议不提供发送尾随状态列而不发送先前列的方法,所以为缺少的行发送虚数据(根据需要,将可以为 Null 的字段设置为 Null,将固定长度的字段设置为 0、空白或该列的默认值)。

DONE 行计数将始终为零。 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 nrows值 5 将逻辑上将游标定位两行的结果集的第一行之前。 在此类情况下,游标将调整为从第一行开始,并返回请求的行数。 这通常意味着它将返回位于 PRIOR 提取缓冲区中的行。

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

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

PREV_NOADJUST 从不包括任何位于它返回的行块中当前游标位置或在其之后的行。 在其中 PREV 返回当前位置之后的行的情况下,PREV_NOADJUST 返回更少的行不是在请求nrows。 提供了当前位置中的示例更早版本,当应用 PREV 时,sp_cursorfetch (h2,4,1,5) 提取以下各行:

row1 contents   
row2 contents  
row3 contents  
row4 contents  
row5 contents  

但是,当应用 PREV_NOADJUST 时,sp_cursorfetch (h2,512,6,5) 仅提取以下各行:

row1 contents   
row2 contents  
row3 contents   

请参阅

sp_cursoropen (TRANSACT-SQL)
系统存储过程 (Transact-SQL)

历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 stevestein)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / SQL Server 中文文档历史快照
适用范围
历史中文快照 2018-11-30;详见原文产品版本;文档日期 03/14/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。