MOVE

MOVE — posiciona o cursor

Sinopse

MOVE [ direção ] [ FROM | IN ] nome_do_cursor

onde direção pode ser uma entre:

    NEXT
    PRIOR
    FIRST
    LAST
    ABSOLUTE contador
    RELATIVE contador
    contador
    ALL
    FORWARD
    FORWARD contador
    FORWARD ALL
    BACKWARD
    BACKWARD contador
    BACKWARD ALL

Descrição

O comando MOVE reposiciona o cursor sem recuperar nenhum dado. O comando MOVE funciona exatamente como o comando FETCH, exceto que apenas posiciona o cursor, sem retornar linhas.

Os parâmetros do comando MOVE são idênticos aos do comando FETCH; veja o comando FETCH para obter detalhes sobre a sintaxe e uso.

Saídas

Após a conclusão bem-sucedida, o comando MOVE retorna uma etiqueta de comando no formato

MOVE contador

O contador é o número de linhas que o comando FETCH com os mesmos parâmetros teria retornado (possivelmente zero).

Exemplo

BEGIN WORK;
DECLARE liahona CURSOR FOR SELECT * FROM films;

-- Saltar as 5 primeiras linhas:
MOVE FORWARD 5 IN liahona;
MOVE 5

-- Recuperar a 6ª linha do cursor liahona:
FETCH 1 FROM liahona;
 code  | title  | did | date_prod  |  kind  |  len
-------+--------+-----+------------+--------+-------
 P_303 | 48 Hrs | 103 | 1982-10-22 | Action | 01:37
(1 linha)

-- Fechar o cursor liahona e finalizar a transação:
CLOSE liahona;
COMMIT WORK;

Conformidade

Não existe o comando MOVE no padrão SQL.

Veja também

CLOSE, DECLARE, FETCH