クエリテンプレート

最終更新日: 2024-01-30
  • トピック:
  • Queries
    このトピックの詳細を表示
  • 作成対象:
  • Developer
    User
    Admin
    Leader

Adobe Experience Platform クエリサービスを使用すると、SQL コードを保存して、クエリテンプレートの形式で再利用できます。 テンプレートを使用すると、よく実行されるタスクの繰り返しを避けることで、手間を省くことができます。 組織内でテンプレートを共有すると、基になる SQL にアクセスしたり理解したりする必要なく、クエリ値を簡単に変更できます。

このドキュメントでは、クエリサービスでクエリテンプレートを作成するために必要な情報を提供します。

前提条件

クエリエディターにアクセスし、Platform UI 内のクエリダッシュボードを表示するには、クエリの管理権限が有効になっている必要があります。この権限は、Adobe Admin Console を使用して有効にできます。この権限を有効にするための管理者権限がない場合は、組織の管理者に問い合わせてください。 Admin Console を使用した権限の追加に関する完全な手順については、アクセス制御に関するドキュメントを参照してください。

クエリテンプレートの作成

クエリテンプレートを作成するには、Query Service API query-templates エンドポイントに対して POST リクエストを実行するか、クエリエディターでクエリを記述、命名、保存するという 2 つの方法があります。

クエリエディターを使用して、クエリを作成し、テンプレートとして保存します。

クエリエディターを使用して書き込みおよびクエリを保存する方法については、ドキュメントを参照してください。クエリに名前を付けて保存すると、「テンプレート」タブからクエリテンプレートとして再利用できます。

ヒント

クエリエディターでクエリを保存すると、確認メッセージがポップアップ表示され、正常なアクションが示されます。 このポップアップメッセージには、クエリのスケジュール設定ワークスペースに移動する便利な方法を提供するリンクが含まれています。 詳しくは、 スケジュールクエリドキュメント を参照して、カスタムケイデンスに対してクエリを実行する方法を確認してください。

クエリテンプレートを参照

Platform UI のクエリワークスペースから、「テンプレート」を選択して、使用可能な保存済みクエリのリストを表示します。

「テンプレート」タブが強調表示されたクエリワークスペース。

関連するテンプレート情報を見つけるには、使用可能なリストから任意のクエリテンプレートを選択して、詳細パネルを開きます。

クエリ ID が強調表示されたクエリワークスペースの詳細パネル。

詳細パネルから、次の操作を実行できます。

  • 選択 CTAS として実行 既存のテーブルからデータを選択して新しいテーブルを作成する場合。 このオプションは、SELECT クエリがある場合にのみ使用できます。
  • 選択 スケジュールを追加 をクリックして、クエリテンプレートのスケジュールの編集を開始します。
  • 選択 スケジュールを表示 をクリックして、 スケジュール 」タブをクリックします。 このビューには、クエリに関連付けられたスケジュール情報が含まれます。
  • 選択 クエリを削除 をクリックしてテンプレートを削除します。
  • テンプレート名を選択してクエリエディターに移動し、編集用に SQL が事前に入力されています。

Query Service API を使用してテンプレートを作成する

Query Service API を使用したクエリテンプレートの作成方法の手順については、ドキュメントを参照してください。 新しく作成したクエリテンプレートの詳細は、応答本文に含まれています。

メモ

API を使用して作成したテンプレートは、「Platform UI クエリサービステンプレート」タブにも表示されます。

次の手順

このドキュメントでは、クエリサービスでクエリテンプレートを作成する方法をより深く理解しました。 クエリサービスの機能について詳しくは、UI の概要または Query Service API ガイドを参照してください。

API または UI 用クエリエディターガイドを使用して、クエリをスケジュールする方法について詳しくは、スケジュールされたクエリエンドポイントガイドを参照してください。

このページ