sp_cursor (Transact-SQL)

Con la excepción de las combinaciones de SETPOSITION con UPDATE, DELETE, REFRESH o LOCK; o ABSOLUTE con UPDATE o DELETE, los valores de optype son mutuamente excluyentes.

La cláusula SET del valor UPDATE se construye a partir del parámetro value.

Una ventaja del uso del valor optype de INSERT es que se puede evitar la conversión de los datos que no son caracteres en el formato de carácter para las inserciones. Los valores se especifican de la misma manera que para UPDATE. Si alguna columna necesaria no está incluida, se produce un error en INSERT.

El valor SETPOSITION no afecta al punto inicial de ninguna operación de captura RELATIVE, NEXT o PREVIOUS, ni hace ninguna actualización ni eliminación que se efectúe con la interfaz sp_cursor. Cualquier número que no especifique una fila en el búfer de captura hará que la posición se establezca en 1 y no se devuelva ningún error. Una vez ejecutada la operación SETPOSITION, la posición permanece en vigor hasta la siguiente operación sp_cursorfetch, FETCH de Transact-SQL o sp_cursor SETPOSITION a través del mismo cursor. La siguiente operación sp_cursorfetch establecerá la posición del cursor en la primera fila del nuevo búfer de captura, mientras que otras llamadas del cursor no afectarán al valor de la posición. Una cláusula OR con REFRESH, UPDATE, DELETE o LOCK puede vincular SETPOSITION para establecer el valor de la posición en la última fila modificada.

Si una fila del búfer de captura no se especifica a través del parámetro rownum, la posición se establecerá en 1 y no se devolverá ningún error. Una vez establecida la posición, permanece en vigor hasta que se realice la siguiente operación sp_cursorfetch, FETCH de Transact-SQL o sp_cursor SETPOSITION en el mismo cursor.

SETPOSITION puede vincularse con cualquier cláusula REFRESH, UPDATE, DELETE o LOCK para establecer la posición del cursor en la última fila modificada.

Si se especifica, el parámetro rownum se puede interpretar como el número de fila dentro del conjunto de claves en lugar del número de fila dentro del búfer de captura. El usuario es responsable de asegurarse de que el control de simultaneidad se mantenga. Esto significa que para los cursores SCROLL_LOCKS, debe mantener independientemente un bloqueo en la fila dada (esto se puede hacer a través de una transacción). En el caso de los cursores optimistas, debe haber capturado previamente la fila para realizar esta operación.

Si el valor de optype es UPDATE o INSERT y se envía una actualización completa o una inserción como parámetro value, se omite el valor especificado para table.

Hay dos alternativas a las reglas para usar el parámetro value como se indicaba anteriormente en la sección Argumentos:

1. Puede utilizar un nombre que tenga anexado '@' al principio del nombre de la columna en la lista de selección para cualquier parámetro value con nombre. Una ventaja de esta alternativa es que la conversión de datos puede no ser necesaria.

2. Utilice un parámetro para enviar una instrucción INSERT o UPDATE completa, o varios parámetros para enviar partes de una instrucción INSERT o UPDATE que SQL Server integrará a continuación en una instrucción completa. Puede encontrar ejemplos de esto en la sección Ejemplos, posteriormente en este tema. 

Para UPDATE:

Cuando se utiliza un solo parámetro, se puede enviar una instrucción UPDATE con la siguiente sintaxis:

[ [ UPDATE <table name> ] SET ] {<column name> = expression} [,…n]

Cuando se utilizan varios parámetros, el primero debe ser una cadena con el siguiente formato:

[ SET ] <column name> = expression [,...n]

y los parámetros subsiguientes deben estar en el formato:

<column name> = expression [,...n]

En este caso, el <nombre de tabla> en la instrucción de actualización construida es el especificado por el parámetro table o su valor predeterminado.

Para INSERT:

Cuando se utiliza un solo parámetro, se puede enviar una instrucción INSERT con la siguiente sintaxis:

[ [ INSERT [INTO] <table name> ] VALUES ] ( <expression> [,...n] )

Cuando se utilizan varios parámetros, el primero debe ser una cadena con el siguiente formato:

[ VALUES ( ] <expression> [,...n]

y los parámetros subsiguientes deben estar en el formato:

expression [,...n]

excepto cuando se especificó VALUES, en cuyo caso debe haber un carácter ")" final después de la última expresión. En este caso, el <nombre de tabla> en la instrucción UPDATE construida es el especificado por el parámetro table o su valor predeterminado.