SnowConvert AI - Oracle - CURSOR¶

설명¶

위험

이 섹션에서는 Oracle 명시적 커서 에 대한 변환 참조를 설명합니다. Oracle 커서 변수 의 경우 Snowflake Scripting에 해당하는 변수가 없습니다.

참고

출력 코드의 일부 부분은 명확성을 위해 생략되었습니다.

커서는 사용자가 쿼리 결과를 반복할 수 있는 포인터입니다. Oracle 커서에 대한 자세한 내용은 여기 를 참조하십시오.

Oracle 커서 구문¶

커서 정의

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

Copy

커서 열기

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

Copy

커서 가져오기

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

Copy

커서 닫기

CLOSE { cursor | cursor_variable | :host_cursor_variable } ;

Copy

커서 특성

named_cursor%{ ISOPEN | FOUND | NOTFOUND | ROWCOUNT }

Copy

커서 FOR 루프

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

Copy

Snowflake Scripting은 커서를 지원하지만 Oracle에 비해 함수가 적습니다. 이 커서에 대한 자세한 내용은 여기 에서 확인할 수 있습니다.

Snowflake Scripting 커서 구문¶

커서 선언

<cursor_name> CURSOR FOR <query>

Copy

커서 열기

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

Copy

커서 가져오기

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

Copy

커서 닫기

CLOSE <cursor_name> ;

Copy

커서 FOR 루프

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

Copy

샘플 소스 패턴¶

1. Basic cursor example¶

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

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¶

Oracle 명시적 Cursor For Loop의 예¶

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

Snowflake Scripting 명시적 Cursor For Loop의 예¶

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¶

Oracle 암시적 Cursor For Loop의 예¶

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

Snowflake Scripting 암시적 Cursor For Loop의 예¶

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¶

“?”를 사용할 수 있습니다. 선언 섹션의 커서 필터 조건에서 바인드 변수를 정의합니다. 커서를 열면서 “USING <bind_variable_1 >” 구문을 추가하여 바인드 변수를 전달할 수 있습니다.

다음은 커서에서 매개 변수를 사용할 때 발생할 수 있는 시나리오의 몇 가지 예입니다.

4.1 기본 커서 매개 변수화 예제¶

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

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개¶

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

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 개¶

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

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¶

커서는 FOR 문을 사용하여 제어할 수 있으며, 커서의 모든 레코드를 처리할 수 있고 FETCH 문은 커서에서 반환된 값을 레코드별로 변수 세트(PLSQL 레코드일 수 있음)에 넣습니다

5.1 루프를 위한 커서¶

Oracle Cursor For Loop의 예¶

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

Snowflake Cursor For Loop의 예¶

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 커서 가져오기¶

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

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

Known Issues¶

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

Snowflake Scripting에 대한 커서 선언에는 이 절이 포함되어 있지 않습니다. 기능적 동등성을 얻기 위해 Oracle 커서 정의에서 제거할 수 있습니다.

2. OPEN statement cannot pass values for declared arguments¶

커서에 인자를 선언할 수 있지만, 그 값은 Snowflake Scripting에서 할당할 수 없습니다. 가장 좋은 대안은 바인드 변수와 함께 USING 절을 사용하는 것입니다.

3. FETCH statement cannot use records¶

Snowflake Scripting은 레코드를 지원하지 않습니다. 그러나 OBJECT 데이터 타입 및 OBJECT_CONSTRUCT() 메서드를 사용하여 마이그레이션할 수 있습니다. 자세한 내용은 레코드 유형 정의 섹션을 참조하세요.

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

Snowflake Scripting은 BULK COLLECT INTO 절을 지원하지 않습니다. 그러나 ARRAY_AGG를 임시 테이블과 함께 사용하여 커서 정보에 해당하는 데이터로 새 변수를 구성할 수 있습니다. 자세한 내용은 컬렉션 대량 작업 섹션을 참조하세요.

