SnowConvert AI – Oracle – CURSOR¶

Beschreibung¶

Gefahr

Dieser Abschnitt behandelt die Übersetzungsreferenz für Oracle Expliziter Cursor. Für Oracle Cursorvariablen gibt es keine Entsprechung in Snowflake Scripting.

Bemerkung

Einige Teile des Ausgabecodes wurden aus Gründen der Übersichtlichkeit weggelassen.

Cursors sind Zeiger, mit denen Benutzer durch Abfrageergebnisse iterieren können. Weitere Informationen zu Oracle-Cursors finden Sie hier.

Cursor-Syntax von Oracle¶

Cursordefinition

CURSOR cursor
 [ ( cursor_parameter_dec [, cursor_parameter_dec ]... )]
   [ RETURN rowtype] IS select_statement ;

Copy

Cursor Open

OPEN cursor [ ( cursor_parameter [ [,] actual_cursor_parameter ]... ) ] ;

Copy

Cursor Fetch

FETCH { cursor | cursor_variable | :host_cursor_variable }
  { into_clause | bulk_collect_into_clause [ LIMIT numeric_expression ] } ;

Copy

Cursor Close

CLOSE { cursor | cursor_variable | :host_cursor_variable } ;

Copy

Cursorattribute

named_cursor%{ ISOPEN | FOUND | NOTFOUND | ROWCOUNT }

Copy

Cursor-FOR-Schleife

[ FOR record IN
  { cursor [ ( cursor_parameter_dec
               [ [,] cursor_parameter_dec ]... )]
  | ( select_statement )
  }
    LOOP statement... END LOOP [label] ;

Copy

Snowflake Scripting bietet Unterstützung für Cursors, hat aber im Vergleich zu Oracle weniger Funktionen. Weitere Informationen zu diesen Cursors finden Sie hier.

Cursor-Syntax von Snowflake Scripting¶

Cursordeklaration

<cursor_name> CURSOR FOR <query>

Copy

Cursor Open

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

Copy

Cursor Fetch

FETCH <cursor_name> INTO <variable> [, <variable> ... ] ;

Copy

Cursor Close

CLOSE <cursor_name> ;

Copy

Cursor-FOR-Schleife

FOR <row_variable> IN <cursor_name> DO
    statement;
    [ statement; ... ]
END FOR [ <label> ] ;

Copy

Beispielhafte Quellcode-Muster¶

1. Basic cursor example¶

Cursor-Beispiel von Oracle¶

CREATE OR REPLACE PROCEDURE basic_cursor_sample AS
    var1 VARCHAR(20);
    CURSOR cursor1 IS SELECT region_name FROM hr.regions ORDER BY region_name;
BEGIN
    OPEN cursor1;
    FETCH cursor1 INTO var1;
    CLOSE cursor1;
END;

Copy

Cursor-Beispiel von Snowflake Scripting¶

CREATE OR REPLACE PROCEDURE basic_cursor_sample ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
    DECLARE
        var1 VARCHAR(20);
        --** SSC-PRF-0009 - PERFORMANCE REVIEW - CURSOR USAGE **
        cursor1 CURSOR
        FOR
            SELECT region_name FROM
                hr.regions
            ORDER BY region_name;
    BEGIN
        OPEN cursor1;
        FETCH cursor1 INTO
            :var1;
    CLOSE cursor1;
    END;
$$;

Copy

2. Explicit Cursor For Loop¶

Beispiel für explizite Cursor-FOR-Schleife von Oracle¶

CREATE OR REPLACE PROCEDURE explicit_cursor_for_sample AS
    CURSOR cursor1 IS SELECT region_name FROM hr.regions ORDER BY region_name;
BEGIN
    FOR r1 IN cursor1 LOOP
        NULL;
    END LOOP;
END;

Copy

Beispiel für explizite Cursor-FOR-Schleife von Snowflake Scripting¶

CREATE OR REPLACE PROCEDURE explicit_cursor_for_sample ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
    DECLARE
        --** SSC-PRF-0009 - PERFORMANCE REVIEW - CURSOR USAGE **
        cursor1 CURSOR
        FOR
            SELECT region_name FROM
                hr.regions
            ORDER BY region_name;
    BEGIN
                OPEN cursor1;
                --** SSC-PRF-0004 - THIS STATEMENT HAS USAGES OF CURSOR FOR LOOP **
                FOR r1 IN cursor1 DO
            NULL;
                END FOR;
                CLOSE cursor1;
    END;
$$;

Copy

3. Implicit Cursor For Loop¶

Beispiel für implizite Cursor-FOR-Schleife von Oracle¶

CREATE OR REPLACE PROCEDURE implicit_cursor_for_sample AS
BEGIN
    FOR r1 IN (SELECT region_name FROM hr.regions ORDER BY region_name) LOOP
        NULL;
    END LOOP;
END;

Copy

Beispiel für implizite Cursor-FOR-Schleife von Snowflake Scripting¶

CREATE OR REPLACE PROCEDURE implicit_cursor_for_sample ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
    BEGIN
        LET temporary_for_cursor_0 CURSOR
        FOR
            (SELECT region_name FROM
                    hr.regions
                ORDER BY region_name);
        --** SSC-PRF-0004 - THIS STATEMENT HAS USAGES OF CURSOR FOR LOOP **
        FOR r1 IN temporary_for_cursor_0 DO
            NULL;
        END FOR;
    END;
$$;

Copy

4. Parameterized Cursor¶

Sie können „?“ verwenden. In der Filterbedingung des Cursors im Deklarationsabschnitt definieren Sie die Bindungsvariable. Beim Öffnen des Cursors können wir die zusätzliche Syntax „USING <bind_variable\_1 >“ hinzufügen, um die Bindungsvariable zu übergeben.

Im Folgenden finden Sie einige Beispiele für Szenarien, die bei der Verwendung von Parametern in Cursors auftreten können:

4.1 Grundlegendes Beispiel für einen parametrisierten Cursor¶

Beispiel für einen parametrisierten Cursor von Oracle¶

CREATE OR REPLACE PROCEDURE parameterized_cursor_for_sample AS
    CURSOR cursor1 (low number, high IN number) IS
        SELECT region_name FROM hr.regions WHERE region_id BETWEEN low AND high;
BEGIN
    OPEN cursor1(3,5);
    CLOSE cursor1;
END;

Copy

Beispiel für einen parametrisierten Cursor von Snowflake¶

CREATE OR REPLACE PROCEDURE parameterized_cursor_for_sample ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
    DECLARE
        --** SSC-PRF-0009 - PERFORMANCE REVIEW - CURSOR USAGE **
        cursor1 CURSOR
        FOR
            SELECT region_name FROM
                hr.regions
            WHERE region_id BETWEEN ? AND ?;
    BEGIN
                OPEN cursor1 USING (3, 5);
                CLOSE cursor1;
    END;
$$;

Copy

4.2 Parametrisierte Cursor mit mehreren Sendeparametern¶

Beispiel für einen parametrisierten Cursor von Oracle¶

CREATE OR REPLACE PROCEDURE parameterized_cursor_for_sample AS
    CURSOR cursor1 (low number DEFAULT 2, high IN number DEFAULT 7) IS
        SELECT region_name FROM hr.regions 
        WHERE region_id BETWEEN low AND high OR low < 0;
BEGIN
    OPEN cursor1(3,5);
    OPEN cursor1(3);
    OPEN cursor1;
    OPEN cursor1(high => 15, low => 5);
    OPEN cursor1(high => 15);
    CLOSE cursor1;
END;

Copy

Beispiel für einen parametrisierten Cursor von Snowflake¶

CREATE OR REPLACE PROCEDURE parameterized_cursor_for_sample ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
    DECLARE
        --** SSC-PRF-0009 - PERFORMANCE REVIEW - CURSOR USAGE **
        cursor1 CURSOR
        FOR
            SELECT region_name FROM
                hr.regions
            WHERE region_id BETWEEN ? AND ?
                OR ? < 0;
    BEGIN
                OPEN cursor1 USING (3, 5, 3);
                OPEN cursor1 USING (3, 7, 3);
                OPEN cursor1 USING (2, 7, 2);
                OPEN cursor1 USING (5, 15, 5);
                OPEN cursor1 USING (2, 15, 2);
                CLOSE cursor1;
    END;
$$;

Copy

4.3 Parametrisierte Cursor mit Verwendung von Prozedurparametern in Abfragen¶

Beispiel für einen parametrisierten Cursor von Oracle¶

CREATE OR REPLACE PROCEDURE parameterized_cursor_for_sample (high_param number) AS
    CURSOR cursor1 (low number DEFAULT 2) IS
        SELECT region_name FROM hr.regions 
        WHERE region_id BETWEEN low AND high_param;
BEGIN
    OPEN cursor1(3);
    CLOSE cursor1;
END;
CALL parameterized_cursor_for_sample(5);

Copy

Beispiel für einen parametrisierten Cursor von Snowflake¶

CREATE OR REPLACE PROCEDURE parameterized_cursor_for_sample (high_param NUMBER(38, 18))
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
    DECLARE
        --** SSC-PRF-0009 - PERFORMANCE REVIEW - CURSOR USAGE **
        cursor1 CURSOR
        FOR
            SELECT region_name FROM
                hr.regions
            WHERE region_id BETWEEN ? AND ?;
    BEGIN
                OPEN cursor1 USING (3, high_param);
                CLOSE cursor1;
    END;
$$;

CALL parameterized_cursor_for_sample(5);

Copy

5. Using Cursors In Fetch And For Loop¶

Cursor können mit der Anweisung FOR gesteuert werden, die es ermöglicht, jeden einzelnen Datensatz eines Cursors zu verarbeiten, während die Anweisung FETCH die vom Cursor zurückgegebenen Werte Datensatz für Datensatz in eine Reihe von Variablen schreibt, die PLSQL-Datensätze sein können

5.1 Cursors-FOR-Schleife¶

Beispiel für Cursor-FOR-Schleife von Oracle¶

CREATE OR REPLACE PROCEDURE p_cursors_for_loop AS
 datePlusOne TIMESTAMP;
 CURSOR c_product(low number, high number) IS 
    SELECT name, price, create_on FROM products WHERE price BETWEEN low AND high;
BEGIN
    FOR record_product IN c_product(3,5)
    LOOP
      datePlusOne := record_product.create_on + 1;
      INSERT INTO sold_items values(record_product.name, record_product.price, datePlusOne);
    END LOOP;
END;

Copy

Beispiel für Cursor-FOR-Schleife von Snowflake¶

CREATE OR REPLACE PROCEDURE p_cursors_for_loop ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
 DECLARE
  datePlusOne TIMESTAMP(6);
  --** SSC-PRF-0009 - PERFORMANCE REVIEW - CURSOR USAGE **
  c_product CURSOR
  FOR
     SELECT
      OBJECT_CONSTRUCT('NAME', name, 'PRICE', price, 'CREATE_ON', create_on) sc_cursor_record FROM
      products
     WHERE price BETWEEN ? AND ?;
 BEGIN
  OPEN c_product USING (3, 5);
  --** SSC-PRF-0004 - THIS STATEMENT HAS USAGES OF CURSOR FOR LOOP **
  FOR record_product IN c_product DO
     LET record_product OBJECT := record_product.sc_cursor_record;
     datePlusOne :=
                    !!!RESOLVE EWI!!! /*** SSC-EWI-OR0036 - TYPES RESOLUTION ISSUES, ARITHMETIC OPERATION '+' MAY NOT BEHAVE CORRECTLY BETWEEN unknown AND Number ***/!!!
                    record_product.CREATE_ON + 1;
                    INSERT INTO sold_items
                    SELECT
      :record_product:NAME,
      :record_product:PRICE,
      :datePlusOne;
  END FOR;
  CLOSE c_product;
 END;
$$;

Copy

5.2 Cursors Fetch¶

Beispiel für Cursor Fetch von Oracle¶

CREATE OR REPLACE PROCEDURE p_cursors_fetch AS
record_product products%rowtype;
 CURSOR c_product(low number, high number) IS 
    SELECT * FROM products WHERE price BETWEEN low AND high;
BEGIN
    OPEN c_product(3,5);
    LOOP
        FETCH c_product INTO record_product;
        EXIT WHEN c_product%notfound;
        INSERT INTO sold_items VALUES (record_product.name, record_product.price);
        INSERT INTO sold_items VALUES record_product;
    END LOOP;
    CLOSE c_product;
END;

Copy

Beispiel für Cursor Fetch von Snowflake¶

CREATE OR REPLACE PROCEDURE p_cursors_fetch ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "oracle",  "convertedOn": "07/14/2025",  "domain": "no-domain-provided" }}'
EXECUTE AS CALLER
AS
$$
 DECLARE
  record_product OBJECT !!!RESOLVE EWI!!! /*** SSC-EWI-0036 - ROWTYPE DATA TYPE CONVERTED TO OBJECT ***/!!! := OBJECT_CONSTRUCT();
  --** SSC-PRF-0009 - PERFORMANCE REVIEW - CURSOR USAGE **
  c_product CURSOR
  FOR
     SELECT
      OBJECT_CONSTRUCT( *) sc_cursor_record FROM
      products
     WHERE price BETWEEN ? AND ?;
 BEGIN
  OPEN c_product USING (3, 5);
  --** SSC-PRF-0008 - PERFORMANCE REVIEW - LOOP USAGE **
  LOOP
     --** SSC-PRF-0003 - FETCH INSIDE A LOOP IS CONSIDERED A COMPLEX PATTERN, THIS COULD DEGRADE SNOWFLAKE PERFORMANCE. **
      FETCH c_product INTO
      :record_product;
      IF (record_product IS NULL) THEN
      EXIT;
      END IF;
      INSERT INTO sold_items
      SELECT
      :record_product:NAME,
      :record_product:PRICE;
      INSERT INTO sold_items
      SELECT
      null !!!RESOLVE EWI!!! /*** SSC-EWI-OR0002 - COLUMNS FROM EXPRESSION products%rowtype NOT FOUND ***/!!!;
  END LOOP;
    CLOSE c_product;
 END;
$$;

Copy

Bekannte Probleme¶

1. RETURN clause is not supported in Snowflake Scripting Cursor Declaration¶

Die Cursordeklaration für Snowflake Scripting enthält diese Klausel nicht. Er kann aus der Oracle Cursordefinition entfernt werden, um eine Funktionsäquivalenz zu erhalten.

2. OPEN statement cannot pass values for declared arguments¶

Auch wenn Argumente für einen Cursor deklariert werden können, können ihre Werte in Snowflake Scripting nicht zugewiesen werden. Die beste Alternative ist die Verwendung der USING-Klausel mit Bindungsvariablen.

3. FETCH statement cannot use records¶

Snowflake Scripting unterstützt keine Datensätze. Es ist jedoch möglich, sie mithilfe des OBJECT-Datentyps und der OBJECT_CONSTRUCT()-Methode zu migrieren. Weitere Informationen finden Sie im Abschnitt zur Definition eines Datensatztyps.

4. FETCH BULK COLLECT INTO clause is not supported in Snowflake Scripting¶

Snowflake Scripting bietet keine Unterstützung der BULK COLLECT INTO-Klausel. Es ist jedoch möglich, ARRAY_AGG zusammen mit einer temporären Tabelle zu verwenden, um eine neue Variable mit den Daten zu erstellen, die den Cursor-Informationen entsprechen. Weitere Informationen finden Sie im Abschnitt zu Massenoperationen der Sammlung.

