Beginning Microsoft SQL Server 2008 ... - S3 Tech Training

Appendix A: System Functions
@@FETCH_STATUS
Returns an indicator of the status of the last cursor FETCH operation.
If you’re using cursors, you’re going to be using @@FETCH_STATUS. This one is how you know the success or
failure of your attempt to navigate to a record in your cursor. It will return a constant depending on whether
SQL Server succeeded in your last FETCH operation or not, and, if the FETCH failed, why. The constants are:
❑ 0 — Success
❑ -1 — Failed. Usually because you are beyond either the beginning or end of the cursorset.
❑ -2 — Failed. The row you were fetching wasn’t found, usually because it was deleted between
the time when the cursorset was created and when you navigated to the current row. Should
only occur in scrollable, non-dynamic cursors.
For purposes of readability, I often will set up some constants prior to using @@FETCH_STATUS.
For example:
DECLARE @NOTFOUND int
DECLARE @BEGINEND int
SELECT @NOTFOUND = -2
SELECT @BEGINEND = -1
I can then use these in my conditional in the WHILE statement of my cursor loop instead of just the row
integer. This can make the code quite a bit more readable.
CURSOR_STATUS
604
The CURSOR_STATUS function allows the caller of a stored procedure to determine if that procedure has
returned a cursor and result set. The syntax is as follows:
CURSOR_STATUS
(
{‘’, ‘’}
| {‘, ‘’}
| {‘’, ‘’}
)
local, global, and variable all specify constants that indicate the source of the cursor. local equates
to a local cursor name, global to a global cursor name, and variable to a local variable.
If you are using the cursor name form then there are four possible return values:
❑ 1 — The cursor is open. If the cursor is dynamic, its result set has zero or more rows. If the cursor
is not dynamic, it has one or more rows.
❑ 0 — The result set of the cursor is empty.
❑ -1 — The cursor is closed.
❑ –3 — A cursor of cursor name does not exist.