Cursors for row iteration in MySQL

Introduction

Cursors let you look at each row in a table one by one. This helps when you want to do something with each row separately.

You want to send an email to each user in a list.

You need to update rows one at a time based on some complex logic.

You want to process orders one by one to check stock.

You want to generate a report by reading rows step-by-step.

Syntax

MySQL

DECLARE cursor_name CURSOR FOR select_statement;
OPEN cursor_name;
FETCH cursor_name INTO variable_list;
-- process data
CLOSE cursor_name;

You must DECLARE the cursor before using it.

Always OPEN the cursor before FETCHing rows and CLOSE it when done.

Examples

Declare a cursor named user_cursor to select id and name from the users table.

MySQL

DECLARE user_cursor CURSOR FOR SELECT id, name FROM users;

Open the cursor and fetch the first row into variables user_id and user_name.

MySQL

OPEN user_cursor;
FETCH user_cursor INTO user_id, user_name;

Close the cursor when finished to free resources.

MySQL

CLOSE user_cursor;

Sample Program

This procedure uses a cursor to go through each user in the users table. For each user, it shows their ID and name.

MySQL

DELIMITER $$
CREATE PROCEDURE process_users()
BEGIN
  DECLARE done INT DEFAULT FALSE;
  DECLARE u_id INT;
  DECLARE u_name VARCHAR(100);
  DECLARE user_cursor CURSOR FOR SELECT id, name FROM users;
  DECLARE CONTINUE HANDLER FOR NOT FOUND SET done = TRUE;

  OPEN user_cursor;

  read_loop: LOOP
    FETCH user_cursor INTO u_id, u_name;
    IF done THEN
      LEAVE read_loop;
    END IF;
    -- For example, print user info (simulate with SELECT)
    SELECT CONCAT('User ID: ', u_id, ', Name: ', u_name) AS user_info;
  END LOOP;

  CLOSE user_cursor;
END$$
DELIMITER ;

CALL process_users();

Important Notes

Always declare a handler for NOT FOUND to know when the cursor has no more rows.

Cursors are slower than set-based queries, so use them only when needed.

Summary

Cursors let you handle rows one by one.

Declare, open, fetch, and close a cursor in that order.

Use a handler to detect when no more rows are left.

Practice

1. What is the main purpose of using a cursor in MySQL?

easy

A. To create new tables dynamically

B. To speed up bulk inserts

C. To process query results row by row

D. To backup the database automatically

Solution

1. Step 1: Understand cursor functionality

   Cursors allow you to handle each row of a query result individually instead of all at once.

2. Step 2: Identify the correct purpose

   Processing rows one by one matches the cursor's main use, unlike speeding inserts or creating tables.

3. Final Answer:

   To process query results row by row -> Option C

4. Quick Check:

   Cursor = row-by-row processing [OK]

Hint: Cursors = row-by-row handling, not bulk operations [OK]

Common Mistakes:

• Thinking cursors speed up inserts
• Confusing cursors with backup tools
• Assuming cursors create tables

2. Which of the following is the correct order of cursor operations in MySQL?

easy

A. DECLARE, FETCH, OPEN, CLOSE

B. DECLARE, OPEN, FETCH, CLOSE

C. FETCH, DECLARE, OPEN, CLOSE

D. OPEN, DECLARE, FETCH, CLOSE

Solution

1. Step 1: Recall cursor lifecycle

   First, you declare the cursor, then open it to start fetching rows, and finally close it when done.

2. Step 2: Match the correct sequence

   Only DECLARE, OPEN, FETCH, CLOSE follows the correct order of cursor operations.

3. Final Answer:

   DECLARE, OPEN, FETCH, CLOSE -> Option B

4. Quick Check:

   Cursor order = DECLARE -> OPEN -> FETCH -> CLOSE [OK]

Hint: Remember: Declare first, then open, fetch, and close last [OK]

Common Mistakes:

• Opening cursor before declaring
• Fetching before opening
• Closing before fetching all rows

3. Consider this MySQL cursor code snippet inside a stored procedure:

