UNDAC SBD II

Procedimientos almacenados en Transact SQL

    Un procedimiento es un programa dentro de la base de datos que ejecuta una acción o
conjunto de acciones especificas.
    Un procedimiento tiene un nombre, un conjunto de parámetros (opcional) y un bloque de
código.
    En Transact SQL los procedimientos almacenados pueden devolver valores (numerico entero)
o conjuntos de resultados.
    Para crear un procedimiento almacenado debemos emplear la sentencia CREATE
PROCEDURE.

CREATE PROCEDURE <nombre_procedure> [@param1 <tipo>, ...]

AS
-- Sentencias del procedure
    Para modificar un procedimiento almacenado debemos emplear la sentencia ALTER
PROCEDURE.

ALTER PROCEDURE <nombre_procedure> [@param1 <tipo>, ...]

AS
-- Sentencias del procedure

    El siguiente ejemplo muestra un procedimiento almacenado, denominado spu_addCliente que

inserta un registro en la tabla "CLIENTES". 

CREATE PROCEDURE spu_addCliente @nombre varchar(100),

@apellido1 varchar(100),
@apellido2 varchar(100),
@nifCif varchar(20),
@fxNaciento datetime
AS
INSERT INTO CLIENTES
(nombre, apellido1, apellido2, nifcif, fxnacimiento) VALUES
(@nombre, @apellido1, @apellido2, @nifCif, @fxNaciento)

    Para la ejecutar un procedimiento almacenado debemos utilizar la sentencia EXEC. Cuando la
ejecución del procedimiento almacenado es la primera instrucción del lote, podemos omitir el uso
de EXEC.

Ing. Williams A. Muñoz Robles 1

 UNDAC SBD II

    El siguiente ejemplo muestra la ejecución del procedimiento almacenado anterior.

DECLARE @fecha_nacimiento datetime

set @fecha_nacimiento = convert(datetime, '13/05/1975', 103)
EXEC spu_addCliente 'Pedro', 'Herrarte', 'Sanchez',
'00000002323', @fecha_nacimiento
    Siempre es deseable que las instrucciones del procedure esten dentro de un bloque TRY
CATCH y controlados por una transacción.

ALTER PROCEDURE spu_addCliente @nombre varchar(100),

@apellido1 varchar(100),
@apellido2 varchar(100),
@nifCif varchar(20),
@fxNaciento datetime
AS
BEGIN TRY
BEGIN TRAN
INSERT INTO CLIENTES
(nombre, apellido1, apellido2, nifcif, fxnacimiento) VALUES
(@nombre, @apellido1, @apellido2, @nifCif, @fxNaciento)
COMMIT
END TRY
BEGIN CATCH
ROLLBACK
PRINT ERROR_MESSAGE()
END CATCH
    Si queremos que los parámetros de un procedimiento almacenado sean de entrada-salida
debemos especificarlo a través de la palabra clave OUTPUT , tanto en la definición del procedure
como en la ejecución.
    El siguiente ejemplo muestra la definición de un procedure con parámetros de salida.

CREATE PROCEDURE spu_ObtenerSaldoCuenta @numCuenta varchar(20),

@saldo decimal(10,2) output
AS
BEGIN
SELECT @saldo = SALDO
FROM CUENTAS
WHERE NUMCUENTA = @numCuenta

Ing. Williams A. Muñoz Robles 2

 UNDAC SBD II

END

     Y para ejecutar este procedure:

DECLARE @saldo decimal(10,2)

EXEC spu_ObtenerSaldoCuenta '200700000001', @saldo output
PRINT @saldo
    Un procedimiento almacenado puede devolver valores numericos enteros a través de la
instrucción RETURN. Normalmente debemos utilizar los valores de retorno para determinar si la
ejecución del procedimiento ha sido correcta o no. Si queremos obtener valores se recomienda
utilizar parámetros de salida o funciones escalares (se verán mas adelante en este tutorial).
    El siguiente ejemplo muestra un procedimiento almacenado que devuelve valores.

CREATE PROCEDURE spu_EstaEnNumerosRojos @numCuenta varchar(20)

AS
BEGIN
IF (SELECT SALDO FROM CUENTAS
WHERE NUMCUENTA = @numCuenta) < 0
BEGIN
RETURN 1
END
ELSE
RETURN 0
END
    El siguiente ejemplo muestra como ejecutar el procedure y obtener el valor devuelto.

DECLARE @rv int

EXEC @rv = spu_EstaEnNumerosRojos '200700000001'
PRINT @rv
    Otra caracteristica muy interesante de los procedimientos almacenados en Transact SQL es
que pueden devolver uno o varios conjuntos de resultados.
    El siguiente ejemplo muestra un procedimiento almacenado que devuelve un conjunto de
resultados.

CREATE PROCEDURE spu_MovimientosCuenta @numCuenta varchar(20)

AS
BEGIN
SELECT @numCuenta,

