クエリサービス UI ガイド

Adobe Experience Platform クエリサービスは、クエリの作成と実行、以前に実行されたクエリの表示、組織内のユーザーが保存したクエリへのアクセスに使用できるユーザーインターフェイスを提供します。 Adobe Experience Platform内のUIにアクセスするには、左側のナビゲーションで「クエリ」を選択します。 ​ クエリ ​ 概要が表示されます。

​ クエリと「概要」タブがハイライト表示されたクエリサービスワークスペース。

概要 overview

「概要」タブには、クエリとData Distiller テンプレートを操作するための効率的なエントリポイントが用意されています。 クエリの作成、データセットの探索、オーディエンスデータの分析に必要なあらゆる機能を利用して、データ分析とオーディエンスインサイトのワークフローをスムーズに進めることができます。 この概要では、Data Distillerで実現できることと、クエリサービスの使用状況に関する主要指標について説明します。

メインパネル main-panels

概要 ページには、開始に役立ついくつかの主なセクションが含まれています。

  1. クエリを作成」を選択すると、クエリエディターにすばやく移動して、新しいクエリを作成して実行できます。
  2. 詳細情報」を選択して、クエリの書き方​に関する詳細なドキュメントを表示します。
  3. データDistillerの詳細」セクションの「使い始める」を選択して、Data Distillerの概要を開き、使用可能な機能について説明します。

​ クエリを作成、詳細、開始を含むクエリ サービス ワークスペースがハイライト表示されます。

Data Distiller の機能 data-distiller-capabilities

「Data Distiller機能」セクションには、より高度なData Distiller機能へのドキュメントリンクが用意されています。

  • データ探索: SQLを使用してバッチで取り込まれたデータを探索、トラブルシューティング、検証する方法について説明します。
  • Experience Platform アプリケーション用の派生データセット:派生データセットを作成して、データユーティリティを最大限に活用する複雑で多様なユースケースをサポートする方法を説明します。
  • AI/マシンラーニング パイプライン:好みのマシンラーニングツールの背後にある重要な概念と、マーケティングのユースケースをサポートするカスタムモデルの構築方法について説明します。 この一連のガイドでは、Experience Platformからのデータを準備し、マシンラーニング環境でカスタムモデルをフィードする機能パイプラインを構築するために必要な手順について説明します。
  • SQL インサイト: SQLからData Distillerを使用してインサイト ダッシュボードを開発するための主な機能と必要な手順について説明します。

Data Distiller機能セクションがハイライト表示されたQuery Service ワークスペース。

アクセラレーター accelerators

クエリワークスペースの「アクセラレータ」タブには、一般的な分析ユースケース向けに、Adobeで作成されたパラメーター化されたSQL テンプレートのカタログが用意されています。 各アクセラレーターは、名前、SQL プレビュー、メタデータを含むテーブルの行として表示されます。

アクセラレーターを選択して、クエリエディターで開きます。 パラメーター値を指定し、クエリを実行して結果を生成します。 アクセラレータは読み取り専用で、Adobeによってメンテナンスされ、一貫性を確保します。 ロジックを変更するには、カスタムテンプレートの作成​を使用して編集可能なコピーを作成します。 アクセラレータを検索、実行、スケジュール、カスタマイズする方法については、Data Distiller アクセラレータ ​ ガイドを参照してください。

「概要」タブの​おすすめのData Distiller アクセラレータ セクションでは、よく使用されるアクセラレータに素早くアクセスできます。 これらはカードとして表示され、次の2つのワークフローをサポートします。

  • ダッシュボードにリンクされたアクセラレータ​が、事前定義済みのビジュアライゼーションを使用してダッシュボードワークスペースで開きます。 これらは、パラメーター入力や手動でのクエリ実行を必要としません。
  • クエリベースのアクセラレータ​がクエリエディターで開き、パラメーター値を指定したり、クエリを実行したり、スケジュールしたりできます。

カードを選択してアクセラレーターを開きます。 このセクションを使用して、一般的なワークフローにすばやくアクセスするか、アクセラレーター タブに移動して、カタログ全体を参照します。 アクセラレータの一覧と詳細な手順については、​ アクセラレータ タブ ​またはData Distiller アクセラレータ ガイド ​を参照してください。

