Microsoft SQL Server
Kursory

Składnia

• DEKLARUJ nazwa_ kursora CURSOR [LOKALNY | GLOBALNY]
  • [FORWARD_ONLY | PRZEWIŃ]
    [STATYCZNY | KLUCZ | DYNAMICZNY | FAST_FORWARD]
    [TYLKO DO CZYTANIA | SCROLL_LOCKS | OPTYMISTYCZNY ]
    [TYPE_WARNING]
  • DLA select_statement
  • [FOR UPDATE [OF column_name [, ... n]]]

Uwagi

Kursor podstawowy tylko do przodu

Zazwyczaj chciałbyś unikać używania kursorów, ponieważ mogą one mieć negatywny wpływ na wydajność. Jednak w niektórych szczególnych przypadkach może być konieczne przeglądanie rekordu danych według rekordów i wykonanie pewnych czynności.

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

Podstawowa składnia kursora

Prosta składnia kursora, działająca na kilku przykładowych wierszach testowych:

/* 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;

Wyniki z SSMS. Zauważ, że są to oddzielne zapytania, nie są one w żaden sposób ujednolicone. Zwróć uwagę, w jaki sposób silnik zapytań przetwarza każdą iterację pojedynczo zamiast w zestawie.