Ing. Williams A. Muñoz Robles 3

 UNDAC SBD II

SALDO_ANTERIOR,
SALDO_POSTERIOR,
IMPORTE,
FXMOVIMIENTO
FROM MOVIMIENTOS
INNER JOIN CUENTAS ON MOVIMIENTOS.IDCUENTA = CUENTAS.IDCUENTA
WHERE NUMCUENTA = @numCuenta
ORDER BY FXMOVIMIENTO DESC
END
    La ejecución del procedimiento se realiza normalmente.

EXEC spu_MovimientosCuenta '200700000001'

    El resultado de la ejecucion ...
NUMCUENTA     SALDO_ANTERIOR SALDO_POSTERIOR  IMPORTE FXMOVIMIENTO
------------  -------------- ---------------- ------- -----------------------
200700000001  50.99          100.99           50.00   2007-08-25 16:18:36.490
200700000001  0.99           50.99            50.00   2007-08-23 16:20:41.183
200700000001  50.99          0.99             50.00   2007-08-23 16:16:29.840
200700000001  0.99           50.99            50.00   2007-08-23 16:14:05.900

Ing. Williams A. Muñoz Robles 4

 UNDAC SBD II

Funciones en Transact SQL

    SQL Server proporciona al usuario la posibilidad de definir sus propias funciones, conocidad
como UDF (user defined functions). Exisiten tres tipos de funciones. Estas son:
 Funciones escalares.
 Funciones en línea.
 Funciones en línea de multiples sentencias
Funciones escalares
    Las funciones escalares devuelven un único valor de cualquier tipo de los datos tal como int, money,
varchar, real, etc.  
    La sintaxis para una función escalar es la siguiente:

CREATE FUNCTION <Scalar_Function_Name, sysname, FunctionName>

(
-- Lista de parámetros
<@Param1, sysname, @p1> <Data_Type_For_Param1, , int>, ...
)
-- Tipo de datos que devuelve la función.
RETURNS <Function_Data_Type, ,int>
AS
BEGIN
...
END
    El siguiente ejemplo muestra como crear una función escalar.

CREATE FUNCTION fn_MultiplicaSaldo

(
@NumCuenta VARCHAR(20),
@Multiplicador DECIMAL(10,2)
)
RETURNS DECIMAL(10,2)
AS
BEGIN
DECLARE @Saldo DECIMAL(10,2),
@Return DECIMAL(10,2)
 
SELECT @Saldo = SALDO
FROM CUENTAS

Ing. Williams A. Muñoz Robles 5

 UNDAC SBD II

WHERE NUMCUENTA = @NumCuenta

 
SET @Return = @Saldo * @Multiplicador
 
RETURN @Return
END
    Pueden ser utilizadas en cualquier sentencia Transact SQL. Un aspecto a tener en cuenta, es que para
utilizar una función escalar debemos identificar el nombre de la función con el propietario de la misma.
    El siguiente ejemplo muestra como utilizar la función anteriormente creada en una sentencia Transact
SQL. Un aspecto muy a tener en cuenta es que la función ejecutará sus sentencias SELECT una vez por cada
fila del conjunto de resultados devuelto por la consulta SELECT principal.

SELECT IDCUENTA,
NUMCUENTA,
SALDO,
FXALTA,
-- Ejecucion de la funcion:
dbo.fn_MultiplicaSaldo( NUMCUENTA, IDCUENTA) AS RESULTADO
FROM CUENTAS
    El siguiente ejemplo muestra como utilizar una función escalar en un script Transact SQL.

DECLARE @NumCuenta VARCHAR(20),

@Resultado DECIMAL(10,2)
 
SET @NumCuenta = '200700000001'
SET @Resultado = dbo.fn_MultiplicaSaldo(@NumCuenta, 30.5)
 
PRINT @Resultado
    Las funciones escalares son muy similares a procedimientos almacenados con parámetros de
salida, pero estas pueden ser utilizadas en consultas de seleccion y en la clausula where de las
mismas.
    Las funciones no pueden ejecutar sentencias INSERT o UPDATE.
Funciones en linea
    Las funciones en linea son las funciones que devuelven un conjunto de resultados
correspondientes a la eecución de una sentencia SELECT.
    La sintaxis para una función de tabla en linea es la siguiente:

CREATE FUNCTION <Inline_Function_Name, sysname, FunctionName>

Ing. Williams A. Muñoz Robles 6

 UNDAC SBD II

(
-- Lista de parámetros
<@param1, sysname, @p1> <Data_Type_For_Param1, , int>,...
)
RETURNS TABLE
AS
RETURN
(
-- Sentencia Transact SQL
)
    El siguiente ejemplo muestra como crear una función en linea.

CREATE FUNCTION fn_MovimientosCuenta

(
@NumCuenta VARCHAR(20)
)
RETURNS TABLE
AS
RETURN
(
SELECT MOVIMIENTOS.*
FROM MOVIMIENTOS
INNER JOIN CUENTAS ON MOVIMIENTOS.IDCUENTA = CUENTAS.IDCUENTA
WHERE CUENTAS.NUMCUENTA = @NumCuenta
)
    No podemos utilizar la clausula ORDER BY en la sentencia de una función el línea.
    Las funciones en linea pueden utilizarse dentro de joins o querys como si fueran una tabla
normal.

SELECT * FROM fn_MovimientosCuenta('200700000001')

SELECT *
FROM CUENTAS
INNER JOIN CUENTAS_CLIENTE
ON CUENTAS_CLIENTE.IDCUENTA = CUENTAS.IDCUENTA
INNER JOIN CLIENTES
ON CLIENTES.id = CUENTAS_CLIENTE.IDCLIENTE
INNER JOIN fn_MovimientosCuenta('200700000001') A

Ing. Williams A. Muñoz Robles 7

 UNDAC SBD II

ON A.IDCUENTA= CUENTAS.IDCUENTA
Funciones en línea de multiples sentencias
    Las funciones en línea de multiples sentencias son similares a las funciones en línea excepto
que el conjunto de resultados que devuelven puede estar compuesto por la ejecución de varios
consultas SELECT.
    Este tipo de función se usa en situaciones donde se requiere una mayor lógica de proceso.
    La sintaxis para una funciones de tabla de multi sentencias es la siguiente:

CREATE FUNCTION <Table_Function_Name, sysname, FunctionName>

(
-- Lista de parámetros
<@param1, sysname, @p1> <data_type_for_param1, , int>, ...
)
RETURNS
-- variable de tipo tabla y su estructura
<@Table_Variable_Name, sysname, @Table_Var> TABLE
(
<Column_1, sysname, c1> <Data_Type_For_Column1, , int>,
<Column_2, sysname, c2> <Data_Type_For_Column2, , int>
)
AS
BEGIN
-- Sentencias que cargan de datos la tabla declarada
RETURN
END
    El siguiente ejemplo muestra el uso de una funcion de tabla de multi sentencias. 
 
/* Esta funcion busca la tres cuentas con mayor saldo
* y obtiene los tres últimos movimientos de cada una
* de estas cuentas
*/

CREATE FUNCTION fn_CuentaMovimietos()

RETURNS @datos TABLE
( -- Estructura de la tabla que devuelve la funcion.
NumCuenta varchar(20),
Saldo decimal(10,2),
Saldo_anterior decimal(10,2),

Ing. Williams A. Muñoz Robles 8

 UNDAC SBD II

Saldo_posterior decimal(10,2),
Importe_Movimiento decimal(10,2),
FxMovimiento datetime
)
AS
BEGIN
-- Variables necesarias para la lógica de la funcion.
DECLARE @idcuenta int,
@numcuenta varchar(20),
@saldo decimal(10,2)
 
-- Cursor con las 3 cuentas de mayor saldo
DECLARE CDATOS CURSOR FOR
SELECT TOP 3 IDCUENTA, NUMCUENTA, SALDO
FROM CUENTAS
ORDER BY SALDO DESC
 
OPEN CDATOS
FETCH CDATOS INTO @idcuenta, @numcuenta, @saldo
 
-- Recorremos el cursor
WHILE (@@FETCH_STATUS = 0)
BEGIN
-- Insertamos la cuenta en la variable de salida
INSERT INTO @datos
(NumCuenta, Saldo)
VALUES
(@numcuenta, @saldo)
-- Insertamos los tres últimos movimientos de la cuenta
INSERT INTO @datos
(Saldo_anterior, Saldo_posterior,
Importe_Movimiento, FxMovimiento )
SELECT TOP 3
SALDO_ANTERIOR, SALDO_POSTERIOR,
IMPORTE, FXMOVIMIENTO
FROM MOVIMIENTOS
WHERE IDCUENTA = @idcuenta
ORDER BY FXMOVIMIENTO DESC
-- Vamos a la siguiente cuenta
FETCH CDATOS INTO @idcuenta, @numcuenta, @saldo

Ing. Williams A. Muñoz Robles 9

 UNDAC SBD II

END
 
CLOSE CDATOS;
DEALLOCATE CDATOS;
 
RETURN
END
    Para ejecutar la función:

select * from fn_CuentaMovimietos()

   
Y el resultado obtenido ...

NumCuenta    Saldo  Saldo_anterior  Saldo_posterior  Importe_Movimiento  FxMovimiento          

------------ ------ --------------- ---------------- ------------------- -----------------------
200700000002 500.00 NULL            NULL             NULL                NULL                  
NULL         NULL   550.00          500.00           50.00               2007-08-25 16:18:36.490
NULL         NULL   600.00          550.00           50.00               2007-08-23 16:20:41.183
NULL         NULL   600.00          550.00           50.00               2007-08-23 16:14:05.900
200700000001 100.99 NULL            NULL             NULL                NULL                  
NULL         NULL   50.99           100.99           50.00               2007-08-25 16:18:36.490
NULL         NULL   0.99            50.99            50.00               2007-08-23 16:20:41.183
NULL         NULL   50.99           0.99             50.00               2007-08-23 16:16:29.840

Ing. Williams A. Muñoz Robles 10

 UNDAC SBD II

Triggers en Transact SQL

    Un trigger (o desencadenador) es una clase especial de procedimiento almacenado que se
ejecuta automáticamente cuando se produce un evento en el servidor de bases de datos.
    SQL Server proporciona los siguientes tipos de triggers:
 Trigger DML, se ejecutan cuando un usuario intenta modificar datos mediante un evento
de lenguaje de manipulación de datos (DML). Los eventos DML son instrucciones INSERT, UPDATE
o DELETE de una tabla o vista.
 Trigger DDL, se ejecutan en respuesta a una variedad de eventos de lenguaje de
definición de datos (DDL). Estos eventos corresponden principalmente a instrucciones CREATE,
ALTER y DROP de Transact-SQL, y a determinados procedimientos almacenados del sistema que
ejecutan operaciones de tipo DDL.
Trigger DML.
    Los trigger DML se ejecutan cuando un usuario intenta modificar datos mediante un evento de
lenguaje de manipulación de datos (DML). Los eventos DML son instrucciones INSERT, UPDATE o
DELETE de una tabla o vista.
    La sintaxis general de un trigger es la siguiente.

CREATE TRIGGER <Trigger_Name, sysname, Trigger_Name>

ON <Table_Name, sysname, Table_Name>
AFTER <Data_Modification_Statements, , INSERT,DELETE,UPDATE>
AS
BEGIN
-- SET NOCOUNT ON added to prevent extra result sets from
-- interfering with SELECT statements.
SET NOCOUNT ON;
-- Insert statements for trigger here
END
    Antes de ver un ejemplo es necesario conocer las tablas inserted y deleted.
    Las instrucciones de triggers DML utilizan dos tablas especiales denominadas inserted
y deleted. SQL Server crea y administra automáticamente ambas tablas. La estructura de las
tablas inserted y deleted es la misma que tiene la tabla que ha desencadenado la ejecución del
trigger.
    La primera tabla (inserted) solo está disponible en las operaciones INSERT y UPDATE y en ella
están los valores resultantes después de la inserción o actualización. Es decir, los datos insertados.
Inserted estará vacia en una operación DELETE.

Ing. Williams A. Muñoz Robles 11

 UNDAC SBD II

    En la segunda (deleted), disponible en las operaciones UPDATE y DELETE, están los valores
anteriores a la ejecución de la actualización o borrado. Es decir, los datos que serán borrados.
Deleted estará vacia en una operación INSERT.
    ¿No existe una tabla UPDATED? No, hacer una actualización es lo mismo que borrar (deleted)
e insertar los nuevos (inserted). La sentencia UPDATE es la única en la que inserted y deleted
tienen datos simultaneamente.
    No puede se modificar directamente los datos de estas tablas.
    El siguiente ejemplo, graba un histórico de saldos cada vez que se modifica un saldo de la tabla
cuentas.

CREATE TRIGGER TR_CUENTAS

ON CUENTAS
AFTER UPDATE
AS
BEGIN
-- SET NOCOUNT ON impide que se generen mensajes de texto
-- con cada instrucción
SET NOCOUNT ON;
INSERT INTO HCO_SALDOS
(IDCUENTA, SALDO, FXSALDO)
SELECT IDCUENTA, SALDO, getdate()
FROM INSERTED
END
    La siguiente instrucción provocará que el trigger se ejecute:

UPDATE CUENTAS
SET SALDO = SALDO + 10
WHERE IDCUENTA = 1
    Una consideración a tener en cuenta es que el trigger se ejecutará aunque la instruccion DML
(UPDATE, INSERT o DELETE ) no haya afectado a ninguna fila. En este caso inserted y deleted
devolveran un conjunto de datos vacio.
    Podemos especificar a que columnas de la tabla debe afectar el trigger.

ALTER TRIGGER TR_CUENTAS

ON CUENTAS
AFTER UPDATE
AS

Ing. Williams A. Muñoz Robles 12

 UNDAC SBD II

BEGIN
-- SET NOCOUNT ON impide que se generen mensajes de texto
-- con cada instrucción
SET NOCOUNT ON;
 
IF UPDATE(SALDO) -- Solo si se actualiza SALDO
BEGIN
INSERT INTO HCO_SALDOS
(IDCUENTA, SALDO, FXSALDO)
SELECT IDCUENTA, SALDO, getdate()
FROM INSERTED
END
END
    Los trigger están dentro de la transacción original (Insert, Delete o Update) por lo cual si dentro
de nuestro trigger hacemos un RollBack Tran, no solo estaremos echando atrás nuestro trigger
sino también toda la transacción; en otras palabras si en un trigger ponemos un RollBack Tran, la
transacción de Insert, Delete o Update volverá toda hacia atrás.

ALTER TRIGGER TR_CUENTAS

ON CUENTAS
AFTER UPDATE
AS
BEGIN
-- SET NOCOUNT ON impide que se generen mensajes de texto
-- con cada instrucción
SET NOCOUNT ON;
INSERT INTO HCO_SALDOS
(IDCUENTA, SALDO, FXSALDO)
SELECT IDCUENTA, SALDO, getdate()
FROM INSERTED
 
ROLLBACK
END
    En este caso obtendremos el siguiente mensaje de error:
La transacción terminó en el desencadenador. Se anuló el lote.
    Podemos activar y desactivar Triggers a tarvés de las siguientes instrucciones.
 
-- Desactiva el trigger TR_CUENTAS
DISABLE TRIGGER TR_CUENTAS ON CUENTAS

Ing. Williams A. Muñoz Robles 13

 UNDAC SBD II

GO
-- activa el trigger TR_CUENTAS
ENABLE TRIGGER TR_CUENTAS ON CUENTAS
GO
-- Desactiva todos los trigger de la tabla CUENTAS
ALTER TABLE CUENTAS DISABLE TRIGGER ALL
GO
-- Activa todos los trigger de la tabla CUENTAS
ALTER TABLE CUENTAS ENABLE TRIGGER ALL
 
Trigger DDL
    Los trigger DDL se ejecutan en respuesta a una variedad de eventos de lenguaje de
definición de datos (DDL). Estos eventos corresponden principalmente a instrucciones
CREATE, ALTER y DROP de Transact-SQL, y a determinados procedimientos
almacenados del sistema que ejecutan operaciones de tipo DDL.
    La sintaxis general de un trigger es la siguiente.

CREATE TRIGGER <trigger_name, sysname, table_alter_drop_safety>

ON DATABASE
FOR <data_definition_statements, , DROP_TABLE, ALTER_TABLE>
AS
BEGIN
...
END
    La siguiente instrucción impide que se ejecuten sentencias DROP TABLE y ALTER TABLE en la
base de datos. 

CREATE TRIGGER TR_SEGURIDAD

ON DATABASE FOR DROP_TABLE, ALTER_TABLE
AS
BEGIN
RAISERROR ('No está permitido borrar ni modificar tablas !' , 16, 1)
ROLLBACK TRANSACTION
END

Ing. Williams A. Muñoz Robles 14

 UNDAC SBD II

Cursores en Transact SQL

    Un cursor es una variable que nos permite recorrer con un conjunto de resultados obtenido a
través de una sentencia SELECT fila a fila.
    Cuando trabajemos con cursores debemos seguir los siguientes pasos.
 Declarar el cursor, utilizando DECLARE
 Abrir el cursor, utilizando OPEN
 Leer los datos del cursor, utilizando FETCH ... INTO
 Cerrar el cursor, utilizando CLOSE
 Liberar el cursor, utilizando DEALLOCATE
    La sintaxis general para trabajar con un cursor es la siguiente.

-- Declaración del cursor

DECLARE <nombre_cursor> CURSOR
FOR
<sentencia_sql>
 
-- apertura del cursor
OPEN <nombre_cursor>
 
-- Lectura de la primera fila del cursor
FETCH <nombre_cursor> INTO <lista_variables>
 
WHILE (@@FETCH_STATUS = 0)
BEGIN
-- Lectura de la siguiente fila de un cursor
FETCH <nombre_cursor> INTO <lista_variables>
...
END -- Fin del bucle WHILE
 
-- Cierra el cursor
CLOSE <nombre_cursor>
-- Libera los recursos del cursor
DEALLOCATE <nombre_cursor>

    El siguente ejemplo muestra el uso de un cursor. 

-- Declaracion de variables para el cursor

Ing. Williams A. Muñoz Robles 15

 UNDAC SBD II

DECLARE @Id int,

@Nombre varchar(255),
@Apellido1 varchar(255),
@Apellido2 varchar(255),
@NifCif varchar(20),
@FxNacimiento datetime

-- Declaración del cursor

DECLARE cClientes CURSOR FOR
SELECT Id, Nombre, Apellido1,
Apellido2, NifCif, FxNacimiento
FROM CLIENTES
-- Apertura del cursor
OPEN cClientes
-- Lectura de la primera fila del cursor
FETCH cClientes INTO @id, @Nombre, @Apellido1,
@Apellido2, @NifCif, @FxNacimiento
 
WHILE (@@FETCH_STATUS = 0 )
BEGIN
PRINT @Nombre + ' ' + @Apellido1 + ' ' + @Apellido2
-- Lectura de la siguiente fila del cursor
FETCH cClientes INTO @id, @Nombre, @Apellido1,
@Apellido2, @NifCif, @FxNacimiento
END
 
