SQLによって影響を受けた行数（処理件数）を取得する@@ROWCOUNT [SQLServer]

SQLServerでは、直前に実行したSQLによって影響を受けた行数（処理件数）を内部で保持しています。SQLによって影響を受けた行数（処理件数）は、@@ROWCOUNTにセットされますので、@@ROWCOUNTの値をSELECTステートメントで実行することで、影響を受けた行数（処理件数）を取得することができます。また、IFステートメントなどを利用して、直前に実行したSQLによって、行が影響を受けたかどうかを知ることもできます。

1 使用するテーブル
- 1.1 テーブルの定義
- 1.2 テーブルのSQL
2 SELECTステートメントの実行件数
3 INSERTステートメントの実行件数
4 UPDATEステートメントの実行件数
5 DELETEステートメントの実行件数
6 PRINTステートメントの実行後
7 Transaction
- 7.1 COMMIT
- 7.2 ROLLBACK
8 @@ROWCOUNT と同様の関数 ROWCOUNT_BIG

使用するテーブル

サンプルコード（SQL）の記述に使用するテーブルを作成します。

テーブルの定義

PERSONテーブル

列名	データ型	主キー
PERSON_ID	int	○
PERSON_NAME	nvarchar(20)
GENDER	tinyint

テーブルのSQL

CREATE

CREATE TABLE PERSON
(
  PERSON_ID int NOT NULL PRIMARY KEY,
  PERSON_NAME nvarchar(20) NOT NULL,
  GENDER tinyint NOT NULL
);

CREATE TABLE PERSON

(

PERSON_ID int NOT NULL PRIMARY KEY,

PERSON_NAME nvarchar(20) NOT NULL,

GENDER tinyint NOT NULL

);

INSERT

INSERT INTO PERSON
  (PERSON_ID, PERSON_NAME, GENDER)
VALUES
  (101, 'Henry', 1),
  (102, 'Nancy', 2),
  (103, 'James', 1);

INSERT INTO PERSON

(PERSON_ID, PERSON_NAME, GENDER)

VALUES

(101, 'Henry', 1),

(102, 'Nancy', 2),

(103, 'James', 1);

上記のPERSONテーブルへのデータのインサートは、1回の実行で複数のレコードを挿入する形式のSQLで記述しています。
1回のINSERTで複数行のレコードをテーブルに一括で挿入する方法については、以下の記事を参照してください。

SELECTステートメントの実行件数

SELECTをSQLで実行した時の@@ROWCOUNTの値の取得結果です。

SELECT
    *
FROM
    PERSON;
SELECT @@ROWCOUNT;

SELECT

FROM

PERSON;

SELECT @@ROWCOUNT;

実行結果

テーブルには3レコード登録されていますので、取得されるレコードの3が@@ROWCOUNTに保持されています。

取得するデータの条件を追加して再度実行してみます。

SELECT
    *
FROM
    PERSON
WHERE
    GENDER = 1;
SELECT @@ROWCOUNT;

SELECT

FROM

PERSON

WHERE

GENDER = 1;

SELECT @@ROWCOUNT;

実行結果

WHERE句でGENDERの条件を「1」のみにして実行すると、取得されるレコードは2件になりますので、@@ROWCOUNTの値も2になります。

SELECTステートメントでは取得するレコードの数が@@ROWCOUNTにセットされます。

INSERTステートメントの実行件数

INSERTをSQLで実行した時の@@ROWCOUNTの値の取得結果です。

INSERT INTO PERSON (PERSON_ID, PERSON_NAME, GENDER) VALUES (201, 'Catherine', 2);
INSERT INTO PERSON (PERSON_ID, PERSON_NAME, GENDER) VALUES (202, 'Ben', 1);
SELECT @@ROWCOUNT;

INSERT INTO PERSON (PERSON_ID, PERSON_NAME, GENDER) VALUES (201, 'Catherine', 2);

INSERT INTO PERSON (PERSON_ID, PERSON_NAME, GENDER) VALUES (202, 'Ben', 1);

SELECT @@ROWCOUNT;

実行結果

@@ROWCOUNTに保持されるのは直前に実行したSQLによって影響を受けた行数（処理件数）なので、INSERTを2回連続で実行しても@@ROWCOUNTには1が保持されています。

INSERTステートメントの記述方法を変更して再度実行してみます。

INSERT INTO PERSON
  (PERSON_ID, PERSON_NAME, GENDER)
VALUES 
  (301, 'Jennifer', 2),
  (302, 'Cris', 1),
  (303, 'Amanda', 2);