5. Cursor attributes do not exist in Snowflake Scripting¶

Oracle 커서는 사용자가 커서가 열려 있는지 또는 가져온 행의 양과 같은 상태를 확인할 수 있는 다양한 특성이 있지만, 커서 상태와 관련된 이러한 특성은 Snowflake Scripting에는 존재하지 않습니다.

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

Oracle에서 커서 선언의 쿼리는 프로시저 변수 및 매개 변수에 액세스할 수 있지만, Snowflake Scripting에서는 액세스할 수 없습니다. 이에 대한 대안은 바인드 변수와 함께 USING 절을 사용하는 것입니다.

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

Oracle에서 사용할 수 있습니다. 열린 커서에서 첫 번째 가져오기 전에 cursor_name%NOTFOUND 는 마지막 가져오기가 행을 반환하지 못한 경우 TRUE 를 반환하고, 마지막 가져오기가 행을 반환한 경우 FALSE 를 반환합니다. 이 특성의 사용을 지원하지 않는 대신 커서 결과에 할당된 변수에 값이 포함되어 있는지 확인할 수 있습니다

CURSOR DECLARATION¶

참고

설명¶

이 섹션에서는 Oracle에서 커서 선언의 변환에 대해 설명합니다. 자세한 내용은 Oracle의 프로시저 및 커서 에 대한 다음 설명서를 검토하십시오.

샘플 소스 패턴¶

CURSOR DECLARATION¶

이 예제에서는 CURSOR 문이 삭제된 것을 확인할 수 있습니다. 이것은 Snowflake를 대상으로 하는 변환에서 관련 없는 구문입니다.

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

Known Issues¶

문제가 발견되지 않았습니다.

커서 변수¶

커서 변수 및 OPEN FOR 문에 대한 변환 참조

참고

출력 코드의 일부 부분은 명확성을 위해 생략되었습니다.

설명¶

커서 변수는 1개의 쿼리에만 제한되지 않는 명시적 커서와 같습니다.

(Oracle PL/SQL Language Reference 커서 변수 선언)

Oracle 구문¶

참조 커서 유형 정의

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

Copy

커서 변수 선언

cursor_variable type;

Copy

OPEN FOR 문

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

Copy

경고

Snowflake Scripting은 커서 변수 및 OPEN FOR 문과 직접적으로 동등하지는 않지만, 다른 해결 방법을 사용하여 에뮬레이션하여 기능적 동등성을 얻을 수 있습니다.

샘플 소스 패턴¶

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

Oracle 예¶

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 예¶

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 예¶

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의 예¶

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 예¶

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의 예¶

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 예¶

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의 예¶

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 예¶

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의 예¶

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

Known Issues¶

문제가 발견되지 않았습니다.

PARAMETRIZED CURSOR¶

매개 변수화된 커서는 Snowflake Scripting에서 지원되지 않습니다.

참고

출력 코드의 일부 부분은 명확성을 위해 생략되었습니다.

설명¶

Oracle은 선언된 커서에 대한 매개 변수를 지원합니다. 그러나 Snowflake Scripting은 이 기능을 지원하지 않으므로 선언 및 커서 사용이 불가능합니다.

코드 예시¶

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

권장 사항¶

커서에서 쿼리에 바인딩을 사용하고 USING 절로 커서를 열어 보십시오. 1개의 커서에서 여러 번 사용되는 매개 변수는 USING 절에서 변수를 여러 번 전달해야 할 수 있습니다.

Snowflake 쿼리¶

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

커서를 수동으로 변경하여 바인딩을 사용합니다.
추가 지원이 필요한 경우 snowconvert-support@snowflake.com으로 이메일을 보내주세요.

매개 변수 또는 프로시저 변수를 사용하는 커서에 대한 해결 방법¶

설명¶

