FETCH statement retrieves rows of data from the result set of a multiple-row query—one row at a time, several rows at a time, or all rows at once—and stores the data in variables, records, or collections.
Name of an open explicit cursor. To open an explicit cursor, use the "OPEN Statement".
If you try to fetch from an explicit cursor before opening it or after closing it, PL/SQL raises the predefined exception
If you try to fetch from a cursor variable before opening it or after closing it, PL/SQL raises the predefined exception
Name of a cursor variable declared in a PL/SQL host environment, passed to PL/SQL as a bind variable, and then opened. To open a host cursor variable, use the "OPEN FOR Statement". Do not put space between the colon (:) and
The data type of a host cursor variable is compatible with the return type of any PL/SQL cursor variable.
To have the
FETCH statement retrieve one row at a time, use this clause to specify the variables or record in which to store the column values of a row that the cursor returns. For more information about
into_clause, see "into_clause ::=".
bulk_collect_into_clause [ LIMIT numeric_expression ]
bulk_collect_into_clause to specify one or more collections in which to store the rows that the
FETCH statement returns. For more information about
bulk_collect_into_clause, see "bulk_collect_into_clause ::=".
To have the
FETCH statement retrieve all rows at once, omit
To limit the number of rows that the
FETCH statement retrieves at once, specify
Restrictions on bulk_collect_into_clause
You cannot use
bulk_collect_into_clause in client programs.
FETCH statement requires implicit data type conversions,
bulk_collect_into_clause can have only one
Example 5-49, "FETCH Assigns Values to Record that Function Returns"
Example 6-6, "FETCH Statements Inside LOOP Statements"
Example 6-7, "Fetching Same Explicit Cursor into Different Variables"
Example 6-26, "Fetching Data with Cursor Variables"
Example 6-27, "Fetching from Cursor Variable into Collections"
Example 6-41, " FETCH with FOR UPDATE Cursor After COMMIT Statement"
Example 7-8, "Native Dynamic SQL with OPEN FOR, FETCH, and CLOSE Statements"
Example 12-22, "Bulk-Fetching into Two Nested Tables"
Example 12-23, "Bulk-Fetching into Nested Table of Records"
Example 12-24, "Limiting Bulk FETCH with LIMIT"
In this chapter:
In other chapters: