DECLARE CURSOR (Transact-SQL)

SQL Server 2012 Otras versiones

Personas que lo han encontrado til: 8 de 10 - Valorar este tema Define los atributos de un cursor de servidor de Transact-SQL, como su comportamiento de desplazamiento y la consulta utilizada para generar el conjunto de resultados sobre el que opera el cursor. DECLARE CURSOR acepta tanto la sintaxis basada en el estndar ISO como la sintaxis que utiliza un conjunto de extensiones Transact-SQL. Convenciones de sintaxis de Transact-SQL Sintaxis Copiar
ISO Syntax DECLARE cursor_name [ INSENSITIVE ] [ SCROLL ] CURSOR FOR select_statement [ FOR { READ ONLY | UPDATE [ OF column_name [ ,...n ] ] } ] [;] Transact-SQL Extended Syntax DECLARE cursor_name CURSOR [ LOCAL | GLOBAL ] [ FORWARD_ONLY | SCROLL ] [ STATIC | KEYSET | DYNAMIC | FAST_FORWARD ] [ READ_ONLY | SCROLL_LOCKS | OPTIMISTIC ] [ TYPE_WARNING ] FOR select_statement [ FOR UPDATE [ OF column_name [ ,...n ] ] ] [;]

Argumentos cursor_name Es el nombre del cursor de servidor de Transact-SQL definido. cursor_name debe cumplir las reglas de los identificadores. INSENSITIVE Define un cursor que hace una copia temporal de los datos que utiliza. Todas las solicitudes que se realizan al cursor se responden desde esta tabla temporal de tempdb; por tanto, las modificaciones realizadas en las tablas base no se reflejan en los

datos devueltos por las operaciones de captura realizadas en el cursor y adems este cursor no admite modificaciones. Cuando se utiliza la sintaxis de ISO, si se omite INSENSITIVE, las eliminaciones y actualizaciones confirmadas realizadas en las tablas subyacentes (por cualquier usuario) se reflejan en capturas posteriores. SCROLL Especifica que estn disponibles todas las opciones de captura (FIRST, LAST, PRIOR, NEXT, RELATIVE, ABSOLUTE). Si no se especifica SCROLL en una instruccin DECLARE CURSOR de ISO, la nica opcin de captura que se admite es NEXT. No es posible especificar SCROLL si se incluye tambin FAST_FORWARD. select_statement Es una instruccin SELECT estndar que define el conjunto de resultados del cursor. Las palabras clave FOR BROWSE e INTO no estn permitidas en la instruccin select_statement de una declaracin de cursor. SQL Server convierte implcitamente el cursor en otro tipo si las clusulas de la instruccin select_statement entran en conflicto con la funcionalidad del tipo de cursor solicitado. READ ONLY Evita que se efecten actualizaciones a travs de este cursor. No es posible hacer referencia al cursor en una clusula WHERE CURRENT OF de una instruccin UPDATE o DELETE. Esta opcin reemplaza la

capacidad predeterminada de actualizar el cursor. UPDATE [OF column_name [,...n]] Define las columnas actualizables en el cursor. Si se especifica OF column_name [,...n], solo las columnas enumeradas admiten modificaciones. Si se especifica UPDATE sin indicar una lista de columnas, se pueden actualizar todas las columnas. cursor_name Es el nombre del cursor de servidor de Transact-SQL definido. cursor_name debe cumplir las reglas de los identificadores. LOCAL Especifica que el mbito del cursor es local para el proceso por lotes, el procedimiento almacenado o el desencadenador en que se cre el cursor. El nombre del cursor solo es vlido en este mbito. Se puede hacer referencia al cursor mediante variables de cursor locales en el proceso por lotes, procedimiento almacenado o desencadenador, o en el parmetro OUTPUT de un procedimiento almacenado. El parmetro OUTPUT se utiliza para devolver el cursor local al proceso por lotes, procedimiento almacenado o desencadenador que realiza la llamada, el cual puede asignar el parmetro a una variable de cursor para hacer referencia al cursor despus de que el procedimiento almacenado finalice. La asignacin del cursor se cancela implcitamente cuando el proceso por lotes, procedimiento almacenado o desencadenador finaliza, a menos que el cursor se haya devuelto en un parmetro OUTPUT. En ese caso, la

asignacin del cursor se cancela cuando se cancela la asignacin de la ltima variable que hace referencia al mismo o cuando sta se sale del mbito. GLOBAL Especifica que el mbito del cursor es global para la conexin. Puede hacerse referencia al nombre del cursor en cualquier procedimiento almacenado o proceso por lotes que se ejecute en la conexin. La asignacin del cursor solo se cancela implcitamente cuando se produce la desconexin. Nota Si no se especifica GLOBAL ni LOCAL, el valor predeterminado se controla mediante la configuracin de la opcin de base de datos default to local cursor. FORWARD_ONLY Especifica que el cursor solo se puede desplazar de la primera a la ltima fila. FETCH NEXT es la nica opcin de captura admitida. Si se especifica FORWARD_ONLY sin las palabras clave STATIC, KEYSET o DYNAMIC, el cursor funciona como un cursor DYNAMIC. Cuando no se especifica FORWARD_ONLY ni tampoco SCROLL, FORWARD_ONLY es la opcin predeterminada, salvo que se especifiquen las palabras clave STATIC, KEYSET o DYNAMIC. Los cursores STATIC, KEYSET y DYNAMIC utilizan SCROLL como valor predeterminado. A diferencia de las API de base de datos, como ODBC y ADO, FORWARD_ONLY se puede utilizar con los cursores STATIC, KEYSET y DYNAMIC de Transact-SQL. STATIC

Define un cursor que hace una copia temporal de los datos que va a utilizar. Todas las solicitudes que se realizan al cursor se responden desde esta tabla temporal de tempdb; por tanto, las modificaciones realizadas en las tablas base no se reflejan en los datos devueltos por las operaciones de captura realizadas en el cursor y adems este cursor no admite modificaciones. KEYSET Especifica que la pertenencia y el orden de las filas del cursor se fijan cuando se abre el cursor. El conjunto de claves que identifica las filas de forma nica est integrado en la tabla denominada keyset de tempdb. Nota Si la consulta hace referencia por lo menos a una tabla sin un ndice nico, el cursor de conjunto de claves se convierte en cursor esttico. Los cambios realizados en valores de las tablas base que no son de clave, ya sean realizados por el propietario del cursor o confirmados por otros usuarios, son visibles cuando el propietario se desplaza por el cursor. Las inserciones realizadas por otros usuarios no son visibles (no es posible hacer inserciones a travs de un cursor de servidor de TransactSQL). Si se elimina una fila, un intento para capturar la fila devuelve un @@FETCH_STATUS de -2. Las actualizaciones de valores de clave de fuera del cursor son similares a la eliminacin de la fila anterior seguida por la insercin de la nueva fila. La fila con los nuevos valores no est visible, y los intentos de capturar la fila con los valores anteriores devuelven un @@FETCH_STATUS de -2. Los nuevos valores estn visibles si la actualizacin se realiza a travs del

cursor especificando la clusula WHERE CURRENT OF. DYNAMIC Define un cursor que, al desplazarse por l, refleja en su conjunto de resultados todos los cambios realizados en los datos de las filas. Los valores de los datos, el orden y la pertenencia de las filas pueden cambiar en cada operacin de captura. La opcin de captura ABSOLUTE no se puede utilizar en los cursores dinmicos. FAST_FORWARD Especifica un cursor FORWARD_ONLY, READ_ONLY con las optimizaciones de rendimiento habilitadas. No se puede especificar FAST_FORWARD si se especifica tambin SCROLL o FOR_UPDATE. Nota En SQL Server 2005 y versiones posteriores, FAST_FORWARD y FORWARD_ONLY pueden usarse en la misma instruccin DECLARE CURSOR. READ_ONLY Evita que se efecten actualizaciones a travs de este cursor. No es posible hacer referencia al cursor en una clusula WHERE CURRENT OF de una instruccin UPDATE o DELETE. Esta opcin reemplaza la capacidad predeterminada de actualizar el cursor. SCROLL_LOCKS Especifica que existan garantas de que las actualizaciones o las cancelaciones posicionadas realizadas a travs del cursor se lleven a cabo correctamente. SQL Server bloquea las filas mientras se leen en el cursor para garantizar su

disponibilidad en modificaciones posteriores. No es posible especificar SCROLL_LOCKS si se especifica tambin FAST_FORWARD o STATIC. OPTIMISTIC Especifica que las actualizaciones o las cancelaciones posicionadas realizadas a travs del cursor no se lleven a cabo correctamente si la fila se ha actualizado desde que se ley en el cursor. SQL Server no bloquea las filas cuando se leen en el cursor. En su lugar, utiliza comparaciones de valores de columna timestamp o un valor de suma de comprobacin si la tabla no tiene columnas timestamp, para determinar si la fila se ha modificado despus de leerla en el cursor. Si la fila se ha modificado, el intento de actualizacin o eliminacin posicionada genera un error. No es posible especificar OPTIMISTIC si se especifica tambin FAST_FORWARD. TYPE_WARNING Especifica que se enva un mensaje de advertencia al cliente si el cursor se convierte implcitamente del tipo solicitado a otro. select_statement Es una instruccin SELECT estndar que define el conjunto de resultados del cursor. Las palabras clave COMPUTE, COMPUTE BY, FOR BROWSE e INTO no estn permitidas en la instruccin select_statement de una declaracin de cursor. Nota Puede utilizar una sugerencia de consulta en una declaracin de cursor; sin embargo, si tambin utiliza la clusula FOR UPDATE OF, debe especificar

OPTION (query_hint) despus de FOR UPDATE OF. SQL Server convierte implcitamente el cursor a otro tipo si las clusulas de la instruccin select_statement entran en conflicto con la funcionalidad del tipo de cursor solicitado. Para obtener ms informacin, vea el tema relativo a las conversiones de cursor implcitas. FOR UPDATE [OF column_name [,...n]] Define las columnas actualizables en el cursor. Si se especifica OF column_name [,...n], solo las columnas enumeradas admiten modificaciones. Si se especifica UPDATE sin una lista de columnas, se pueden actualizar todas las columnas, a menos que se haya especificado la opcin de simultaneidad READ_ONLY. Comentarios

DECLARE CURSOR define los atributos de un cursor de servidor de Transact-SQL, como su comportamiento de desplazamiento y la consulta utilizada para generar el conjunto de resultados sobre el que opera el cursor. La instruccin OPEN llena el conjunto de resultados y la instruccin FETCH devuelve una fila del conjunto de resultados. La instruccin CLOSE libera el conjunto de resultados actual asociado al cursor. La instruccin DEALLOCATE libera los recursos que utiliza el cursor. La primera forma de la instruccin DECLARE CURSOR usa la sintaxis de ISO para declarar comportamientos del cursor. La segunda forma de DECLARE CURSOR utiliza extensiones de Transact-SQL que permiten definir cursores con los mismos tipos de cursor utilizados en las funciones de cursor de la API de base de datos de ODBC o ADO. No se pueden combinar las dos formas. Si especifica las palabras clave SCROLL o INSENSITIVE antes de la palabra clave CURSOR, no puede usar ninguna palabra clave entre las palabras clave CURSOR y FOR de la instruccin select_statement. Si especifica alguna palabra clave entre CURSOR y FOR de la instruccin select_statement, no puede especificar SCROLL o INSENSITIVE delante de la palabra clave CURSOR.

Si una instruccin DECLARE CURSOR con sintaxis de Transact-SQL no especifica READ_ONLY, OPTIMISTIC o SCROLL_LOCKS, el valor predeterminado es el siguiente:

