Microsoft SQL Server
カーソル

構文

• DECLARE cursor_name CURSOR [ローカル|グローバル ]
  • [FORWARD_ONLY |スクロール]
    [静的| KEYSET |ダイナミック|早送り ]
    [READ_ONLY | SCROLL_LOCKS |最適]
    [TYPE_WARNING]
  • FOR select_statement
  • [FOR UPDATE [OF column_name [、... n]]]

備考

基本転送専用カーソル

通常は、カーソルがパフォーマンスに悪影響を与える可能性があるため、カーソルを使用しないでください。しかし、特別な場合には、データレコードをレコードごとにループし、何らかのアクションを実行する必要があります。

DECLARE @orderId AS INT

-- here we are creating our cursor, as a local cursor and only allowing 
-- forward operations
DECLARE rowCursor CURSOR LOCAL FAST_FORWARD FOR
    -- this is the query that we want to loop through record by record
    SELECT [OrderId]
    FROM [dbo].[Orders]

-- first we need to open the cursor
OPEN rowCursor

-- now we will initialize the cursor by pulling the first row of data, in this example the [OrderId] column,
-- and storing the value into a variable called @orderId
FETCH NEXT FROM rowCursor INTO @orderId

-- start our loop and keep going until we have no more records to loop through
WHILE @@FETCH_STATUS = 0 
BEGIN

    PRINT @orderId
    
    -- this is important, as it tells SQL Server to get the next record and store the [OrderId] column value into the @orderId variable
    FETCH NEXT FROM rowCursor INTO @orderId

END

-- this will release any memory used by the cursor
CLOSE rowCursor
DEALLOCATE rowCursor

初歩的なカーソル構文

いくつかのテスト行の例で動作する単純なカーソル構文：

/* Prepare test data */
DECLARE @test_table TABLE
(
    Id INT,
    Val VARCHAR(100)
);
INSERT INTO @test_table(Id, Val)
VALUES 
    (1, 'Foo'), 
    (2, 'Bar'), 
    (3, 'Baz');
/* Test data prepared */

/* Iterator variable @myId, for example sake */
DECLARE @myId INT;

/* Cursor to iterate rows and assign values to variables */
DECLARE myCursor CURSOR FOR
    SELECT Id
    FROM @test_table;

/* Start iterating rows */
OPEN myCursor;
FETCH NEXT FROM myCursor INTO @myId;

/* @@FETCH_STATUS global variable will be 1 / true until there are no more rows to fetch */
WHILE @@FETCH_STATUS = 0
BEGIN

    /* Write operations to perform in a loop here. Simple SELECT used for example */
    SELECT Id, Val
    FROM @test_table 
    WHERE Id = @myId;

    /* Set variable(s) to the next value returned from iterator; this is needed otherwise the cursor will loop infinitely. */
    FETCH NEXT FROM myCursor INTO @myId;
END
/* After all is done, clean up */
CLOSE myCursor;
DEALLOCATE myCursor;

SSMSの結果。これらはすべて個別のクエリであり、決して統一されていないことに注意してください。クエリエンジンは、各反復を1つずつセットとして処理するのではなく、1つずつ処理する方法に注目してください。