クエリサービスの匿名ブロック

Adobe Experience Platform クエリサービスは、匿名ブロックをサポートします。匿名ブロック機能を使用すると、順に実行される 1 つ以上の SQL 文を連結できます。また、例外処理のオプションも使用できます。

匿名ブロック機能は、操作またはクエリのシーケンスを効率的に実行する方法です。ブロック内のクエリの連結をテンプレートとして保存し、特定の時間または間隔で実行するようにスケジュールできます。これらのクエリは、データの書き込みと追加を使用して新しいデータセットを作成するために使用でき、通常は依存関係がある場合に使用されます。

次の表に、実行と例外処理に関するブロックの主要セクションの分類を示します。セクションは、キーワード BEGIN、END および EXCEPTION によって定義されます。

ブロックは実行可能な文であり、他のブロック内にネストできます。

匿名ブロッククエリのサンプル

次のクエリは、SQL 文を連結する例を示しています。 使用されている SQL 構文について詳しくは、クエリサービスの SQL 構文ドキュメントを参照してください。

$$ BEGIN
    CREATE TABLE ADLS_TABLE_A AS SELECT * FROM ADLS_TABLE_1....;
    ....
    CREATE TABLE ADLS_TABLE_D AS SELECT * FROM ADLS_TABLE_C....;
    EXCEPTION WHEN OTHER THEN SET @ret = SELECT 'ERROR';
END
$$;

以下の例では、SET は指定されたローカル変数に SELECT クエリの結果を保持します。変数は、匿名ブロックに対してスコープ設定されます。

スナップショット ID は、ローカル変数（@current_sid）として保存されます。その後、次のクエリで使用され、同じデータセット/テーブルからの SNAPSHOT に基づいて結果が返されます。 スナップショット句に関する情報については、SQL 構文のドキュメントを参照してください。

$$ BEGIN
  SET @current_sid = SELECT parent_id  FROM (SELECT history_meta('your_table_name')) WHERE  is_current = true;
  CREATE temp table abcd_temp_table AS SELECT count(1) FROM your_table_name  SNAPSHOT SINCE @current_sid;
END
$$;

サードパーティクライアントを使用した匿名ブロック third-party-clients

特定のサードパーティクライアントでは、スクリプトの一部を単一の文として処理する必要があることを示すために、SQL ブロックの前後に別の識別子が必要な場合があります。 サードパーティクライアントでクエリサービスを使用するときにエラーメッセージが表示された場合は、SQL ブロックの使用に関するサードパーティクライアントのドキュメントを参照してください。

たとえば、DbVisualizer では、区切り文字が行の唯一のテキストである必要があります。 DbVisualizer では、Begin Identifier のデフォルト値は --/ で、End Identifier のデフォルト値は / です。 DbVisualizer の匿名ブロックの例を以下に示します。

--/
$$ BEGIN
    CREATE TABLE ADLS_TABLE_A AS SELECT * FROM ADLS_TABLE_1....;
    ....
    CREATE TABLE ADLS_TABLE_D AS SELECT * FROM ADLS_TABLE_C....;
    EXCEPTION WHEN OTHER THEN SET @ret = SELECT 'ERROR';
END
$$;
/

特に DbVisualizer の場合は、UI に「Execute the complete buffer as one SQL statement」というオプションもあります。 詳しくは、DbVisualizer のドキュメントを参照してください。

次の手順

このドキュメントを参照することで、匿名ブロックとその構造を明確に理解できます。クエリの作成について詳しくは、 クエリ実行ガイドを参照してください。

また、クエリの効率を高めるために、 増分読み込みデザインパターンで匿名ブロックを使用する方法についても参照してください。