5. Cursor attributes do not exist in Snowflake Scripting¶

Oracle-Cursor haben verschiedene Attribute, mit denen der Benutzer ihren Status überprüfen kann, z. B. ob sie geöffnet sind oder wie viele Zeilen abgerufen wurden. Diese Attribute zum Cursorstatus gibt es in Snowflake Scripting jedoch nicht.

6. The cursor’s query does not have access to the procedure’s variables and parameters¶

In Oracle hat die Abfrage in der Cursordeklaration Zugriff auf Prozedurvariablen und -parameter, in Snowflake Scripting jedoch nicht. Die Alternative dazu ist die Verwendung der USING-Klausel mit Bindungsvariablen.

7. %NOTFOUND attribute is not supported in Snowflake Scripting Cursor¶

In Oracle kann vor dem ersten Abruf von einem geöffneten Cursor cursor_name%NOTFOUND verwendet werden, das TRUE zurückgibt, wenn der letzte Abruf keine Zeile geliefert hat, oder FALSE, wenn der letzte Abruf eine Zeile geliefert hat. Snowflake Scripting unterstützt die Verwendung dieses Attributs nicht. Stattdessen kann es validiert werden, wenn die dem Cursorergebnis zugewiesene Variable Werte enthält

CURSOR DECLARATION¶

