Home >> FAQs/Tutorials >> SQL Server FAQ

SQL Server FAQ - "@@FETCH_STATUS" - Looping through Result Set

By: FYIcenter.com

(Continued from previous topic...)

How To Loop through the Result Set with @@FETCH_STATUS?

The FETCH statement only returns one row from the result set. If you want to return all rows, you need to put the FETCH statement in a loop. A simple way to stop the loop to check the system variable @@FETCH_STATUS, which returns a status code of the last FETCH statement:

@status = @@FETCH_STATUS;
-- Returns 0, the fetch was successful
-- Returns -1, the fetch failed or end of result set reached
-- Returns -2, the row fetched is missing

The tutorial exercise below shows how @@FETCH_STATUS is used to make WHILE loop over the result set in a cursor:

USE FyiCenterData;
GO

DECLARE fyi_cursor CURSOR FOR
  SELECT id, url, notes, counts, time FROM fyi_links;
OPEN fyi_cursor;
DECLARE @id INT, @url VARCHAR(80), @notes VARCHAR(80),
  @counts INT, @time DATETIME;
FETCH NEXT FROM fyi_cursor INTO @id, @url, @notes, 
  @counts, @time;
WHILE @@FETCH_STATUS = 0 BEGIN
  PRINT CONVERT(CHAR(5),ISNULL(@id,0))
    +CONVERT(CHAR(18),ISNULL(@url,'NULL'))
    +CONVERT(CHAR(20),ISNULL(@notes,'NULL'))
    +CONVERT(CHAR(4),ISNULL(@counts,0))
    +CONVERT(CHAR(11),ISNULL(@time,'2007'));
  FETCH NEXT FROM fyi_cursor INTO @id, @url, @notes, 
    @counts, @time;
  END
CLOSE fyi_cursor;
DEALLOCATE fyi_cursor;
GO
101  dev.fyicenter.com NULL                0   Jan  1 2007
102  dba.fyicenter.com Nice site.          8   Jan  1 2007
1101 moc.retneciyf.ved NULL                0   Jan  1 2007
202  www.yahoo.com     It's another search 0   Jan  1 2007
2101 dev.fyicenter.com NULL                0   Jan  1 2007
2102 dba.fyicenter.com NULL                0   Jan  1 2007
301  netscape.com      Added long time ago!0   Jan  1 1999
302  myspace.com       Added today!        0   Jul  1 2007

(Continued on next topic...)

1. What Are Cursors?
2. How To Declare a Cursor with "DECLARE ... CURSOR"?
3. How To Execute the Cursor Queries with "OPEN" Statements?
4. How To Fetch the Next Row from a Cursor with a "FETCH" Statement?
5. How To Transfer Data from a Cursor to Variables with a "FETCH" Statement?
6. How To Loop through the Result Set with @@FETCH_STATUS?
7. How To Declare and Use Cursor Variables?
8. How To Create a Scrollable Cursor with the SCROLL Option?
9. How To Create a Dynamic Cursor with the DYNAMIC Option?