sp_cursor (Transact-SQL)

Com exceção das combinações de SETPOSITION com UPDATE, DELETE, REFRESH ou LOCK; ou ABSOLUTE com UPDATE ou DELETE, os valores de optype são mutuamente exclusivos.

A cláusula SET do valor UPDATE é construída a partir do parâmetro value.

Uma vantagem de usar o valor de optype INSERT é que você pode evitar converter dados não caractere em formato de caractere para inserções. Os valores são especificados da mesma maneira como UPDATE. Se qualquer coluna obrigatório não for incluída, INSERT falhará.

O valor SETPOSITION não afeta o ponto de partida de qualquer operação de busca RELATIVE, NEXT ou PREVIOUS, nem as atualizações ou exclusões executadas com a interface sp_cursor. Qualquer número que não especificar uma linha no buffer de busca resultará na posição sendo definida como 1 sem erro sendo retornado. Quando SETPOSITION for executado, a posição permanecerá em vigor até a próxima operação sp_cursorfetch, Transact-SQL FETCH ou sp_cursor SETPOSITION através do mesmo cursor. Uma operação sp_cursorfetch subsequente definirá a posição do cursor como a primeira linha no novo buffer de busca, enquanto outras chamadas de cursor não afetarão o valor da posição. SETPOSITION pode ser vinculado por uma cláusula OR com REFRESH, UPDATE, DELETE ou LOCK para definir o valor da posição como a última linha modificada.

Se uma linha no buffer de busca não for especificada por meio do parâmetro rownum, a posição será definida como 1, sem erro sendo retornado. Uma vez que a posição seja definida, ela permanecerá em vigor até a próxima operação sp_cursorfetch, Transact-SQL FETCH ou sp_cursor SETPOSITION ser executada no mesmo cursor.

SETPOSITION pode ser vinculado por uma cláusula OR com REFRESH, UPDATE, DELETE ou LOCK para definir a posição do cursor como a última linha modificada.

Se especificado, o parâmetro rownum pode ser interpretado como o número de linha dentro do conjunto de chaves em vez do número de linha dentro do buffer de busca. O usuário é responsável para assegurar que o controle de simultaneidade seja mantido. Isso significa que, para cursores SCROLL_LOCKS, você deve manter um bloqueio de forma independente na linha determinada (isso pode ser feito por meio de uma transação). Para cursores OPTIMISTIC, você deve ter buscado previamente a linha para executar essa operação.

Se o valor de optype for UPDATE ou INSERT e uma instrução update ou insert completa for enviada como o parâmetro value, o valor especificado para table será ignorado.

Observação
Com relação a exibições, somente uma tabela participante da exibição pode ser modificada. Os nomes de coluna de parâmetro value devem refletir os nomes de coluna na exibição, mas o nome de tabela pode ser aquele da tabela base subjacente (caso em que sp_cursor substituirá o nome da exibição).

Há duas alternativas às regras para usar value conforme declarado anteriormente na seção Argumentos:

1. Você pode usar um nome que tenha '@' anexado ao início do nome da coluna na lista de seleção para qualquer parâmetro value nomeado. Uma vantagem dessa alternativa é que a conversão de dados pode não ser necessária.

2. Use um parâmetro para enviar uma instrução UPDATE ou INSERT completa ou usar vários parâmetros para enviar partes de uma instrução UPDATE ou INSERT que o SQL Server compilará em uma instrução completa. Exemplos assim podem ser encontrados na seção Exemplos, mais adiante neste tópico. 

Para UPDATE:

Quando um único parâmetro é usado, uma instrução UPDATE pode ser enviada com a seguinte sintaxe:

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

Observação
Se UPDATE <table name> for especificado, qualquer valor especificado para o parâmetro table será ignorado.

Quando são usados vários parâmetros, o primeiro deve ser uma cadeia de caracteres no seguinte formato:

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

e os parâmetros subsequentes devem estar neste formato:

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

Neste caso, o <table name> na instrução update construída é aquele especificado ou o usado como padrão pelo parâmetro table.

Para INSERT:

Quando um único parâmetro é usado, uma instrução INSERT pode ser enviada com a seguinte sintaxe:

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

Observação
Se INSERT <table name> for especificado, qualquer valor especificado para o parâmetro table será ignorado.

Quando são usados vários parâmetros, o primeiro deve ser uma cadeia de caracteres no seguinte formato:

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

e os parâmetros subsequentes devem estar neste formato:

expression [,...n]

exceto onde VALUES foi especificado, quando deverá haver um ")" à direita após a última expressão. Neste caso, o <table name> na instrução UPDATE construída é aquele especificado ou o usado como padrão pelo parâmetro table.

Observação
É possível enviar um parâmetro como um parâmetro nomeado, isto é, "@VALUES". Neste caso, nenhum outro parâmetro nomeado pode ser usado.