Bemerkung

Nicht relevante Anweisung.

Warnung

Beachten Sie, dass diese Anweisung aus der Migration entfernt wurde, da es sich um eine nicht relevante Syntax handelt. Das bedeutet, dass sie in Snowflake nicht erforderlich ist.

Bemerkung

Einige Teile des Ausgabecodes wurden aus Gründen der Übersichtlichkeit weggelassen.

Beschreibung¶

Dieser Abschnitt erklärt die Übersetzung der Cursordeklaration in Oracle. Weitere Informationen finden Sie in der folgenden Dokumentation zu Prozeduren und Cursors in Oracle.

Beispielhafte Quellcode-Muster¶

CURSOR DECLARATION¶

Beachten Sie, dass in diesem Beispiel die Anweisung CURSOR gelöscht wurde. Dies ist eine nicht relevante Syntax in der auf Snowflake ausgerichteten Transformation.

Oracle¶

CREATE PROCEDURE PROC_COLLECTIONS
AS
CURSOR C2 RETURN T1%TYPE;
BEGIN
    NULL;
END

Copy

Snowflake¶

CREATE OR REPLACE PROCEDURE PROC_COLLECTIONS ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
    BEGIN
        NULL;
    END;
$$;

Copy

Bekannte Probleme¶

Es wurden keine Probleme gefunden.

Zugehörige EWIs¶

Keine zugehörigen EWIs.

Cursorvariablen¶

Übersetzungsreferenz für Cursorvariablen und die OPEN FOR-Anweisung

Bemerkung

Einige Teile des Ausgabecodes wurden aus Gründen der Übersichtlichkeit weggelassen.

Beschreibung¶

Eine Cursor-Variable ist wie ein expliziter Cursor, der nicht auf eine Abfrage beschränkt ist.

(Oracle PL/SQL Language Reference Cursor-Variable Declaration)

Oracle-Syntax¶

Definition des Typs des Referenz-Cursors

TYPE type IS REF CURSOR
  [ RETURN
    { {db_table_or_view | cursor | cursor_variable}%ROWTYPE
    | record%TYPE
    | record_type
    | ref_cursor_type
    }
  ] ;

Copy

Deklaration der Cursorvariablen

cursor_variable type;

Copy

OPENFOR-Anweisung

OPEN { cursor_variable | :host_cursor_variable}
  FOR select_statement [ using_clause ] ;

Copy

Warnung

Snowflake Scripting hat keine direkte Entsprechung zu Cursor-Variablen und der Anweisung OPEN FOR. Sie können jedoch mit verschiedenen Umgehungsmöglichkeiten emuliert werden, um eine funktionale Entsprechung zu erhalten.

Beispielhafte Quellcode-Muster¶

1. OPEN FOR statement with dynamic SQL inside a VARCHAR variable¶

Oracle-Beispiel¶

CREATE OR REPLACE PROCEDURE procedure1
AS
	query1 VARCHAR(200) := 'SELECT 123 FROM dual';
	cursor_var SYS_REFCURSOR;
BEGIN 
	OPEN cursor_var FOR query1;
	CLOSE cursor_var;
END;

Copy

Snowflake Scripting-Beispiel¶

CREATE OR REPLACE PROCEDURE procedure1 ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
	DECLARE
		query1 VARCHAR(200) := 'SELECT 123 FROM dual';
		cursor_var_res RESULTSET;
	BEGIN
		!!!RESOLVE EWI!!! /*** SSC-EWI-0030 - THE STATEMENT BELOW HAS USAGES OF DYNAMIC SQL. ***/!!!
		cursor_var_res := (
			EXECUTE IMMEDIATE :query1
		);
		LET cursor_var CURSOR
		FOR
			cursor_var_res;
		OPEN cursor_var;
		CLOSE cursor_var;
	END;
$$;

Copy

2. OPEN FOR statement with dynamic SQL inside a string literal.¶

Oracle-Beispiel¶

