DECLARE CURSOR

Syntax

Current

DECLARE cursor_name CURSOR [(cursor_formal_parameter[,...])] FOR select_statement

cursor_formal_parameter:
    [IN] name type [collate clause]

< 10.8

Description

This statement declares a cursor. Multiple cursors may be declared in a stored program, but each cursor in a given block must have a unique name.

select_statement is not executed until the OPEN statement is executed. It is important to remember this if the query produces an error, or calls functions which have side effects.

A SELECT associated to a cursor can use variables, but the query itself cannot be a variable, and cannot be dynamically composed. The SELECT statement cannot have an INTO clause.

Cursors must be declared before HANDLERs, but after local variables and CONDITIONs.

Parameters

Cursors can have parameters. This is a non-standard SQL extension. Cursor parameters can appear in any part of the DECLARE CURSOR select_statement where a stored procedure variable is allowed (select list, WHERE, HAVING, LIMIT , and so forth).

IN

Current

The IN qualifier is supported in the cursor_formal_parameter part of the syntax.

< 10.8

See Cursor Overview for an example.

See Also

• Cursor Overview

• OPEN cursor_name

• FETCH cursor_name

• CLOSE cursor_name

• Cursors in Oracle mode

_{This page is licensed: GPLv2, originally from fill_help_tables.sql}