SELECT @@ROWCOUNT;

INSERT INTO PERSON

(PERSON_ID, PERSON_NAME, GENDER)

VALUES

(301, 'Jennifer', 2),

(302, 'Cris', 1),

(303, 'Amanda', 2);

SELECT @@ROWCOUNT;

実行結果

1回のINSERTで複数行のレコードを追加する形式で実行すると
@@ROWCOUNTには、挿入した全レコード（上記の例では3）が保持されます。

UPDATEステートメントの実行件数

UPDATEをSQLで実行した時の@@ROWCOUNTの値の取得結果です。

UPDATE PERSON SET
  PERSON_NAME = PERSON_NAME + '_Edit';
SELECT @@ROWCOUNT;

UPDATE PERSON SET

PERSON_NAME = PERSON_NAME + '_Edit';

SELECT @@ROWCOUNT;

実行結果

WHERE句で更新対象となるレコードの条件を指定して再度実行してみます。

UPDATE PERSON SET
  PERSON_NAME = PERSON_NAME + '_Edit'
WHERE
    GENDER = 1;
SELECT @@ROWCOUNT;

UPDATE PERSON SET

PERSON_NAME = PERSON_NAME + '_Edit'

WHERE

GENDER = 1;

SELECT @@ROWCOUNT;

実行結果

UPDATEステートメントでは更新対象となったレコードの数が@@ROWCOUNTにセットされます。

DELETEステートメントの実行件数

DELETEをSQLで実行した時の@@ROWCOUNTの値の取得結果です。

DELETE PERSON
SELECT @@ROWCOUNT;

1 2	DELETE PERSON SELECT @@ROWCOUNT;

実行結果

WHERE句で更新対象となるレコードの条件を指定して再度実行してみます。

DELETE PERSON
WHERE
    GENDER = 1;
SELECT @@ROWCOUNT;

DELETE PERSON

WHERE

GENDER = 1;

SELECT @@ROWCOUNT;

実行結果

DELETEステートメントでは削除対象となったレコードの数が@@ROWCOUNTにセットされます。

PRINTステートメントの実行後

SELECT
    *
FROM
    PERSON;
PRINT 'Print something';
SELECT @@ROWCOUNT;

SELECT

FROM

PERSON;

PRINT 'Print something';

SELECT @@ROWCOUNT;

実行結果

PRINTステートメントを実行すると、@@ROWCOUNTには0がセットされます。（1はセットされません。）

Transaction

トランザクション処理を行い、テーブルを更新した後にCOMMIT、またはROLLBACKをして@@ROWCOUNTの値を取得します。

COMMIT

BEGIN TRAN;
UPDATE PERSON SET
    PERSON_NAME = PERSON_NAME + '_Edit';
COMMIT;
SELECT @@ROWCOUNT;

BEGIN TRAN;

UPDATE PERSON SET

PERSON_NAME = PERSON_NAME + '_Edit';

COMMIT;

SELECT @@ROWCOUNT;

実行結果

ROLLBACK

BEGIN TRAN;
UPDATE PERSON SET
    PERSON_NAME = PERSON_NAME + '_Edit';
ROLLBACK;
SELECT @@ROWCOUNT;

BEGIN TRAN;

UPDATE PERSON SET

PERSON_NAME = PERSON_NAME + '_Edit';

ROLLBACK;

SELECT @@ROWCOUNT;

実行結果

COMMIT、ROLLBACKともに、@@ROWCOUNTには0がセットされます。

トランザクション処理を行う場合には、INSERT、UPDATE、DELETEを実行した直後に、変数に@@ROWCOUNTの値を保持する必要があります。

BEGIN TRAN;
DELETE PERSON
WHERE
    GENDER = 1;
DECLARE @ROW_COUNT int = @@ROWCOUNT;
COMMIT;
SELECT @ROW_COUNT;

BEGIN TRAN;

DELETE PERSON

WHERE

GENDER = 1;

DECLARE @ROW_COUNT int = @@ROWCOUNT;

COMMIT;

SELECT @ROW_COUNT;

実行結果

@@ROWCOUNT と同様の関数 ROWCOUNT_BIG

@@ROWCOUNTと同様に、直前に実行したSQLによって影響を受けた行数（処理件数）は、ROWCOUNT_BIG関数で取得することもできます。

INSERT INTO PERSON
  (PERSON_ID, PERSON_NAME, GENDER)
VALUES 
  (301, 'Jennifer', 2),
  (302, 'Cris', 1),
  (303, 'Amanda', 2);
SELECT ROWCOUNT_BIG();