了解游标类型

  • 项目

下载 JDBC 驱动程序

关系数据库中的操作会对整个行集起作用。 由 SELECT 语句返回的行集包括满足该语句的 WHERE 子句中条件的所有行。 这种由语句返回的完整行集称为结果集。 应用程序并不总能将整个结果集作为一个单元来有效地处理。 这些应用程序需要一种方法以便每次处理一行或一部分行。 游标就是提供这种机制的对结果集的一种扩展。

游标通过执行以下事项来扩展结果集处理：

  • 允许定位在结果集的特定行。
  • 从结果集的当前位置检索一行或一部分行。
  • 支持对结果集中当前位置的行进行数据修改。
  • 为由其他用户对显示在结果集中的数据库数据所做的更改提供不同级别的可见性支持。

注意

有关 SQL Server 游标类型的完整说明，请参阅游标类型。

JDBC 规范支持的只进和可滚动游标对其他作业所做的更改可能敏感，也可能不敏感，而且可以是只读游标或可更新游标。 这一功能由 Microsoft JDBC Driver for SQL Server 的 SQLServerResultSet 类提供。

注解

JDBC 驱动程序支持下列结果集和游标类型以及指定的行为选项。

结果集（游标）类型 SQL Server 游标类型 特征 选择方法 响应缓冲
TYPE_FORWARD_ONLY (CONCUR_READ_ONLY) 不可用 只进，只读 直通 full

应用程序必须（向前）经过结果集一次。 此经过操作是默认行为，其行为与 TYPE_SS_DIRECT_FORWARD_ONLY 游标相同。 在语句执行期间，驱动程序将整个结果集从服务器读入内存中。

结果集（游标）类型 SQL Server 游标类型 特征 选择方法 响应缓冲
TYPE_FORWARD_ONLY (CONCUR_READ_ONLY) 不可用 只进，只读 直通 自适应

应用程序必须（向前）经过结果集一次。 其行为与 TYPE_SS_DIRECT_FORWARD_ONLY 游标的行为相同。 当应用程序请求行时驱动程序从服务器读取对应的行，并最大限度地减少客户端内存占用。

结果集（游标）类型 SQL Server 游标类型 特征 选择方法 响应缓冲
TYPE_FORWARD_ONLY (CONCUR_READ_ONLY) 快进 只进，只读 cursor 不可用

应用程序必须通过使用服务器游标在结果集中进行一次（前进）传递。 其行为与 TYPE_SS_SERVER_CURSOR_FORWARD_ONLY 游标的行为相同。

从提取大小指定的服务器中分块检索行。

结果集（游标）类型 SQL Server 游标类型 特征 选择方法 响应缓冲
TYPE_FORWARD_ONLY (CONCUR_UPDATABLE) 动态（只进） 只进，可更新 空值 不可用

应用程序必须（向前）经过结果集一次才能更新一行或多行。

从提取大小指定的服务器中分块检索行。

默认情况下，当应用程序调用 SQLServerResultSet 对象的 setFetchSize 方法时，提取大小是固定的。

注意

JDBC 驱动程序提供一项自适应缓冲功能，使你能够在应用程序需要时从 SQL Server 中检索语句执行结果，而不是一次性检索全部结果。 例如，如果应用程序需要检索一个因为太大而无法完全容纳于应用程序内存中的大型数据块，则自适应缓冲使客户端应用程序可以检索诸如流这样的值。 驱动程序的默认行为是“adaptive”。 但是，若要为只进的可更新结果集获取自适应缓冲，应用程序必须通过提供字符串值“adaptive”来显式调用 SQLServerStatement 对象的 setResponseBuffering 方法。 有关示例代码，请参阅更新大型数据示例。

结果集（游标）类型 SQL Server 游标类型 特征 选择方法 响应缓冲
TYPE_SCROLL_INSENSITIVE 静态 可滚动，不可更新。

外部行更新、插入和删除不可见。		 不适用 不可用

应用程序需要数据库快照。 结果集不可更新。 仅支持 CONCUR_READ_ONLY。 使用此游标类型时，所有其他并发类型都将导致异常。

从提取大小指定的服务器中分块检索行。

结果集（游标）类型 SQL Server 游标类型 特征 选择方法 响应缓冲
TYPE_SCROLL_SENSITIVE (CONCUR_READ_ONLY) Keyset 可滚动，只读。 外部行更新可见，删除显示为缺失数据。

外部行插入不可见。		 不适用 不可用

应用程序必须只看到现有行的已更改数据。

从提取大小指定的服务器中分块检索行。

结果集（游标）类型 SQL Server 游标类型 特征 选择方法 响应缓冲
TYPE_SCROLL_SENSITIVE (CONCUR_UPDATABLE, CONCUR_SS_SCROLL_LOCKS, CONCUR_SS_OPTIMISTIC_CC, CONCUR_SS_OPTIMISTIC_CCVAL) Keyset 可滚动，可更新。

外部和内部行更新可见，删除显示为缺失数据；插入不可见。		 不适用 不可用

应用程序可以使用 ResultSet 对象更改现有行中的数据。 应用程序还必须能够从 ResultSet 对象之外看到其他人员对行所做的更改。

从提取大小指定的服务器中分块检索行。

结果集（游标）类型 SQL Server 游标类型 特征 选择方法 响应缓冲
TYPE_SS_DIRECT_FORWARD_ONLY 不可用 只进，只读 不可用 full 或 adaptive

整数值 = 2003。 提供一个完全缓冲的只读客户端游标。 不创建服务器游标。

仅支持 CONCUR_READ_ONLY 并发类型。 与此游标类型一起使用时，所有其他并发类型都将导致异常。

结果集（游标）类型 SQL Server 游标类型 特征 选择方法 响应缓冲
TYPE_SS_SERVER_CURSOR_FORWARD_ONLY 快进 只进 空值 不可用

整数值 = 2004。 快速，使用服务器游标访问所有数据。 使用 CONCUR_UPDATABLE 并发类型时可更新。

从提取大小指定的服务器中分块检索行。

对于这种情况，为了获得自适应缓冲，应用程序必须通过提供一个字符串值“adaptive”来显式调用 SQLServerStatement 对象的 setResponseBuffering 方法 。 有关示例代码，请参阅更新大型数据示例。

结果集（游标）类型 SQL Server 游标类型 特征 选择方法 响应缓冲
TYPE_SS_SCROLL_STATIC 静态 不反映其他用户的更新。 不适用 不可用

整数值 = 1004。 应用程序需要数据库快照。 此选项是 JDBC TYPE_SCROLL_INSENSITIVE 特定于 SQL Server 的同义词，并且具有相同的并发设置行为。

从提取大小指定的服务器中分块检索行。

结果集（游标）类型 SQL Server 游标类型 特征 选择方法 响应缓冲
TYPE_SS_SCROLL_KEYSET (CONCUR_READ_ONLY) Keyset 可滚动，只读。 外部行更新可见，删除显示为缺失数据。

外部行插入不可见。		 不适用 不可用

整数值 = 1005。 应用程序必须只看到现有行的已更改数据。 此选项是 JDBC TYPE_SCROLL_SENSITIVE 特定于 SQL Server 的同义词，并且具有相同的并发设置行为。

从提取大小指定的服务器中分块检索行。

结果集（游标）类型 SQL Server 游标类型 特征 选择方法 响应缓冲
TYPE_SS_SCROLL_KEYSET (CONCUR_UPDATABLE, CONCUR_SS_SCROLL_LOCKS, CONCUR_SS_OPTIMISTIC_CC, CONCUR_SS_OPTIMISTIC_CCVAL) Keyset 可滚动，可更新。

外部和内部行更新可见，删除显示为缺失数据；插入不可见。		 不适用 不可用