Si la instruccin SELECT no acepta actualizaciones (permisos insuficientes, acceso a tablas remotas que no aceptan actualizaciones, etc.), el cursor es de tipo READ_ONLY. El valor predeterminado de los cursores de tipo STATIC y FAST_FORWARD es READ_ONLY. El valor predeterminado de los cursores de tipo KEYSET y DYNAMIC es OPTIMISTIC.

Solo se puede hacer referencia a nombres de cursores mediante otras instrucciones Transact-SQL. No se puede hacer referencia a nombres de cursores mediante funciones de la API de base de datos. Por ejemplo, despus de declarar un cursor, no se puede hacer referencia al nombre del cursor desde funciones o mtodos de OLE DB, ODBC o ADO. No se pueden capturar las filas del cursor con las funciones o mtodos de captura de las API; las filas solo se pueden capturar mediante instrucciones FETCH de Transact-SQL. Una vez que se ha declarado un cursor, se pueden utilizar estos procedimientos almacenados del sistema para determinar las caractersticas del cursor. Procedimientos almacenados del sistema sp_cursor_list sp_describe_cursor sp_describe_cursor_columns sp_describe_cursor_tables Descripcin Devuelve la lista de los cursores que estn visibles actualmente en la conexin y sus atributos. Describe los atributos de un cursor, por ejemplo si es de solo avance o de desplazamiento. Describe los atributos de las columnas en el conjunto de resultados del cursor. Describe las tablas base a las que tiene acceso el cursor.

Se pueden utilizar variables como parte de la instruccin select_statement que declara un cursor. Los valores de las variables de cursor no cambian despus de que se declara el cursor. Permisos

Los permisos para utilizar DECLARE CURSOR corresponden de manera predeterminada a los usuarios que dispongan de permisos para utilizar SELECT en las vistas, tablas y columnas utilizadas en el cursor.

Ejemplos

A.Uso de cursores simples y su sintaxis

El conjunto de resultados generado al abrir este cursor contiene todas las filas y todas las columnas de la tabla. Este cursor se puede actualizar, y todas las actualizaciones y eliminaciones se representan en las bsquedas realizadas para este cursor. FETCH NEXT es la nica bsqueda disponible porque la opcin SCROLL no se ha especificado. Copiar
DECLARE vend_cursor CURSOR FOR SELECT * FROM Purchasing.Vendor OPEN vend_cursor FETCH NEXT FROM vend_cursor;

B.Uso de cursores anidados para elaborar resultados de informes

En el ejemplo siguiente se muestra cmo se pueden anidar los cursores para elaborar informes complejos. El cursor interno se declara para cada proveedor. Copiar
SET NOCOUNT ON; DECLARE @vendor_id int, @vendor_name nvarchar(50), @message varchar(80), @product nvarchar(50); PRINT '-------- Vendor Products Report --------'; DECLARE vendor_cursor CURSOR FOR SELECT VendorID, Name FROM Purchasing.Vendor WHERE PreferredVendorStatus = 1 ORDER BY VendorID; OPEN vendor_cursor FETCH NEXT FROM vendor_cursor INTO @vendor_id, @vendor_name WHILE @@FETCH_STATUS = 0 BEGIN PRINT ' ' SELECT @message = '----- Products From Vendor: ' + @vendor_name PRINT @message -- Declare an inner cursor based -- on vendor_id from the outer cursor. DECLARE product_cursor CURSOR FOR SELECT v.Name FROM Purchasing.ProductVendor pv, Production.Product v WHERE pv.ProductID = v.ProductID AND pv.VendorID = @vendor_id -- Variable value from the outer cursor

OPEN product_cursor FETCH NEXT FROM product_cursor INTO @product IF @@FETCH_STATUS <> 0 PRINT ' <<None>>' WHILE @@FETCH_STATUS = 0 BEGIN SELECT @message = ' ' + @product PRINT @message FETCH NEXT FROM product_cursor INTO @product END CLOSE product_cursor DEALLOCATE product_cursor -- Get the next vendor. FETCH NEXT FROM vendor_cursor INTO @vendor_id, @vendor_name END CLOSE vendor_cursor; DEALLOCATE vendor_cursor;