ループの操作¶

Snowflakeスクリプトは、次のタイプのループをサポートしています。

FOR
WHILE
REPEAT
LOOP

このトピックでは、こうした各タイプのループの使用方法について説明します。

FOR ループ¶

FOR ループは、指定された回数、または結果セットの各行に対して一連のステップを繰り返します。Snowflakeスクリプトは、次のタイプの FOR ループをサポートします。

カウンターベースの FOR ループ
カーソルベースの FOR ループ
RESULTSET ベースの FOR ループ

次のセクションでは、こうしたタイプの FOR ループの使用方法について説明します。

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

カウンターベースの FOR ループは、指定された回数を実行します。

カウンターベースの FOR ループの構文は次のとおりです。

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

Copy

たとえば、次の FOR ループは5回実行されます。

DECLARE
  counter INTEGER DEFAULT 0;
  maximum_count INTEGER default 5;
BEGIN
  FOR i IN 1 TO maximum_count DO
    counter := counter + 1;
  END FOR;
  RETURN counter;
END;

Copy

注: SnowSQL、 Classic Console、 execute_stream または execute_string メソッドを Python Connector コードで使用している場合は、代わりにこの例を使用してください（SnowSQL、 Classic Console、Python ConnectorでSnowflakeスクリプトを使用するを参照）。

EXECUTE IMMEDIATE $$
DECLARE
  counter INTEGER DEFAULT 0;
  maximum_count INTEGER default 5;
BEGIN
  FOR i IN 1 TO maximum_count DO
    counter := counter + 1;
  END FOR;
  RETURN counter;
END;
$$
;

Copy

+-----------------+
| anonymous block |
|-----------------|
|               5 |
+-----------------+

FOR ループの包括的な構文と詳細については、 FOR （Snowflakeスクリプト）をご参照ください。

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

カーソルベースの FOR ループは、結果セットを反復処理します。反復回数は、カーソルの行数によって決まります。

カーソルベースの FOR ループの構文は次のとおりです。

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

Copy

このセクションの例では、次の invoices テーブルのデータを使用しています。

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

Copy

次の例では、 invoices テーブルのカーソル内の行を反復する FOR ループを使用しています。

DECLARE
  total_price FLOAT;
  c1 CURSOR FOR SELECT price FROM invoices;
BEGIN
  total_price := 0.0;
  FOR record IN c1 DO
    total_price := total_price + record.price;
  END FOR;
  RETURN total_price;
END;

Copy

EXECUTE IMMEDIATE $$
DECLARE
  total_price FLOAT;
  c1 CURSOR FOR SELECT price FROM invoices;
BEGIN
  total_price := 0.0;
  FOR record IN c1 DO
    total_price := total_price + record.price;
  END FOR;
  RETURN total_price;
END;
$$
;

Copy

+-----------------+
| anonymous block |
|-----------------|
|           33.33 |
+-----------------+

FOR ループの包括的な構文と詳細については、 FOR （Snowflakeスクリプト）をご参照ください。

RESULTSET ベースの FOR ループ¶

RESULTSET ベースの FOR ループは、結果セットを反復処理します。反復回数は、 RESULTSET クエリによって返される行数によって決まります。

RESULTSET ベースの FOR ループの構文は次のとおりです。

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

Copy

このセクションの例では、次の invoices テーブルのデータを使用しています。

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

Copy

次のブロックは、 FOR ループを使用して、 invoices テーブルの RESULTSET 内の行を反復処理します。

DECLARE
  total_price FLOAT;
  rs RESULTSET;
BEGIN
  total_price := 0.0;
  rs := (SELECT price FROM invoices);
  FOR record IN rs DO
    total_price := total_price + record.price;
  END FOR;
  RETURN total_price;
END;

Copy

EXECUTE IMMEDIATE $$
DECLARE
  total_price FLOAT;
  rs RESULTSET;
BEGIN
  total_price := 0.0;
  rs := (SELECT price FROM invoices);
  FOR record IN rs DO
    total_price := total_price + record.price;
  END FOR;
  RETURN total_price;
END;
$$
;

Copy

+-----------------+
| anonymous block |
|-----------------|
|           33.33 |
+-----------------+

FOR ループの包括的な構文と詳細については、 FOR （Snowflakeスクリプト）をご参照ください。

WHILE ループ¶

WHILE ループは、条件がtrueの間、反復されます。WHILE ループでは、ループの本文を実行する直前に条件がテストされます。最初の反復の前に条件がfalseの場合、ループの本文は1回も実行されません。

WHILE ループの構文は次のとおりです。

WHILE ( <condition> ) { DO | LOOP }
  <statement>;
  [ <statement>; ... ]
END { WHILE | LOOP } [ <label> ] ;

Copy

例:

BEGIN
  LET counter := 0;
  WHILE (counter < 5) DO
    counter := counter + 1;
  END WHILE;
  RETURN counter;
END;

Copy

EXECUTE IMMEDIATE $$
BEGIN
  LET counter := 0;
  WHILE (counter < 5) DO
    counter := counter + 1;
  END WHILE;
  RETURN counter;
END;
$$
;

Copy

+-----------------+
| anonymous block |
|-----------------|
|               5 |
+-----------------+

WHILE ループの包括的な構文と詳細については、 WHILE （Snowflakeスクリプト）をご参照ください。

REPEAT ループ¶

REPEAT ループは、条件がtrueになるまで反復されます。REPEAT ループでは、ループの本文を実行した直後に条件がテストされます。その結果、ループの本文は常に少なくとも1回実行されます。

REPEAT ループの構文は次のとおりです。

REPEAT
  <statement>;
  [ <statement>; ... ]
UNTIL ( <condition> )
END REPEAT [ <label> ] ;

Copy

例:

BEGIN
  LET counter := 5;
  LET number_of_iterations := 0;
  REPEAT
    counter := counter - 1;
    number_of_iterations := number_of_iterations + 1;
  UNTIL (counter = 0)
  END REPEAT;
  RETURN number_of_iterations;
END;

Copy

EXECUTE IMMEDIATE $$
BEGIN
  LET counter := 5;
  LET number_of_iterations := 0;
  REPEAT
    counter := counter - 1;
    number_of_iterations := number_of_iterations + 1;
  UNTIL (counter = 0)
  END REPEAT;
  RETURN number_of_iterations;
END;
$$
;

Copy

+-----------------+
| anonymous block |
|-----------------|
|               5 |
+-----------------+

REPEAT ループの包括的な構文と詳細については、 REPEAT （Snowflakeスクリプト）をご参照ください。

LOOP ループ¶

BREAK コマンドが実行されるまで、 LOOP ループは実行されます。BREAK コマンドは通常、分岐ロジック（例: IF ステートメントまたは CASE ステートメント）内に埋め込まれています。

LOOP ステートメントの構文は次のとおりです。

LOOP
  <statement>;
  [ <statement>; ... ]
END LOOP [ <label> ] ;

Copy

例:

BEGIN
  LET counter := 5;
  LOOP
    IF (counter = 0) THEN
      BREAK;
    END IF;
    counter := counter - 1;
  END LOOP;
  RETURN counter;
END;

Copy

EXECUTE IMMEDIATE $$
BEGIN
  LET counter := 5;
  LOOP
    IF (counter = 0) THEN
      BREAK;
    END IF;
    counter := counter - 1;
  END LOOP;
  RETURN counter;
END;
$$
;

Copy

+-----------------+
| anonymous block |
|-----------------|
|               0 |
+-----------------+

LOOP ループの包括的な構文と詳細については、 LOOP （Snowflakeスクリプト）をご参照ください。

ループまたは反復の終了¶

ループ構造では、ループまたはループの反復を早期に終了するときを指定できます。次のセクションでは、これについて詳しく説明します。

ループの終了
ループを終了せずに反復を終了
終了後に実行を継続する場所の指定

ループの終了¶

BREAK コマンドを実行すれば、ループを明示的に早期終了させることができます。BREAK （およびその同義語 EXIT）は、現在の反復を直ちに停止し、残りの反復をスキップします。BREAK は、ループ終了後にある最初の実行可能ステートメントにジャンプすると考えることができます。

BREAK は、 LOOP ループでは必要ですが、 WHILE、 FOR、および REPEAT ループでは必要ありません。ほとんどの場合、スキップするステートメントがあるときは、標準の分岐構造（IF ステートメントおよび CASE ステートメント）を使用して、ループ内のどのステートメントを実行するかを制御できます。

BREAK コマンド自体は通常、 IF または CASE ステートメント内にあります。

ループを終了せずに反復を終了¶

CONTINUE （または ITERATE）コマンドを使用して、ループの残りのステートメントをスキップして、ループの反復の最後にジャンプできます。ループは次の反復の開始時に続きます。

このようなジャンプが必要になることはめったにありません。ほとんどの場合、スキップするステートメントがあるときは、標準の分岐構造（IF ステートメントおよび CASE ステートメント）を使用して、ループ内のどのステートメントを実行するかを制御できます。

CONTINUE または ITERATE コマンド自体は、通常、 IF または CASE ステートメント内にあります。

終了後に実行を継続する場所の指定¶

BREAK または CONTINUE コマンドで、コード内の特定のポイント（例: ネストされたループの外側のループ）で実行を続行する必要がある場合は、実行を続行するポイントを識別するラベルを指定します。

次の例は、ネストされたループでこれを示しています。

BEGIN
  LET inner_counter := 0;
  LET outer_counter := 0;
  LOOP
    LOOP
      IF (inner_counter < 5) THEN
        inner_counter := inner_counter + 1;
        CONTINUE OUTER;
      ELSE
        BREAK OUTER;
      END IF;
    END LOOP INNER;
    outer_counter := outer_counter + 1;
    BREAK;
  END LOOP OUTER;
  RETURN ARRAY_CONSTRUCT(outer_counter, inner_counter);
END;

Copy

EXECUTE IMMEDIATE $$
BEGIN
  LET inner_counter := 0;
  LET outer_counter := 0;
  LOOP
    LOOP
      IF (inner_counter < 5) THEN
        inner_counter := inner_counter + 1;
        CONTINUE OUTER;
      ELSE
        BREAK OUTER;
      END IF;
    END LOOP INNER;
    outer_counter := outer_counter + 1;
    BREAK;
  END LOOP OUTER;
  RETURN ARRAY_CONSTRUCT(outer_counter, inner_counter);
END;
$$;

Copy

この例では:

OUTER というラベルの付いたループにネストされた、 INNER というラベルの付いたループがあります。
CONTINUE OUTER は、ラベル OUTER があるループで別の反復を開始します。
BREAK OUTER は、内側のループを終了し、制御を外側のループ（OUTER のラベル付き）の最後に移します。

このコマンドの出力は次のとおりです。

+-----------------+
| anonymous block |
|-----------------|
| [               |
|   0,            |
|   5             |
| ]               |
+-----------------+

出力に示されているように、

inner_counter は5まで増加します。CONTINUE OUTER は、外側のループの新しい反復を開始します。これにより、内側のループの新しい反復が開始され、このカウンターは5まで増加します。これらの反復は、 inner_counter の値が5になり、 BREAK OUTER が内部ループを終了するまで続きます。
outer_counter が増加することはありません。このカウンターを増加するステートメントは、 BREAK OUTER が制御を外側のループの最後に移すため、このカウンターに到達することはありません。