整数值 = 1005。 应用程序必须更改现有行的数据或看到现有行的已更改数据。 此选项是 JDBC TYPE_SCROLL_SENSITIVE 特定于 SQL Server 的同义词，并且具有相同的并发设置行为。

从提取大小指定的服务器中分块检索行。

结果集（游标）类型 SQL Server 游标类型 特征 选择方法 响应缓冲
TYPE_SS_SCROLL_DYNAMIC (CONCUR_READ_ONLY) 动态 可滚动，只读。

外部行更新和插入可见，删除显示为当前提取缓冲区中的临时缺失数据。		 空值 不可用

整数值 = 1006。 应用程序在游标的生存期内必须看到现有行的已更改数据并看到已插入和已删除的行。

从提取大小指定的服务器中分块检索行。

结果集（游标）类型 SQL Server 游标类型 特征 选择方法 响应缓冲
TYPE_SS_SCROLL_DYNAMIC (CONCUR_UPDATABLE, CONCUR_SS_SCROLL_LOCKS, CONCUR_SS_OPTIMISTIC_CC, CONCUR_SS_OPTIMISTIC_CCVAL) 动态 可滚动，可更新。

外部和内部行更新和插入可见，删除显示为当前提取缓冲区中的临时缺失数据。		 空值 不可用

整数值 = 1006。 应用程序可以使用 ResultSet 对象更改现有行的数据或者插入或删除行。 应用程序还必须能够从 ResultSet 对象之外看到其他人员所做的更改、插入和删除。

从提取大小指定的服务器中分块检索行。

游标定位

TYPE_FORWARD_ONLY、TYPE_SS_DIRECT_FORWARD_ONLY 和 TYPE_SS_SERVER_CURSOR_FORWARD_ONLY 游标仅支持 next 定位方法。

TYPE_SS_SCROLL_DYNAMIC 游标不支持 absolute 和 getRow 方法。 absolute 方法可能近似等效于针对动态游标组合调用 first 和 relative 方法。

getRow 方法仅受 TYPE_FORWARD_ONLY、TYPE_SS_DIRECT_FORWARD_ONLY、TYPE_SS_SERVER_CURSOR_FORWARD_ONLY、TYPE_SS_SCROLL_KEYSET 和 TYPE_SS_SCROLL_STATIC 游标的支持。 带有所有只进游标类型的 getRow 方法返回迄今为止通过游标读取的行数。

注意

当应用程序进行不受支持的游标定位调用或对 getRow 方法进行不受支持的调用时，将引发异常并显示“此游标类型不支持所请求的操作”的消息。

仅 TYPE_SS_SCROLL_KEYSET 和等效的 TYPE_SCROLL_SENSITIVE 游标才显示已删除的行。 如果游标定位在已删除的行上，则列值不可用并且 rowDeleted 方法会返回“true”。 对 get<类型> 方法进行调用将引发异常并显示“无法从已删除行获取值”的消息。 无法更新已删除的行。 如果尝试对已删除的行调用 update<类型> 方法，将引发异常并显示“无法更新已删除的行”的消息。 TYPE_SS_SCROLL_DYNAMIC 游标具有这种相同的行为，直到将此游标移出当前提取缓冲区之外。

前进游标和动态游标以类似的方式显示已删除的行，但仅限仍可在提取缓冲区中访问游标的情况。 对于前进游标，此行为相当简单。 对于动态游标，当提取大小大于 1 时，此行为就变得较复杂了。 应用程序可以在由提取缓冲区定义的窗口内前后移动游标，但是，当离开在其中更新已删除行的原始提取缓冲区时，已删除的行将消失。 如果应用程序并不希望通过使用动态游标来查看临时删除的行，则应使用 Fetch Relative (0)。

如果 TYPE_SS_SCROLL_KEYSET 或 TYPE_SCROLL_SENSITIVE 游标行的键值使用游标进行更新，行会保留它在结果集中的原始位置，无论更新后的行是否符合游标的选择条件。 如果行在游标之外进行更新，已删除的行会出现在此行的原始位置，但仅当包含新键值的另一行出现在游标中，但已遭删除时，此行才会出现在游标中。

对于动态游标，已更新的行将保留其在提取缓冲区的位置，直到离开由提取缓冲区定义的窗口。 已更新的行之后可能重新出现在结果集内的不同位置，或者可能完全消失。 必须避免结果集中出现临时不一致的应用程序所使用的提取大小应为 1（对于 CONCUR_SS_SCROLL_LOCKS 并发机制，默认值为 8 行；对于其他并发机制，则为 128 行）。

游标转换

SQL Server 有时选择实现的游标类型与所请求的游标类型不同，这称为隐式游标转换（或游标降级）。

对于 SQL Server 2000 (8.x)，当你通过 ResultSet.TYPE_SCROLL_SENSITIVE 和 ResultSet.CONCUR_UPDATABLE 结果集更新数据时，将引发异常并显示消息“游标是只读的”。 发生此异常的原因是 SQL Server 2000 (8.x) 已针对该结果集执行了隐式游标转换，而没有返回所请求的可更新游标。

若要解决此问题，可以采用以下解决方案之一：

游标更新

对于游标而言，如果游标类型和并发支持更新，则支持对游标进行就地更新。 如果光标未定位在结果集中的可更新行上（没有成功调用 get<类型> 方法），则调用 update<类型> 方法将引发异常并显示消息“结果集没有当前行”。JDBC 规范指出，当为 CONCUR_READ_ONLY 游标的列调用 update 方法时会出现异常。 在由于乐观并发冲突（例如竞争性的更新或删除）等此类原因而导致无法更新行的情况下，在调用 insertRow、updateRow 或 deleteRow 之前可能不会引发异常。

在调用 update<类型> 之后，在调用了 updateRow 或 cancelRowUpdates 之前，get<类型> 无法访问受影响的列。 此行为将避免以下问题：使用与服务器返回的类型不同的类型更新列，而随后调用的 getter 可能会引起给出不准确结果的客户端类型转换。 调用 get<类型> 将引发异常并显示消息“在调用 updateRow() 或 cancelRowUpdates() 之前，无法访问已更新列”。

注意

如果在未更新任何列时调用 updateRow 方法，JDBC 驱动程序将引发异常并显示“在未更新任何列时调用了 updateRow()”的消息

在调用了 moveToInsertRow 之后，如果对结果集调用了除 get<类型>、update<类型> 和游标定位方法（包括 moveToCurrentRow）之外的任何其他方法，则将引发异常。 moveToInsertRow 方法有效地将结果集置于插入模式，而游标定位方法会终止插入模式。 相对的游标定位调用会将游标在调用 moveToInsertRow 之前它所处的相对位置进行移动。 在游标定位调用之后，最终的目标游标位置将成为新的游标位置。

如果在插入模式下进行的游标定位调用未成功，则调用失败之后的游标位置为调用 moveToInsertRow 之前的原始游标位置。 如果 insertRow 失败，游标将保持在插入行上，并且游标将保持在插入模式下。

位于插入行中的列最初处于未初始化状态。 调用 update<类型> 方法可将列状态设置为已初始化。 对未初始化的列调用 get<类型> 方法将引发异常。 调用 insertRow 方法会将位于插入行中的所有列返回到未初始化状态。

如果在调用 insertRow 方法时任何列均未初始化，则将插入列的默认值。 如果没有默认值而列可为 Null，则插入 NULL。 如果没有默认值且列不可为 Null，服务器将返回错误，此时将引发异常。

注意

在插入模式下，调用 getRow 方法将返回 0。

JDBC 驱动程序不支持定位更新或删除。 根据 JDBC 规范，调用 setCursorName 方法将不起任何作用，而调用 getCursorName 方法将引发异常。

只读和静态游标始终无法更新。

SQL Server 将服务器游标限制到单一结果集中。 如果批处理或存储过程包含多条语句，则必须使用只进只读客户端游标。

另请参阅

通过 JDBC 驱动程序管理结果集