@@ROWCOUNT (Transact-SQL)

  • Статья

Применимо к:база данныхSQL Server Azure SQL Управляемый экземпляр SQL Azure

Возвращает число строк, затронутых при выполнении последней инструкции. Если число строк превышает 2 миллиарда, используйте инструкцию ROWCOUNT_BIG.

Соглашения о синтаксисе Transact-SQL

Синтаксис

@@ROWCOUNT

Примечание

Ссылки на описание синтаксиса Transact-SQL для SQL Server 2014 и более ранних версий, см. в статье Документация по предыдущим версиям.

Типы возвращаемых данных

int

Remarks

Инструкции Transact-SQL могут установить значение в функции @@ROWCOUNT следующими способами:

  • Установка функции @@ROWCOUNT в число считанных или измененных строк. Строки могут быть отосланы или не отосланы клиенту.

  • Сохранить функцию @@ROWCOUNT из предыдущего выполнения инструкции.

  • Сбросить функцию @@ROWCOUNT в 0, но не возвращать значение клиенту.

Инструкции, которые выполняют простые присваивания, всегда устанавливают функцию @@ROWCOUNT в значение 1. Строки не отправляются клиенту. Примерами таких инструкций являются SET @local_variable, RETURN, READTEXT и инструкции SELECT без запроса, такие как SELECT GETDATE() или SELECT 'Generic Text'.

Инструкции, которые осуществляют назначение в запросе или используют RETURN, устанавливают значение @@ROWCOUNT равным числу записей, задействованных или считанных запросом, например SELECT @local_variable = c1 FROM t1.

Инструкции языка обработки данных (DML) присваивают параметру @@ROWCOUNT значение, равное числу строк, задействованных в запросе, и возвращают это значение клиенту. DML-инструкции могут не отправлять строки клиенту.

Инструкции DECLARE CURSOR и FETCH присваивают параметру @@ROWCOUNT значение 1.

Инструкции EXECUTE сохраняют предыдущее значение параметра @@ROWCOUNT.

Такие инструкции, как USE, <параметр> SET, DEALLOCATE CURSOR, CLOSE CURSOR, PRINT, RAISERROR, BEGIN TRANSACTION или COMMIT TRANSACTION, сбрасывают значение ROWCOUNT к 0.

Скомпилированные в собственном коде хранимые процедуры сохраняют предыдущее значение параметра @@ROWCOUNT. Инструкции Transact-SQL, находящиеся внутри скомпилированных в собственном коде хранимых процедур, не устанавливают значение параметра @@ROWCOUNT. Дополнительные сведения см. в статье Хранимые процедуры, скомпилированные в собственном коде.

Примеры

Следующий пример выполняет инструкцию UPDATE и использует @@ROWCOUNT для определения того, были ли изменены строки.

USE AdventureWorks2012;  
GO  
UPDATE HumanResources.Employee   
SET JobTitle = N'Executive'  
WHERE NationalIDNumber = 123456789  
IF @@ROWCOUNT = 0  
PRINT 'Warning: No rows were updated';  
GO

См. также:

Системные функции (Transact-SQL)
SET ROWCOUNT (Transact-SQL)