パラメーター化クエリ parameterized-queries

クエリサービスでは、クエリエディターでのパラメーター化されたクエリの使用がサポートされています。 パラメーター化されたクエリで、パラメーターのプレースホルダーを使用して、実行時にパラメーター値を追加できるようになりました。 プレースホルダーを使用すると、ステートメントが実行されるまでの値が不明な動的データを操作できます。 また、クエリを事前に準備し、同様の目的で再利用することもできます。 クエリを再利用すると、各使用例に対して個別の SQL クエリを作成する手間が省けます。

前提条件

このガイドを続行する前に、 クエリエディター UI ガイド. クエリエディターガイドでは、Experience Platformユーザーインターフェイス内で顧客体験データのクエリを記述、検証、実行する方法に関する詳細情報を提供します。

NOTE
Adobe Experience Platform UI 内では、パラメーター化されたクエリは、インラインテンプレートの親レベルでのみサポートされます。 つまり、パラメーター化されたクエリは、元のテンプレートで使用された場合にのみ機能します。子テンプレートは、静的テンプレートである必要があり、動的パラメーターを持つことはできません。 詳しくは、 インラインテンプレートドキュメント を参照してください。

パラメーター化されたクエリ構文 syntax

パラメーター化されたクエリは形式を使用します '$YOUR_PARAMETER_NAME' とは、ドット表記を使用して連結できます。 パラメータ化されたクエリを使用する SQL 文の例を次に示します。

INSERT INTO
   $Database_Name.Schema_Name.adwh_lkup_process_delta_log
   (process_name, merge_policy_id, process_status, process_date, create_ts, change_ts)
SELECT
   '$Table_Process_Name' process_name,
   hash('$Merge_PolicyID') merge_policy_id,
   '$process_status' process_status,
   to_date('$date_key') process_date,
   CURRENT_TIMESTAMP create_ts,
   CURRENT_TIMESTAMP change_ts;

パラメーター化クエリの作成 create

UI でパラメーター化されたクエリを作成するには、クエリエディターに移動します。 詳しくは、 クエリエディターへのアクセス を参照してください。

'$' の序文を使用して、テキストエディターでクエリにクエリパラメーターを入力します。次に、 クエリパラメーター タブの横 コンソール キーの欠落した値を追加します。 必要なキーのいずれかに値を追加しなかった場合、クエリは実行できません。 アラートアイコン ( アラートアイコン。 ) は、空の場合は横の「クエリパラメーター」セクションに表示されます 値 入力フィールド。

NOTE
クエリがパラメータを取らない場合でも、クエリエディタ内で不要なパラメータを入力できます。 クエリエディターは、不要なキーと値のペアをすべて無視し、クエリの実行や結果には影響しません。

パラメーター化されたクエリと「クエリパラメーター」セクションがハイライト表示されたクエリエディター。

TIP
タブの変更元 クエリパラメーター から コンソール をクリックして、クエリのコンソール出力を表示します。

クエリログの詳細を使用してパラメーター値を確認 check-parameter-values

使用した値は永続的ではないので、テンプレート内にパラメーターを保存することはできません。 ただし、 クエリログの詳細 ページを開き、クエリの実行で使用されるパラメーター値を検索します。 この場合、ログはクエリがパラメーター化されたクエリであることを示しません。 詳しくは、 クエリログドキュメント を参照してください。

クエリログビューでは、詳細セクションでパラメータ化されたクエリの SQL が強調表示されます。

パラメーター化クエリのスケジュール設定 schedule

パラメータ値は、パラメータ化クエリをスケジュールする際に保存されます。 パラメーター化されたクエリをスケジュールするには、次のガイドに従って、通常の手順に従ってスケジュール済みクエリを作成します。 クエリスケジュールの作成次に、クエリの実行で使用するパラメーター値を入力します。 この UI セクションは、パラメーター化されたクエリに対してのみ表示されます。 詳しくは、 スケジュール済みのパラメーター化クエリのパラメーターの設定 を参照してください。

TIP
クエリサービスは、パラメーター化されたクエリを使用して準備済み文をサポートします。 詳しくは、 準備済み文構文ガイド を参照してください。

次の手順

このドキュメントでは、Adobe Experience Platform UI でクエリをパラメータ化し、スケジュールされたクエリの実行で使用する方法を学びました。 また、クエリの実行で使用されるパラメーター値をログで確認する方法も強調されました。

次に、に関するガイドを読むことをお勧めします。 スケジュール済みクエリの監視 を使用すると、Platform UI を通じてすべてのクエリジョブのステータスをより深く理解できます。

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb