SET ROWCOUNT (Transact-SQL)
使 SQL Server 在返回指定的行数之后停止处理查询。
语法
SET ROWCOUNT { number | @number_var }
参数
number| **@**number_var
在停止特定查询之前要处理的行数(整数)。
备注
重要提示: |
---|
在 SQL Server 的下一个版本中,使用 SET ROWCOUNT 将不会影响 DELETE、INSERT 和 UPDATE 语句。在新的开发工作中,避免将 SET ROWCOUNT 语句与 DELETE、INSERT 和 UPDATE 语句一起使用,并计划修改当前使用该语句的应用程序。另外,对于当前使用 SET ROWCOUNT 的 DELETE、INSERT 和 UPDATE 语句,建议您使用 TOP 语法重写它们。有关详细信息,请参阅 DELETE (Transact-SQL)、INSERT (Transact-SQL) 或 UPDATE (Transact-SQL)。 |
对于在远程表和本地及远程分区视图上执行的 INSERT、UPDATE 和 DELETE 语句,将忽略 SET ROWCOUNT 选项设置。
要将此选项设置为 off 以便返回所有的行,请将 SET ROWCOUNT 指定为 0。
注意: |
---|
设置 SET ROWCOUNT 选项将使大多数 Transact-SQL 语句在受到指定数目的行影响后停止处理。这包括触发器和 INSERT、UPDATE 及 DELETE 等数据修改语句。ROWCOUNT 选项对动态游标无效,但它可以限制键集的行集和不区分游标。应谨慎使用该选项,它主要与 SELECT 语句一起使用。 |
如果行数值较小,则 SET ROWCOUNT 将覆盖 SELECT 语句 TOP 关键字。
当 INSERT、UPDATE 和 DELETE 语句使用显式 TOP 表达式时,这些语句将忽略 SET ROWCOUNT。这包括 INSERT 后跟 SELECT 子句的语句。
SET ROWCOUNT 的设置是在执行时或运行时设置,而不是在分析时设置。
权限
要求具有 public 角色成员资格。
示例
SET ROWCOUNT 在达到指定的行数后停止处理。请注意,在下面的示例中共有 545 行满足 Quantity
小于 300
的条件。但是,从更新后返回的行数可以看出并非所有行都得到处理。ROWCOUNT 影响所有的 Transact-SQL 语句。
USE AdventureWorks;
GO
SELECT count(*) AS Count
FROM Production.ProductInventory
WHERE Quantity < 300;
GO
下面是结果集:
Count
-----------
537
(1 row(s) affected)
现在,将 ROWCOUNT
设置为 4
,并以 Quantity
小于 300
的条件更新所有行。
SET ROWCOUNT 4;
UPDATE Production.ProductInventory
SET Quantity = 400
WHERE Quantity < 300;
GO
(4 row(s) affected)