@@ROWCOUNT(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

최근 실행된 문의 영향을 받은 행 수를 반환합니다. 행 수가 20억 개보다 많을 경우 ROWCOUNT_BIG을 사용하세요.

Transact-SQL 구문 표기 규칙

Syntax

@@ROWCOUNT

참고 항목

SQL Server 2014(12.x) 및 이전 버전에 대한 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조 하세요.

반환 형식

int

설명

Transact-SQL 문은 다음과 같은 방법으로 @@ROWCOUNT의 값을 설정할 수 있습니다.

  • @@ROWCOUNT를 영향을 받거나 읽은 행의 수로 설정합니다. 행은 클라이언트로 전송될 수도 그렇지 않을 수도 있습니다.

  • 이전에 실행한 문의 @@ROWCOUNT를 유지합니다.

  • @@ROWCOUNT를 0으로 다시 설정하지만 클라이언트에게 값을 반환하지 않습니다.

단순한 할당을 수행하는 문은 항상 @@ROWCOUNT 값을 1로 설정합니다. 클라이언트에게 행은 보내지지 않습니다. 이러한 문의 예로는 SET @local_variable, RETURN, READTEXT 그리고 SELECT GETDATE() 또는 SELECT 'Generic Text'와 같이 쿼리 문이 없는 SELECT 문이 있습니다.

쿼리에서 할당을 수행하거나 쿼리에 RETURN을 사용하는 명령문은 @@ROWCOUNT 값을 쿼리의 영향을 받거나 쿼리가 읽은 행 수로 설정합니다(예: SELECT @local_variable = c1 FROM t1).

DML(데이터 조작 언어) 문은 @@ROWCOUNT 값을 쿼리의 영향을 받는 행 수로 설정하고 해당 값을 클라이언트에 반환합니다. DML 문은 클라이언트에게 행을 보내지 않을 수도 있습니다.

DECLARE CURSOR와 FETCH는 @@ROWCOUNT 값을 1로 설정합니다.

EXECUTE 문은 이전 @@ROWCOUNT를 유지합니다.

USE, SET <option>, DEALLOCATE CURSOR, CLOSE CURSOR, PRINT, RAISERROR, BEGIN TRANSACTION 또는 COMMIT TRANSACTION과 같은 명령문은 ROWCOUNT 값을 0으로 다시 설정합니다.

고유하게 컴파일된 저장 프로시저는 이전 @@ROWCOUNT를 보존합니다. 고유하게 컴파일된 저장 프로시저 내의 Transact-SQL 문은 @@ROWCOUNT를 설정하지 않습니다. 자세한 내용은 고유하게 컴파일된 저장 프로시저를 참조하세요.

예제

다음 예에서는 UPDATE 문을 실행하고 @@ROWCOUNT를 사용하여 변경된 행이 있는지 확인합니다.

USE AdventureWorks2022;  
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)