1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194
|
<HTML
><HEAD
><TITLE
>Cursor Handling</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
REL="HOME"
TITLE="GNADE User's Guide"
HREF="gnade.html"><LINK
REL="UP"
TITLE="Embedded SQL Syntax Specification"
HREF="esqlsyntax.html"><LINK
REL="PREVIOUS"
TITLE="Connection Handling"
HREF="x320.htm"><LINK
REL="NEXT"
TITLE="Mixing ODBC and embedded SQLcode "
HREF="x342.htm"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>GNADE User's Guide: GNADE, The GNat Ada Database Environment; Version 1.2.0; Document Revision $Revision: 1.26 $</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="x320.htm"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 11. Embedded SQL Syntax Specification</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="x342.htm"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="AEN331"
>Cursor Handling</A
></H1
><P
> A cursor is a declares a SQL query with its input and result
parameters. The result set is created when the cursor is opened.
The syntax for declaring, opening and closing a cursor is shown
below.
</P
><PRE
CLASS="PROGRAMLISTING"
> 'DECLARE' <name> [ 'REOPENABLE' | 'LOCAL' ] 'CURSOR'
'FOR' <sql query>
'OPEN' <name>
'CLOSE' <name> ['FINAL']
</PRE
><P
> LOCAL cursors are only defined within the scope of the block
where the nearest DECLARE section is. If the scope is left,
the cursor and the associated result set are deleted.
</P
><DIV
CLASS="EXAMPLE"
><P
><B
>Example 11-4. Local Cursors</B
></P
><P
> As shown in the example below, the cursor emp_cursor will only be
valid in the scope of the procedure Print_Departement:
</P
><PRE
CLASS="PROGRAMLISTING"
> procedure Print_Departement( ..........
... departement : in Integer ) is
EXEC SQL BEGIN DECLARE SECTION ;
....
Depno : INT := INT( Departement );
....
EXEC SQL END DECLARE SECTION ;
begin
EXEC SQL AT DB01
DECLARE emp_cursor LOCAL CURSOR FOR
SELECT EMPNO, FIRSTNAME, NAME, JOB, MANAGER, SALARY
FROM employees
WHERE deptno = :Depno ORDER BY EMPNO, NAME;
.......
</PRE
></DIV
><P
> Normally it is not possible to open the same cursor twice. The
type REOPENABLE has been introduced, in order to allow the recursive
opening of cursors. This feature may also be emulated by means of
recursive procedures with local cursors.
</P
><P
> If the cursor type is omitted the cursor and its associated
result set to exist only once.
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="x320.htm"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="gnade.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="x342.htm"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Connection Handling</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="esqlsyntax.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Mixing ODBC and embedded SQLcode</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
|