-- Cierre del cursor
CLOSE cClientes
-- Liberar los recursos
DEALLOCATE cClientes

    Cuando trabajamos con cursores, la funcion @@FETCH_STATUS nos indica el estado de la
última instrucción FETCH emitida, los valores posibles son:

Valor devuelto Descripción

0 La instrucción FETCH se ejecutó correctamente.
La instrucción FETCH no se ejecutó correctamente o la fila estaba más allá del
-1
conjunto de resultados.
-2 Falta la fila recuperada.

Ing. Williams A. Muñoz Robles 16

 UNDAC SBD II

    En la apertura del cursor, podemos especificar los siguientes parámetros:

DECLARE <nombre_cursor> CURSOR

[ LOCAL | GLOBAL ]
[ FORWARD_ONLY | SCROLL ]
[ STATIC | KEYSET | DYNAMIC | FAST_FORWARD ]
[ READ_ONLY | SCROLL_LOCKS | OPTIMISTIC ]
[ TYPE_WARNING ]
FOR <sentencia_sql>
    El primer conjunto de parámetros que podemos especificar es [ LOCAL | GLOBAL ]. A
continuación mostramos el significado de cada una de estas opciones.
 LOCAL

Especifica que el ámbito del cursor es local para el proceso por lotes, procedimiento almacenado o
desencadenador en que se creó el cursor.

DECLARE cClientes CURSOR LOCAL FOR

SELECT Id, Nombre, Apellido1,
Apellido2, NifCif, FxNacimiento
FROM CLIENTES
 GLOBAL

Especifica que el ámbito del cursor es global para la conexión. Puede hacerse referencia al nombre
del cursor en cualquier procedimiento almacenado o proceso por lotes que se ejecute en la
conexión.

DECLARE cClientes CURSOR GLOBAL FOR

SELECT Id, Nombre, Apellido1,
Apellido2, NifCif, FxNacimiento
FROM CLIENTES
    Si no se especifica GLOBAL ni LOCAL, el valor predeterminado se controla mediante la
configuración de la opción de base de datos default to local cursor.  
    El siguiente conjunto de parámetros que podemos especificar es [  FORWARD_ONLY | SCROLL 
]. A continuación mostramos el significado de cada una de estas opciones.
 FORWARD_ONLY

Especifica que el cursor sólo se puede desplazar de la primera a la última fila. FETCH NEXT es la
única opción de recuperación admitida. 
 
DECLARE cClientes CURSOR FORWARD_ONLY FOR

Ing. Williams A. Muñoz Robles 17

 UNDAC SBD II

SELECT Id, Nombre, Apellido1,

Apellido2, NifCif, FxNacimiento
FROM CLIENTES

 SCROLL

Especifica que están disponibles todas las opciones de recuperación (FIRST, LAST, PRIOR,
NEXT, RELATIVE, ABSOLUTE). Si no se especifica SCROLL en una instrucción DECLARE
CURSOR la única opción de recuperación que se admite es NEXT. No es posible especificar
SCROLL si se incluye también FAST_FORWARD.
Si se incluye la opción SCROLL, la forma en la realizamos la lectura del cursor varia, debiendo
utilizar la siguiente sintaxis: FETCH [ NEXT | PRIOR | FIRST | LAST | RELATIVE | ABSOLUTE
] FROM < INTO
 
-- Declaracion de variables para el cursor
DECLARE @Id int,
@Nombre varchar(255),
@Apellido1 varchar(255),
@Apellido2 varchar(255),
@NifCif varchar(20),
@FxNacimiento datetime
 
-- Declaración del cursor
DECLARE cClientes CURSOR SCROLL FOR
SELECT Id, Nombre, Apellido1,
Apellido2, NifCif, FxNacimiento
FROM CLIENTES
-- Apertura del cursor
OPEN cClientes
-- Lectura de la primera fila del cursor
FETCH NEXT FROM cClientes
INTO @id, @Nombre, @Apellido1, @Apellido2, @NifCif, @FxNacimiento
 
WHILE (@@FETCH_STATUS = 0 )
BEGIN
PRINT @Nombre + ' ' + @Apellido1 + ' ' + @Apellido2
-- Lectura de la siguiente fila del cursor
FETCH NEXT FROM cClientes

Ing. Williams A. Muñoz Robles 18

 UNDAC SBD II

INTO @id,@Nombre,@Apellido1,@Apellido2,@NifCif,@FxNacimiento
END
-- Lectura de la fila anterior
FETCH PRIOR FROM cClientes
INTO @id, @Nombre, @Apellido1, @Apellido2, @NifCif, @FxNacimiento
PRINT @Nombre + ' ' + @Apellido1 + ' ' + @Apellido2
-- Cierre del cursor
CLOSE cClientes
-- Liberar los recursos
DEALLOCATE cClientes
    El siguiente conjunto de parámetros que podemos especificar es [  STATIC | KEYSET |
DYNAMIC | FAST_FORWARD ]. A continuación mostramos el significado de cada una de estas
opciones.
 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 recuperación realizadas en el cursor y además este cursor no admite modificaciones.
 
