FOR （Snowflakeスクリプト）¶

構文¶

カーソル のすべての行をループするには、次を使用します。

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

Copy

指定された回数をループするには、次を使用します。

FOR <counter_variable> IN [ REVERSE ] <start> TO <end> { DO | LOOP }
    statement;
    [ statement; ... ]
END { FOR | LOOP } [ <label> ] ;

Copy

条件:

row_variable

オブジェクト識別子 の規則に従う変数名を指定します。

DECLARE または BEGIN ... END セクションにこの変数の宣言を追加しないでください。名前は、ローカルブロックのスコープでまだ定義されていないはずです。

名前は FOR ループの内側では有効ですが、 FOR ループの外側では無効です。

row_variable は、カーソルから1行を保持します。その行内のフィールドには、ドット表記を使用してアクセスします。例:

my_row_variable.my_column_name

より包括的な例は、以下の例に含まれています。

counter_variable

オブジェクト識別子 の規則に従う変数名を指定します。

counter_variable の名前は、 FOR ループ内でのみ有効です。同じ名前の変数がループの外側で宣言されている場合、外側の変数とループ変数は別々です。ループ内では、その名前への参照がループ変数に解決されます。

FOR ループ内のコードは、カウンター変数の値を読み取ることができますが、変更はしないでください。たとえば、ステップサイズを変更するためにカウンター変数を手動で増分しないでください。

start

これは、 counter_variable の初期値です。

開始値は、 INTEGER または INTEGER と評価される式である必要があります。

end

これは、ループ時に counter_variable が増分された後の、 counter_variable の最終値です。

終了値は、 INTEGER または INTEGER と評価される式である必要があります。

end の値は、 start の値以上である必要があります。 end が start 未満の場合、ループは0回実行されます（REVERSE キーワードが使用されている場合でも）。

statement

ステートメントは、次のいずれかになります。

• 単一の SQL ステートメント（CALL を含む）。

• 制御フローステートメント（例: ループ または 分岐 ステートメント）。

• ネストされた ブロック。

cursor_name

反復するカーソルの名前。

label

オプションのラベル。このようなラベルは、 BREAK （Snowflakeスクリプト） または CONTINUE （Snowflakeスクリプト） ステートメントのジャンプターゲットになる可能性があります。ラベルは、 オブジェクト識別子 の名前付け規則に従う必要があります。

使用上の注意¶

• ループは、 end ポイントまで反復されます。

  たとえば、 FOR i IN 1 TO 10 は10回ループし、最後の反復では i の値は10です。

  REVERSE キーワードを使用すると、ループは start 値まで逆方向に反復されます。

• ループには複数のステートメントを含めることができます。これらのステートメントを含めるために BEGIN ... END （Snowflakeスクリプト） ブロック を使用できますが、必須ではありません。

• オプションのキーワード REVERSE を使用すると、Snowflakeは end の値で開始し、 start の値まで減分します。

• ループ内で counter_variable の値を変更できますが、Snowflakeではこれを避けることをお勧めします。値を変更すると、コードが理解しにくくなります。

• キーワード DO を使用する場合は、 FOR ループの最後で END FOR を使用します。キーワード LOOP を使用する場合は、 FOR ループの最後で END LOOP を使用します。

例¶

カーソルベースの FOR ループ:

この例は、 カーソル を使用して、クエリによって返されるすべての行の price 列にある値を合計する方法を示しています。このストアドプロシージャは、集計関数のように動作します。

CREATE or replace TABLE invoices (price NUMBER(12, 2));
INSERT INTO invoices (price) VALUES
    (11.11),
    (22.22);

Copy

CREATE OR REPLACE PROCEDURE for_loop_over_cursor()
RETURNS FLOAT
LANGUAGE SQL
AS
$$
DECLARE
    total_price FLOAT;
    c1 CURSOR FOR SELECT price FROM invoices;
BEGIN
    total_price := 0.0;
    OPEN c1;
    FOR rec IN c1 DO
        total_price := total_price + rec.price;
    END FOR;
    CLOSE c1;
    RETURN total_price;
END;
$$
;

Copy

ストアドプロシージャの出力は次のとおりです。

CALL for_loop_over_cursor();
+----------------------+
| FOR_LOOP_OVER_CURSOR |
|----------------------|
|                33.33 |
+----------------------+

Copy

カウンターベースの FOR ループ:

この例は、 FOR ループを使用して指定された回数を反復する方法を示しています。

CREATE PROCEDURE simple_for(iteration_limit INTEGER)
RETURNS INTEGER
LANGUAGE SQL
AS
$$
    DECLARE
        counter INTEGER DEFAULT 0;
    BEGIN
        FOR i IN 1 TO iteration_limit DO
            counter := counter + 1;
        END FOR;
        RETURN counter;
    END;
$$;

Copy

ストアドプロシージャの出力は次のとおりです。

CALL simple_for(3);
+------------+
| SIMPLE_FOR |
|------------|
|          3 |
+------------+

Copy

次の例は、 REVERSE キーワードを使用して逆方向にカウントする方法を示しています。

CREATE PROCEDURE reverse_loop(iteration_limit INTEGER)
RETURNS VARCHAR
LANGUAGE SQL
AS
$$
    DECLARE
        values_of_i VARCHAR DEFAULT '';
    BEGIN
        FOR i IN REVERSE 1 TO iteration_limit DO
            values_of_i := values_of_i || ' ' || i::varchar;
        END FOR;
        RETURN values_of_i;
    END;
$$;

Copy

ストアドプロシージャの出力は次のとおりです。

CALL reverse_loop(3);
+--------------+
| REVERSE_LOOP |
|--------------|
|  3 2 1       |
+--------------+

Copy

次の例は、ループカウンター変数がすでに宣言されている変数と同じ名前（i）である場合の動作を示しています。 FOR ループ内では、 i への参照はループカウンター変数に解決されます（ループ外で宣言された変数には解決されません）。

CREATE PROCEDURE p(iteration_limit INTEGER)
RETURNS VARCHAR
LANGUAGE SQL
AS
$$
    DECLARE
        counter INTEGER DEFAULT 0;
        i INTEGER DEFAULT -999;
        return_value VARCHAR DEFAULT '';
    BEGIN
        FOR i IN 1 TO iteration_limit DO
            counter := counter + 1;
        END FOR;
        return_value := 'counter: ' || counter::varchar || '\n';
        return_value := return_value || 'i: ' || i::VARCHAR;
        RETURN return_value;
    END;
$$;

Copy

ストアドプロシージャの出力は次のとおりです。

CALL p(3);
+------------+
| P          |
|------------|
| counter: 3 |
| i: -999    |
+------------+

Copy