CREATE OR REPLACE PROCEDURE procedure2
AS
    cursor_var SYS_REFCURSOR;
BEGIN
    OPEN cursor_var FOR 'SELECT 123 FROM dual';
    CLOSE cursor_var;
END;

Copy

Snowflake Scripting-Beispiel¶

CREATE OR REPLACE PROCEDURE procedure2 ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
    DECLARE
        cursor_var_res RESULTSET;
    BEGIN
        !!!RESOLVE EWI!!! /*** SSC-EWI-0030 - THE STATEMENT BELOW HAS USAGES OF DYNAMIC SQL. ***/!!!
        cursor_var_res := (
            EXECUTE IMMEDIATE 'SELECT 123 FROM dual'
        );
        LET cursor_var CURSOR
        FOR
            cursor_var_res;
        OPEN cursor_var;
        CLOSE cursor_var;
    END;
$$;

Copy

3. OPEN FOR statement with SELECT statement¶

Oracle-Beispiel¶

CREATE OR REPLACE PROCEDURE procedure3
AS
	cursor_var SYS_REFCURSOR;
BEGIN
	OPEN cursor_var FOR SELECT 123 FROM dual;
	CLOSE cursor_var;
END;

Copy

Snowflake Scripting-Beispiel¶

CREATE OR REPLACE PROCEDURE procedure3 ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
	DECLARE
		cursor_var_res RESULTSET;
	BEGIN
		LET cursor_var CURSOR
		FOR
			SELECT 123 FROM dual;
		OPEN cursor_var;
		CLOSE cursor_var;
	END;
$$;

Copy

4. Cursor Variable declared with REF CURSOR type¶

Oracle-Beispiel¶

CREATE OR REPLACE PROCEDURE procedure4
AS
    TYPE cursor_ref_type1 IS REF CURSOR;
    query1 VARCHAR(200) := 'SELECT 123 FROM dual';
    cursor_var cursor_ref_type1;
BEGIN 
    OPEN cursor_var FOR query1;
    CLOSE cursor_var;
END;

Copy

Snowflake Scripting-Beispiel¶

CREATE OR REPLACE PROCEDURE procedure4 ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
    DECLARE
--        !!!RESOLVE EWI!!! /*** SSC-EWI-0058 - FUNCTIONALITY FOR 'PL REF CURSOR TYPE DEFINITION' IS NOT CURRENTLY SUPPORTED BY SNOWFLAKE SCRIPTING ***/!!!
--        TYPE cursor_ref_type1 IS REF CURSOR;
        query1 VARCHAR(200) := 'SELECT 123 FROM dual';
        cursor_var_res RESULTSET;
    BEGIN
        !!!RESOLVE EWI!!! /*** SSC-EWI-0030 - THE STATEMENT BELOW HAS USAGES OF DYNAMIC SQL. ***/!!!
        cursor_var_res := (
            EXECUTE IMMEDIATE :query1
        );
        LET cursor_var CURSOR
        FOR
            cursor_var_res;
        OPEN cursor_var;
        CLOSE cursor_var;
    END;
$$;

Copy

5. OPEN FOR statement with USING clause¶

Oracle-Beispiel¶

CREATE OR REPLACE PROCEDURE procedure5
AS
    query1 VARCHAR(200) := 'SELECT col1 FROM cursortable1 WHERE col1 = :a';
    column_filter INTEGER := 1;
    cursor_var SYS_REFCURSOR;
BEGIN 
    OPEN cursor_var FOR query1 USING column_filter;
    CLOSE cursor_var;
END;

Copy

Snowflake Scripting-Beispiel¶

CREATE OR REPLACE PROCEDURE procedure5 ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
    DECLARE
        query1 VARCHAR(200) := 'SELECT col1 FROM
   cursortable1
WHERE col1 = ?';
        column_filter INTEGER := 1;
        cursor_var_res RESULTSET;
    BEGIN
        !!!RESOLVE EWI!!! /*** SSC-EWI-0030 - THE STATEMENT BELOW HAS USAGES OF DYNAMIC SQL. ***/!!!
        cursor_var_res := (
            EXECUTE IMMEDIATE :query1 USING ( column_filter)
        );
        LET cursor_var CURSOR
        FOR
            cursor_var_res;
        OPEN cursor_var;
        CLOSE cursor_var;
    END;