次のダッシュボードにリンクされたアクセラレータを使用できます。

  • 高度なオーディエンスの重複: オーディエンス間の交差を分析して、重複パターンを特定し、セグメント化を調整します。
  • オーディエンスの比較: サイズ、構成、経時的な変化など、2つのオーディエンス間の主要な指標を比較します。
  • オーディエンスの傾向: オーディエンスのサイズやID数など、オーディエンス指標が時間の経過とともにどのように変化するかを追跡します。
  • オーディエンス IDの重複: IDの合成とセグメント化の精度をサポートするために、オーディエンス内でID タイプがどのように重複するかを調べます。

推奨アクセラレーターカードを含むData Distiller アクセラレーターセクションを表示するクエリサービスの概要

Data Distiller の例 data-distiller-examples

Select a card to open documentation guides and examples to help you make the most of data Distiller:

  • 決定ベースの派生データセット: Adobe Experience Platformでセグメント化とオーディエンス作成用の決定ベースの派生データセットを作成する方法を説明します。 航空会社のロイヤルティシナリオを活用して、スキーマの設計、意思決定の計算、データのランキングと集約に関するクエリ例を紹介しています。
  • 顧客生涯価値: Real-Time CDPとカスタムダッシュボードを使用して、顧客の生涯価値を追跡および可視化する方法を説明します。 これらのインサイトを活用して、新規顧客の獲得戦略を策定し、既存顧客を維持し、利益率を最大化します。
  • 傾向スコア:機械学習の予測モデルを使用して傾向スコアを決定する方法を説明します。 このガイドでは、トレーニング用にデータを送信する、SQLを使用してトレーニングされたモデルを適用する、顧客の購買可能性を予測する、といったことを説明します。
  • 同意分析: Real-Time CDP、Query Service、Data Distillerを使用して、顧客の同意を分析および追跡する方法について説明します。 このガイドでは、同意ダッシュボードの構築、セグメンテーションの改善、トレンドの追跡、コンプライアンスの確保をカバーし、信頼を構築し、パーソナライズされた体験を提供するのに役立ちます。
  • ファジィ一致: Experience Platform データに対して「ファジィ」一致を実行して、近似一致を見つけ、データセット全体で文字列の類似性を分析する方法を説明します。 このガイドに従って、時間を節約し、データをよりアクセスしやすくしましょう。 この例では、2つの旅行代理店データセット間でホテルの部屋の属性を一致させる方法を示しており、大規模で複雑なデータセットを効率的に一致、比較、調整して、一貫性と正確性を確保する方法を示しています。

Data Distillerの例セクションがハイライト表示されたQuery Service ワークスペース。

主要指標 key-metrics

「主要指標」セクションには、クエリサービスの使用状況を監視するのに役立つ重要なデータのビジュアライゼーションが表示されます。 グラフごとに、右上の省略記号(...)を選択し、詳細を表示して結果の表形式を表示するか、データをCSV ファイルとしてダウンロードしてスプレッドシートで表示できます。 詳しくは、詳細を表示ガイド ​を参照してください。

日付フィルターの設定 set-date-filter

