OPEN (Script Snowflake)¶

Abre um cursor.

Para obter mais informações sobre os cursores, consulte Como trabalhar com cursores.

Nota

Este constructo do Script Snowflake só é válido dentro de um bloco do Script Snowflake.

Consulte também:: DECLARE, FETCH, CLOSE

Sintaxe¶

OPEN <cursor_name> [ USING (bind_variable_1 [, bind_variable_2 ...] ) ] ;

Copy

Onde:

cursor_name
O nome do cursor.

bind_variable
Uma variável de vinculação detém um valor a ser usado na definição da consulta do cursor (por exemplo, em uma cláusula WHERE).

Um exemplo de vinculação está incluído nos exemplos mais adiante nesta seção.

Notas de uso¶

O conjunto de resultados de uma consulta pode ser pensado como um conjunto de linhas. Internamente, abrir um cursor executa a consulta, lê as linhas e posiciona um ponteiro interno na primeira das linhas.
Como em qualquer consulta SQL, se a definição da consulta não contiver um ORDERBY no nível mais externo, o conjunto de resultados não terá uma ordem definida. Quando o conjunto de resultados para o cursor é criado, sua ordem persiste até que o cursor seja fechado. No entanto, a nova instrução ou a reabertura do cursor pode produzir as linhas em uma ordem diferente.
Da mesma forma, se um cursor é fechado, e então a(s) tabela(s) subjacente(s) é(são) atualizada(s) antes de ser reaberta(s), o conjunto de resultados também pode mudar.

Exemplos¶

DECLARE
    c1 CURSOR FOR SELECT price FROM invoices;
BEGIN
    OPEN c1;
    ...

Copy

O seguinte mostra como vincular uma variável ao abrir um cursor:

DECLARE
    price_to_search_for FLOAT;
    price_count INTEGER;
    c2 CURSOR FOR SELECT COUNT(*) FROM invoices WHERE price = ?;
BEGIN
    price_to_search_for := 11.11;
    OPEN c2 USING (price_to_search_for);

Copy

Para um exemplo mais completo da utilização de um cursor, consulte o exemplo introdutório do cursor.