$$;

Copy

Bekannte Probleme¶

Es wurden keine Probleme gefunden.

Zugehörige EWIs¶

SSC-EWI-0030: Die folgende Anweisung enthält Verwendungen von dynamischem SQL.
SSC-EWI-0058: Die Funktionalität wird derzeit nicht von Snowflake Scripting unterstützt.

PARAMETRIZED CURSOR¶

Der parametrisierte Cursor wird von Snowflake Scripting nicht unterstützt.

Bemerkung

Einige Teile des Ausgabecodes wurden aus Gründen der Übersichtlichkeit weggelassen.

Beschreibung¶

Oracle unterstützt Parameter für Cursor, die deklariert werden. Snowflake Scripting unterstützt dieses Feature jedoch nicht, so dass die Deklaration und die Verwendung des Cursors nicht möglich sind.

Beispielcode¶

Oracle¶

CREATE OR REPLACE PROCEDURE parametrized_cursor_sample AS
    CURSOR cursor1(param1 number) IS SELECT region_name FROM hr.regions where region_id = param1 ORDER BY region_name;
    var1 integer;
BEGIN
    OPEN cursor1(123);
    FETCH cursor1 INTO var1;
    CLOSE cursor1;
    FOR r1 IN cursor1(456) LOOP
        NULL;
    END LOOP;
END;

Copy

Snowflake¶

CREATE OR REPLACE PROCEDURE parametrized_cursor_sample ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "oracle",  "convertedOn": "07/14/2025",  "domain": "no-domain-provided" }}'
EXECUTE AS CALLER
AS
$$
    DECLARE
        --** SSC-PRF-0009 - PERFORMANCE REVIEW - CURSOR USAGE **
        cursor1 CURSOR
        FOR
            SELECT
                OBJECT_CONSTRUCT('REGION_NAME', region_name) sc_cursor_record FROM
                hr.regions
            where region_id = ?
            ORDER BY region_name;
                var1 integer;
    BEGIN
                OPEN cursor1 USING (123);
                FETCH cursor1 INTO
            :var1;
    CLOSE cursor1;
                OPEN cursor1 USING (456);
                --** SSC-PRF-0004 - THIS STATEMENT HAS USAGES OF CURSOR FOR LOOP **
                FOR r1 IN cursor1 DO
            LET r1 OBJECT := r1.sc_cursor_record;
                   NULL;
                END FOR;
                CLOSE cursor1;
    END;
$$;

Copy

Empfehlungen¶

Versuchen Sie, Bindungen für die Abfrage im Cursor zu verwenden, und öffnen Sie den Cursor mit der Klausel USING. Denken Sie daran, dass ein Parameter, der mehrfach in einem einzigen Cursor verwendet wird, möglicherweise die mehrfache Übergabe der Variable in der USING-Klausel erfordert.

Snowflake-Abfrage¶

CREATE OR REPLACE PROCEDURE PUBLIC.parametrized_cursor_sample_fixed ()
RETURNS VARCHAR
LANGUAGE SQL
EXECUTE AS CALLER
AS
$$
   DECLARE
      var1 STRING;
      cursor1 CURSOR FOR SELECT region_name FROM hr.regions where region_id = ? ORDER BY region_name;
   BEGIN
      NULL;
      OPEN cursor1 USING (1);
      FETCH cursor1 INTO var1;
      CLOSE cursor1;
      OPEN cursor1 USING (2);
      FOR r1 IN cursor1 DO
         NULL;
      END FOR;
      CLOSE cursor1;
   END;
$$;

Copy

Ändern Sie den Cursor manuell, um Bindungen zu verwenden.
Wenn Sie weitere Unterstützung benötigen, können Sie uns eine E-Mail an snowconvert-support@snowflake.com senden.

Zugehörige EWIs¶

SSC-PRF-0004: Diese Anweisung hat Verwendungen für Cursor-FOR-Schleife.

Umgehungsmöglichkeit für Cursor, die Parameter oder Prozedurvariablen verwenden¶

Beschreibung¶