DECLARE done INT DEFAULT FALSE;
DECLARE cur CURSOR FOR SELECT id FROM users;
DECLARE CONTINUE HANDLER FOR NOT FOUND SET done = TRUE;
OPEN cur;
read_loop: LOOP
  FETCH cur INTO @user_id;
  IF done THEN
    LEAVE read_loop;
  END IF;
  SELECT @user_id;
END LOOP;
CLOSE cur;

What will this code output?

medium

A. It prints each user id from the users table one by one

B. It prints only the first user id

C. It causes a syntax error due to missing variable declaration

D. It prints nothing because the loop never runs

Solution

1. Step 1: Analyze cursor fetching loop

   The cursor fetches each id from users table into @user_id, then prints it until no rows remain.

2. Step 2: Understand handler and loop exit

   The handler sets done = TRUE when no more rows, causing loop to exit properly after printing all ids.

3. Final Answer:

   It prints each user id from the users table one by one -> Option A

4. Quick Check:

   Cursor loop prints all rows one by one [OK]

Hint: Handler sets done; loop prints all fetched rows [OK]

Common Mistakes:

• Assuming only first row prints
• Missing handler causes infinite loop
• Confusing session variables with local variables

4. You wrote this MySQL cursor code but it causes an infinite loop:

DECLARE done INT DEFAULT FALSE;
DECLARE cur CURSOR FOR SELECT name FROM employees;
OPEN cur;
read_loop: LOOP
  FETCH cur INTO @emp_name;
  IF done THEN
    LEAVE read_loop;
  END IF;
  SELECT @emp_name;
END LOOP;
CLOSE cur;

What is the likely cause of the infinite loop?

medium

A. The SELECT statement inside loop causes the loop to restart

B. Cursor was not declared before opening

C. Variable @emp_name is not declared

D. Missing CONTINUE HANDLER to set done = TRUE when no rows left

Solution

1. Step 1: Check for handler presence

   The code lacks a CONTINUE HANDLER to set done = TRUE when no more rows are fetched.

2. Step 2: Understand loop exit condition

   Without setting done = TRUE, the IF condition never triggers LEAVE, causing infinite loop.

3. Final Answer:

   Missing CONTINUE HANDLER to set done = TRUE when no rows left -> Option D

4. Quick Check:

   No handler = infinite loop [OK]

Hint: Always add handler to set done flag for loop exit [OK]

Common Mistakes:

• Forgetting CONTINUE HANDLER
• Assuming loop exits automatically
• Misplacing variable declarations

5. You want to write a stored procedure that sums the salaries of all employees using a cursor. Which approach correctly uses a cursor to calculate the total salary?

DECLARE done INT DEFAULT FALSE;
DECLARE total_salary DECIMAL(10,2) DEFAULT 0;
DECLARE cur CURSOR FOR SELECT salary FROM employees;
DECLARE CONTINUE HANDLER FOR NOT FOUND SET done = TRUE;
OPEN cur;
read_loop: LOOP
  FETCH cur INTO @sal;
  IF done THEN
    LEAVE read_loop;
  END IF;
  SET total_salary = total_salary + @sal;
END LOOP;
CLOSE cur;
SELECT total_salary;

What is the expected output of this procedure?

hard

A. The sum of all employee salaries

B. Syntax error due to missing variable declaration for @sal

C. Zero, because total_salary is not updated correctly

D. The procedure runs but returns NULL

Solution

1. Step 1: Verify declaration order and variables

   All local variables (done, total_salary) are declared before the cursor and handler. FETCH INTO @sal uses a session variable, which is valid.

2. Step 2: Trace execution

   The loop fetches each salary, adds it to total_salary until the handler sets done=TRUE, then SELECT outputs the sum.

3. Final Answer:

   The sum of all employee salaries -> Option A

4. Quick Check:

   Cursor loop + handler + accumulation = total sum [OK]

Hint: DECLARE order: locals first, then cursors, handlers. FETCH INTO @var OK [OK]

Common Mistakes:

• Declaring variables after cursors/handlers
• Thinking @vars require DECLARE
• Missing handler or wrong loop condition