DECLARE cClientes CURSOR STATIC FOR
SELECT Id, Nombre, Apellido1,
Apellido2, NifCif, FxNacimiento
FROM CLIENTES
 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.
 
DECLARE cClientes CURSOR KEYSET FOR
SELECT Id, Nombre, Apellido1,
Apellido2, NifCif, FxNacimiento
FROM CLIENTES
 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 operación de recuperación. La opción de recuperación ABSOLUTE no se
puede utilizar en los cursores dinámicos.

Ing. Williams A. Muñoz Robles 19

 UNDAC SBD II

 
DECLARE cClientes CURSOR DYNAMIC FOR
SELECT Id, Nombre, Apellido1,
Apellido2, NifCif, FxNacimiento
FROM CLIENTES
 FAST_FORWARD

Especifica un cursor FORWARD_ONLY, READ_ONLY con las optimizaciones de rendimiento

habilitadas. No se puede especificar FAST_FORWARD si se especifica también SCROLL o
FOR_UPDATE.
 
DECLARE cClientes CURSOR FAST_FORWARD FOR
SELECT Id, Nombre, Apellido1,
Apellido2, NifCif, FxNacimiento
FROM CLIENTES
    En SQL Server 2000, las opciones de cursor FAST_FORWARD y FORWARD_ONLY se excluyen
mutuamente. Si se especifican ambas, se genera un error. En SQL Server 2005, las dos palabras
clave se pueden utilizar en la misma instrucción DECLARE CURSOR.
    El siguiente conjunto de parámetros que podemos especificar es [  READ_ONLY |
SCROLL_LOCKS | OPTIMISTIC  ]. A continuación mostramos el significado de cada una de estas
opciones.
 READ_ONLY

Evita que se efectúen actualizaciones a través de este cursor. No es posible hacer referencia al
cursor en una cláusula WHERE CURRENT OF de una instrucción UPDATE o DELETE. Esta
opción reemplaza la capacidad de actualizar el cursor.
 
DECLARE cClientes CURSOR READ_ONLY FOR
SELECT Id, Nombre, Apellido1,
Apellido2, NifCif, FxNacimiento
FROM CLIENTES
 SCROLL_LOCKS

Especifica que se garantiza que las actualizaciones o eliminaciones posicionadas realizadas a través
del cursor serán correctas. Microsoft SQL Server bloquea las filas cuando se leen en el cursor para
garantizar que estarán disponibles para futuras modificaciones. No es posible especificar
SCROLL_LOCKS si se especifica también FAST_FORWARD o STATIC.
 
DECLARE cClientes CURSOR SCROLL_LOCKS FOR

Ing. Williams A. Muñoz Robles 20

 UNDAC SBD II

SELECT Id, Nombre, Apellido1,

Apellido2, NifCif, FxNacimiento
FROM CLIENTES
 OPTIMISTIC

Especifica que las actualizaciones o eliminaciones posicionadas realizadas a través del cursor no se
realizarán correctamente si la fila se ha actualizado después de ser leída en el cursor. SQL Server no
bloquea las filas al leerlas en el cursor. En su lugar, utiliza comparaciones de valores de columna
timestamp o un valor de suma de comprobación si la tabla no tiene columnas timestamp, para
determinar si la fila se ha modificado después de leerla en el cursor. Si la fila se ha modificado, el
intento de actualización o eliminación posicionada genera un error. No es posible especificar
OPTIMISTIC si se especifica también FAST_FORWARD.
 
DECLARE cClientes CURSOR OPTIMISTIC FOR
SELECT Id, Nombre, Apellido1,
Apellido2, NifCif, FxNacimiento
FROM CLIENTES
    Por último, queda la opción TYPE_WARNING
 TYPE_WARNING

Especifica que se envía un mensaje de advertencia al cliente si el cursor se convierte implícitamente

del tipo solicitado a otro.
 
DECLARE cClientes CURSOR TYPE_WARNING FOR
SELECT Id, Nombre, Apellido1,
Apellido2, NifCif, FxNacimiento
FROM CLIENTES
    Podemos especificar multiples parámetros en la apertura de cursor, pero unicamente
un parámetro de cada grupo. Por ejemplo:
 
DECLARE cClientes CURSOR LOCAL STATIC TYPE_WARNING FOR
SELECT Id, Nombre, Apellido1,
Apellido2, NifCif, FxNacimiento
FROM CLIENTES
    Para actualizar los datos de un cursor debemos especificar FOR UPDATE despues de la
sentencia SELECT en la declaración del cursor, y WHERE CURRENT OF <nombre_cursor> en
la sentencia UPDATE tal y como muestra el siguiente ejemplo.
-- Declaracion de variables para el cursor