これらのビジュアライゼーションにグローバル日付フィルターを適用するには、フィルターアイコン( ​ フィルターアイコン( )を選択します フィルター ダイアログで日付範囲を調整します。 このフィルターを適用すると、表示される指標を特定の時間枠に合わせてカスタマイズし、分析の関連性を高めることができます。

Query Service Workspaceの主要指標グラフのフィルターダイアログ。

Distiller バッチクエリ ​ distiller-batch-queries

Distiller バッチクエリ ​のグラフには、処理済みのCTAおよびITAS (インタラクティブおよびスケジュール済み)クエリの数を強調した、日別のクエリアクティビティの内訳が表示されます。 このグラフは、特定の日にインタラクティブなクエリが急増したり、スケジュールされたクエリの使用頻度が低かったりするなど、パターンを強調表示しています。 これらのインサイトを活用して、ピーク時のアクティビティ期間の特定、スケジュール戦略の改善、クエリ実行のバランスをとることで、パフォーマンスを最適化し、ワークフローの効率とリソースの利用率を向上させます。

Distiller バッチ クエリ チャート。

使用時間を計算 compute-hours-consumed

計算時間消費 チャートは、クエリサービス操作の処理に使用される計算時間を日々の視覚化で表示します。 これらの計算時間のトレンドを使用して、リソース消費の監視、需要の高い期間の特定、クエリの実行の最適化を行い、リソースの効率的な割り当てとパフォーマンスを確保します。

計算時間消費チャート。

​ データ探索クエリ ​

​ データ探索クエリ ​のグラフには、1日に必要に応じて処理されたSELECT クエリの数が表示されます。 このビジュアライゼーションでは、特定の日の利用率の急増などのクエリ活動の傾向を強調表示して、データ探索の取り組みが最も活発なタイミングを把握するのに役立ちます。 これらのインサイトを活用して、クエリの使用パターンを監視し、ワークロードのバランスを取り、探索的なデータ分析のためにリソース割り当てを最適化します。 この分析により、クエリサービスの効率的な利用と、需要の多い期間の計画の改善が可能になります。

​ データ探索クエリのグラフ。

クエリエディター

クエリエディターを使用すると、外部クライアントを使用せずにクエリを作成および実行できます。 「クエリを作成」を選択してクエリエディターを開き、新しいクエリを作成します。 ログ​または​テンプレート タブからクエリを選択して、クエリエディターにアクセスすることもできます。 以前に実行または保存したクエリを選択すると、クエリエディターが開き、選択したクエリのSQLが表示されます。

「クエリの作成」がハイライト表示されたクエリダッシュボード。

クエリエディターで入力すると、エディターはテーブル内のSQL予約語、テーブル、フィールド名を自動的に補完します。 クエリの記述が完了したら、再生アイコン( 再生アイコン( )を選択します。 クエリを実行します。 エディターの下の​コンソール タブには、現在クエリサービスが実行されている内容が表示され、クエリが返されたタイミングが示されます。 ​ コンソール ​の横にある​結果 タブに、クエリの結果が表示されます。 クエリエディターの使用について詳しくは、​ クエリエディターガイド ​を参照してください。

​ クエリエディターのワークスペース。

「結果」タブについて results-tab

「結果」タブには、実行後のクエリの表形式の出力が表示されます。 このタブを使用すると、結果を確認したり、出力を検証したり、フォローアップアクションをインターフェイスで直接実行したりできます。 このビューでは、次の操作を実行できます。

  • オフライン分析用にCSV、XLSX、JSON形式で結果をダウンロードします。 ​ クエリ結果のダウンロード ​を参照してください。
  • サイズ変更可能なグリッドレイアウトで大きなテーブルや幅広のデータセットを調べるために、結果をフルスクリーンで表示します。 ​ フルスクリーンで結果を表示を参照してください。
  • 結果をCSV形式でクリップボードにコピーして、スプレッドシートのアプリケーションにすばやくペーストできます。 結果をコピーを参照してください。

これらの機能は、クエリエディターを離れることなく、シームレスなデータ検証、レポート、共有ワークフローをサポートするように設計されています。

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

クエリエディターでは、パラメーター化されたクエリをサポートしています。これにより、SQL ステートメントに変数を挿入し、実行時に値を動的に割り当てることができます。 この機能は、再利用可能なクエリを簡素化し、ワークフローの柔軟性を向上させるのに役立ちます。

クエリの書き込み時にパラメーターを定義し、​ クエリパラメーター タブを介して値を割り当ててから、クエリを実行できます。 パラメータ化されたクエリは、スケジュールされたクエリや、組織全体で共有されるクエリテンプレートに特に役立ちます。

パラメーターの定義と使用方法については、​ クエリエディターのパラメーター化されたクエリ ​を参照してください。

スケジュール済みクエリ scheduled-queries

既にテンプレートとして保存されているクエリは、定期的に実行するようにスケジュールできます。 クエリのスケジュールを設定する際に、実行の頻度、開始日と終了日、スケジュールされたクエリの実行日、クエリをエクスポートするデータセットを選択できます。 クエリスケジュールは、クエリエディターを使用して設定します。

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

クエリがスケジュールされると、​ スケジュール済みクエリ ​ タブのスケジュール済みクエリのリストに表示されます。 クエリ、実行、作成者、タイミングに関する詳細は、リストからスケジュールされたクエリを選択して確認できます。

​ スケジュール済みクエリ タブが強調表示され、クエリ スケジュールの行が表示されているクエリ ワークスペース。

説明
名前
名前フィールドは、テンプレート名か SQL クエリの最初の数文字のどちらかです。 クエリエディターを使用して UI から作成したクエリは、開始時に名前が付けられます。 クエリがAPIを介して作成された場合、クエリの名前は、クエリの作成に使用された最初のSQLのスニペットになります。
テンプレート
クエリのテンプレート名。 テンプレート名を選択してクエリエディターに移動します。 便宜上、クエリエディターにクエリテンプレートが表示されます。 テンプレート名がない場合、行はハイフンでマークされ、クエリエディターにリダイレクトしてクエリを表示することはできません。
SQL
SQL クエリのスニペット。
実行頻度
この列は、クエリの実行頻度を示します。 指定可能な値は Run onceScheduled です。 クエリは、実行頻度に従ってフィルタリングできます。
作成者
クエリを作成したユーザーの名前。
作成日
クエリが作成されたときのタイムスタンプ(UTC 形式)。
前回の実行タイムスタンプ
クエリ実行時の最新のタイムスタンプ。 この列では、現在のスケジュールに従ってクエリが実行されたかどうかがハイライト表示されます。
前回の実行ステータス
最新のクエリ実行ステータス。 ステータス値は successfulfailedin progress のいずれかです。

クエリサービス UI🔗を使用してクエリを監視する方法について詳しくは、ドキュメントを参照してください。

テンプレート browse

テンプレート」タブには、組織内のユーザーが保存したクエリが表示されます。 これらをクエリプロジェクトと考えると便利です。ここで保存したクエリは、まだ作成中の可能性があります。 「テンプレート」タブに表示されるクエリは、以前にクエリサービスによって実行された場合、「ログ」タブにも実行クエリとして表示されます。

保存済みのクエリが複数表示された「クエリダッシュボードのテンプレート」タブのズームインビュー。

説明
名前
名前フィールドは、ユーザーが作成したクエリ名か、SQL クエリの最初の数文字のどちらかです。 クエリエディターを使用して UI から作成したクエリは、開始時に名前が付けられます。 API を使用してクエリが作成された場合、クエリの名前は、クエリの作成に使用された最初の SQL のスニペットになります。 クエリ名を選択して、クエリエディターでクエリを開くことができます。 検索バーを使用して、クエリの名前を検索することもできます。 検索では大文字と小文字が区別されます。
SQL
SQL クエリの最初の数文字。 コードの上にカーソルを置くと、完全なクエリが表示されます。
変更者
最後にクエリを変更したユーザー。 クエリサービスへのアクセス権を持つ、組織内のすべてのユーザーがクエリを変更できます。
最終変更日
ブラウザーのタイムゾーンでの、クエリが最後に編集された日付と時間。

Experience Platform UIのテンプレートについて詳しくは、​ クエリテンプレート ​のドキュメントを参照してください。

ログ log

ログ」タブには、以前に実行されたクエリのリストが表示されます。 デフォルトでは、ログはクエリを逆年代順にリストします。

クエリダッシュボードの「ログ」タブに、クエリのリストが時系列順に表示されたズームインビュー。

説明
名前
クエリ名。SQL クエリの最初の数文字で構成されます。 テンプレート名を選択して、その実行の​ クエリログの詳細 ビューを開きます。 検索バーを使用して、クエリの名前を検索できます。 検索では大文字と小文字が区別されます。
開始時間
クエリが実行された時間。
完了時間
クエリの実行が完了した時間。
ステータス
クエリの現在の状態。
データセット
クエリが使用する入力データセット。 データセットを選択して、入力データセットの詳細画面に移動します。
クライアント
クエリに使用されるクライアント。
作成者
クエリを作成した人物の名前。
NOTE
鉛筆アイコン( 鉛筆アイコン。 )を選択します。 クエリ・ログの任意の行からクエリ・エディタに移動します。 クエリは、便利な編集のために事前入力されています。

クエリイベントによって自動的に生成されるログファイルについて詳しくは、​ クエリログのドキュメント ​を参照してください。

資格情報

資格情報」タブには、期限切れの資格情報と期限切れでない資格情報の両方が表示されます。 これらの資格情報を使用して外部クライアントと接続する方法について詳しくは、資格情報ガイドを参照してください。

「資格情報」タブがハイライト表示されたクエリダッシュボード

管理 admin

管理者」タブを使用して、組織全体の同時クエリエディターセッションを監視および管理します。 この機能は管理者向けであり、クエリの作成や実行には必要ありません。

管理者 タブから、管理者はサンドボックス間でアクティブなセッションを表示し、アイドルセッションを終了して共有容量を解放できます。 このアクションは、アクティブに実行されているクエリを中断しません。 詳細な手順と権限の要件については、​ クエリサービスのセッション管理ガイド ​を参照してください。

次の手順

これで、Experience Platformのクエリサービス ユーザーインターフェイスを理解できました。クエリエディターにアクセスして、独自のクエリプロジェクトの作成を開始し、組織内の他のユーザーと共有できます。 クエリエディターでのクエリの作成と実行について詳しくは、クエリエディターのユーザーガイドを参照してください。

recommendation-more-help
experience-platform-help-query-service