Dieser Abschnitt beschreibt, wie Sie die Verwendung von Cursor-Parametern und Prozedurvariablen innerhalb der Abfrage eines Cursors simulieren können. Der Name der Variablen oder Parameter wird durch Bindungen mit dem Zeichen ? ersetzt. Wenn der Cursor dann geöffnet wird, sollten die Werte mit der USING-Klausel übergeben werden.

Bemerkung

Some parts in the output code are omitted for clarity reasons.

Copy

Cursor mit lokalen Variablen¶

Verwenden Sie Bindungen für die Abfrage im Cursor für verwendete Variablen- oder Prozedurparameter und öffnen Sie den Cursor mit der USING-Klausel.

Oracle-Cursor¶

CREATE OR REPLACE PROCEDURE oracle_cursor_sample
AS
    like_value VARCHAR(255); 
    CURSOR c1 IS SELECT region_name FROM hr.regions WHERE region_name LIKE like_value ORDER BY region_name;  
    r_name VARCHAR(255);
BEGIN
    like_value := 'E%';
    OPEN c1;
    FETCH c1 INTO r_name;
    CLOSE c1;
    like_value := 'A%';
    FOR r1 IN c1 LOOP
        NULL;
    END LOOP;
END;

Copy

Snowflake Scripting-Cursor¶

CREATE OR REPLACE PROCEDURE oracle_cursor_sample ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "oracle",  "convertedOn": "07/14/2025",  "domain": "no-domain-provided" }}'
EXECUTE AS CALLER
AS
$$
    DECLARE
        like_value VARCHAR(255);
        --** SSC-PRF-0009 - PERFORMANCE REVIEW - CURSOR USAGE **
        c1 CURSOR
        FOR
            SELECT region_name FROM
                hr.regions
            WHERE region_name LIKE ?
            ORDER BY region_name;
        r_name VARCHAR(255);
    BEGIN
        like_value := 'E%';
        OPEN c1 USING (like_value);
        FETCH c1 INTO
            :r_name;
    CLOSE c1;
        like_value := 'A%';
        OPEN c1;
        --** SSC-PRF-0004 - THIS STATEMENT HAS USAGES OF CURSOR FOR LOOP **
        FOR r1 IN c1 DO
            NULL;
        END FOR;
        CLOSE c1;
    END;
$$;

Copy

Cursor mit Parametern¶

Verwenden Sie Bindungen für die Abfrage im Cursor für jeden verwendeten Parameter und öffnen Sie den Cursor mit der USING-Klausel. Denken Sie daran, dass ein Parameter, der mehrfach in einem einzigen Cursor verwendet wird, möglicherweise die mehrfache Übergabe der Variable in der USING-Klausel erfordert.

Oracle-Cursor¶

CREATE OR REPLACE PROCEDURE parametrized_cursor_sample AS
    CURSOR cursor1(param1 number) IS SELECT region_name FROM hr.regions where region_id = param1 ORDER BY region_name;
    var1 integer;
BEGIN
    OPEN cursor1(123);
    FETCH cursor1 INTO var1;
    CLOSE cursor1;
    FOR r1 IN cursor1(456) LOOP
        NULL;
    END LOOP;
END;

Copy

Snowflake Scripting-Cursor¶

CREATE OR REPLACE PROCEDURE parametrized_cursor_sample ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
    DECLARE
        --** SSC-PRF-0009 - PERFORMANCE REVIEW - CURSOR USAGE **
        cursor1 CURSOR
        FOR
            SELECT
                OBJECT_CONSTRUCT('REGION_NAME', region_name) sc_cursor_record FROM
                hr.regions
            where region_id = ?
            ORDER BY region_name;
                var1 integer;
    BEGIN
                OPEN cursor1 USING (123);
                FETCH cursor1 INTO
            :var1;
    CLOSE cursor1;
                OPEN cursor1 USING (456);
                --** SSC-PRF-0004 - THIS STATEMENT HAS USAGES OF CURSOR FOR LOOP **
                FOR r1 IN cursor1 DO
            LET r1 OBJECT := r1.sc_cursor_record;
                   NULL;
                END FOR;
                CLOSE cursor1;
    END;
$$;

Copy

Zugehörige EWIs¶

SSC-PRF-0004: Diese Anweisung hat Verwendungen für Cursor-FOR-Schleife.