이 섹션에서는 커서 쿼리 내에서 커서 매개 변수 및 프로시저 변수의 사용을 시뮬레이션하는 방법을 설명합니다. 변수 또는 매개 변수의 이름은 ? 기호를 사용하여 바인딩으로 바뀝니다. 그런 다음 커서가 열리면 USING 절과 함께 값을 전달해야 합니다.

참고

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

Copy

로컬 변수가 있는 커서¶

사용되는 변수 또는 프로시저 매개 변수에 대한 커서에서 쿼리에 대한 바인딩을 사용하고 USING 절로 커서를 엽니다.

Oracle 커서¶

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 커서¶

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

매개 변수가 있는 커서¶

사용되는 각 매개 변수에 대해 커서에서 쿼리에 대한 바인딩을 사용하고 USING 절로 커서를 엽니다. 1개의 커서에서 여러 번 사용되는 매개 변수는 USING 절에서 변수를 여러 번 전달해야 할 수 있습니다.

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 Scripting 커서¶

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

SnowConvert AI - Oracle - CURSOR¶

설명¶

Oracle 커서 구문¶

Snowflake Scripting 커서 구문¶

샘플 소스 패턴¶

1. Basic cursor example¶

Oracle 커서 예¶

Snowflake Scripting 커서 예¶

2. Explicit Cursor For Loop¶

Oracle 명시적 Cursor For Loop의 예¶

Snowflake Scripting 명시적 Cursor For Loop의 예¶

3. Implicit Cursor For Loop¶

Oracle 암시적 Cursor For Loop의 예¶

Snowflake Scripting 암시적 Cursor For Loop의 예¶

4. Parameterized Cursor¶

4.1 기본 커서 매개 변수화 예제¶

Oracle 매개 변수가 있는 커서의 예¶

Snowflake 매개 변수가 있는 커서의 예¶

4.여러 개의 전송 매개 변수가 있는 매개 변수화된 커서 2개¶

Oracle 매개 변수가 있는 커서의 예¶

Snowflake 매개 변수가 있는 커서의 예¶

4.쿼리에서 프로시저 매개 변수를 사용하는 매개 변수화된 커서 3 개¶

Oracle 매개 변수가 있는 커서의 예¶

Snowflake 매개 변수가 있는 커서의 예¶

5. Using Cursors In Fetch And For Loop¶

5.1 루프를 위한 커서¶

Oracle Cursor For Loop의 예¶

Snowflake Cursor For Loop의 예¶

5.2 커서 가져오기¶

Oracle 커서 가져오기 예¶

Snowflake 커서 가져오기 예¶

Known Issues¶

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

2. OPEN statement cannot pass values for declared arguments¶

3. FETCH statement cannot use records¶

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

5. Cursor attributes do not exist in Snowflake Scripting¶

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

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

관련 EWIs¶

CURSOR DECLARATION¶

설명¶

샘플 소스 패턴¶

CURSOR DECLARATION¶

Oracle¶

Snowflake¶

Known Issues¶

관련 EWIs¶

커서 변수¶

설명¶

Oracle 구문¶

샘플 소스 패턴¶

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

Oracle 예¶

Snowflake Scripting 예¶

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

Oracle 예¶

Snowflake Scripting의 예¶

3. OPEN FOR statement with SELECT statement¶

Oracle 예¶

Snowflake Scripting의 예¶

4. Cursor Variable declared with REF CURSOR type¶

Oracle 예¶

Snowflake Scripting의 예¶

5. OPEN FOR statement with USING clause¶

Oracle 예¶

Snowflake Scripting의 예¶

Known Issues¶

관련 EWIs¶

PARAMETRIZED CURSOR¶

설명¶

코드 예시¶

Oracle¶

Snowflake¶

권장 사항¶

Snowflake 쿼리¶

관련 EWIs¶

매개 변수 또는 프로시저 변수를 사용하는 커서에 대한 해결 방법¶

설명¶

로컬 변수가 있는 커서¶