Ing. Williams A. Muñoz Robles 21

 UNDAC SBD II

DECLARE @Id int,

@Nombre varchar(255),
@Apellido1 varchar(255),
@Apellido2 varchar(255),
@NifCif varchar(20),
@FxNacimiento datetime
-- Declaración del cursor
DECLARE cClientes CURSOR FOR
SELECT Id, Nombre, Apellido1,
Apellido2, NifCif, FxNacimiento
FROM CLIENTES
FOR UPDATE
 
-- Apertura del cursor
OPEN cClientes
-- Lectura de la primera fila del cursor
FETCH cClientes
INTO @id, @Nombre, @Apellido1, @Apellido2, @NifCif, @FxNacimiento

WHILE (@@FETCH_STATUS = 0 )
BEGIN
UPDATE Clientes
SET APELLIDO2 = isnull(@Apellido2,'') + ' - Modificado'
WHERE CURRENT OF cClientes
-- Lectura de la siguiente fila del cursor
FETCH cClientes
INTO @id, @Nombre, @Apellido1, @Apellido2,
@NifCif, @FxNacimiento
END
-- Cierre del cursor
CLOSE cClientes
-- Liberar los recursos
DEALLOCATE cClientes

Ing. Williams A. Muñoz Robles 22

 UNDAC SBD II

SQL dinámico en Transact SQL

    Transact SQL permite dos formas de ejecutar SQL dinamico(construir sentencias SQL
dinamicamente para ejecutarlas en la base de datos):
 La instrucción EXECUTE - o simplemente EXEC
 El procedimiento almacenado sp_executesql
    Desde aquí recomendamos la utilización de sp_executesql si bien vamos a mostrar la forma de
trabajar con ambos métodos.
La instrucción EXECUTE
    La instrucción EXECUTE - o simplemente EXEC - permite ejecutar una cadena de caracteres que
representa una sentencia SQL. La cadena de caracteres debe ser de tipo nvarchar .
    El siguiente ejemplo muestra como ejecutar una cadena de caracteres con la instrucción EXEC.
 
DECLARE @sql nvarchar(1000)
 
SET @sql = 'SELECT
COD_PAIS,
NOMBRE_PAIS,
ACTIVO,
FX_ALTA
FROM
PAISES'
EXEC (@sql)
    También con SQL dinamico podemos ejecutar sentencias de tipo DDL (Data Definition
Languaje), como CREATE TABLE.
 
DECLARE @sql nvarchar(1000)
SET @sql='CREATE TABLE TEMPORAL
( ID int IDENTITY, DATO varchar(100))'
EXEC (@sql)
 
SET @sql = 'SELECT * FROM TEMPORAL'
EXEC (@sql)
    El principal incoveniente de trabajar con la instrucción EXEC es que no permite el uso de
parametros abriendo la puerta a potenciales ataques de Sql Injections -
http://www.devjoker.com/contenidos/Articulos/45/Seguridad-en-Internet--SQL-Injections.aspx

    Además el uso de la instrucción EXEC es menos eficiente, en terminos de rendimiento, que
sp_executesql.

Ing. Williams A. Muñoz Robles 23

 UNDAC SBD II

    Para solventar el problema debemos trabajar siempre con sq_executesql, que permite el uso
de parametros y con el que obtendremos un mejor rendimiento de nuestras consultas.
El procedimiento almacenado sp_executesql
    Para ejecutar sql dinamico, se recomienda utilizar el procedimiento almacenado
sp_executesql, en lugar de una instrucción EXECUTE.
 sp_executesql admite la sustitución de parámetros
 sp_executesql es más seguro y versátil que EXECUTE
 sp_executesql genera planes de ejecución con más probabilidades de que SQL Server los
vuelva a utilizar, es más eficaz que EXECUTE.
    El siguiente ejemplo muestra el uso (muy simple) de sp_executesql.
 
DECLARE @sql nvarchar(1000)
 
SET @sql = 'SELECT
COD_PAIS,
NOMBRE_PAIS,
ACTIVO,
FX_ALTA
FROM
PAISES'
 
EXEC sp_executesql @sql
    sp_executesql admite la sustitución de valores de parámetros para cualquier parámetro
especificado en la cadena Transact-SQL a ejecutar.
    El siguiente ejemplo muestra el uso de sp_executesql con parámetros:
 
DECLARE @sql nvarchar(1000),
@paramDefinition nvarchar(255),
@paramValue char(3)
 
SET @paramDefinition = '@codPais char(3)'
SET @paramValue = 'ESP'
SET @sql = 'SELECT
COD_PAIS,
NOMBRE_PAIS,
ACTIVO,
FX_ALTA

Ing. Williams A. Muñoz Robles 24

 UNDAC SBD II

FROM
PAISES
WHERE COD_PAIS = @codPais'
 
EXEC sp_executesql @sql, @paramDefinition, @paramValue

Ing. Williams A. Muñoz Robles 25