Show Menu
トピック×

クエリエディターユーザーガイド

クエリエディターは、Adobe Experience Platformクエリサービスが提供するインタラクティブなツールです。Experience Platformユーザーインターフェイス内で、顧客エクスペリエンスデータのクエリを作成、検証および実行できます。 クエリエディターは、分析およびデータ調査のためのクエリの開発をサポートし、開発目的のインタラクティブクエリと、Experience Platformのデータセットを設定する非インタラクティブクエリを実行できます。
クエリサービスの概念と機能について詳しくは、 クエリサービスの概要を参照してください 。 プラットフォームでクエリサービスのユーザーインターフェイスを操作する方法について詳しくは、 クエリサービスのUIの概要を参照してください

はじめに

クエリエディターは、クエリサービスに接続することで、クエリを柔軟に実行できます。クエリは、この接続がアクティブな間にのみ実行されます。

クエリサービスへの接続

クエリエディターを開くと、クエリサービスの初期化と接続に数秒かかります。 次に示すように、コンソールは接続された時点を示します。 エディタが接続する前にクエリを実行しようとすると、接続が完了するまで実行が遅れます。

クエリをクエリエディタから実行する方法

クエリエディターで実行されたクエリは、対話形式で実行されます。 これは、ブラウザーを閉じた場合や別の場所に移動した場合に、クエリがキャンセルされることを意味します。 これは、クエリ出力からデータセットを生成するクエリにも当てはまります。

クエリエディターを使用したクエリオーサリング

クエリエディターを使用して、顧客体験データのクエリを作成、実行および保存できます。 クエリエディターで実行、または保存されたすべてのクエリは、クエリサービスにアクセスできる組織内のすべてのユーザーが使用できます。

クエリエディタへのアクセス

Experience Platform UIで、左側のナビゲーションメニューの クエリ をクリックして、クエリサービスワークスペースを開きます。 次に、画面の右上にある「 クエリを作成 」をクリックして、クエリを記述します。 このリンクは、クエリサービスワークスペースの任意のページから利用できます。

クエリの作成

クエリエディターは、書き込みクエリをできるだけ簡単にするように構成されています。 下のスクリーンショットは、 ​再生ボタンとSQLエントリフィールドがハイライト表示された状態で、UIにエディターがどのように表示されるかを示しています。
開発に要する時間を最小限に抑えるには、返される行に対する制限を持つクエリを開発することをお勧めします。 例: SELECT fields FROM table WHERE conditions LIMIT number_of_rows 。クエリが期待される出力を生成することを確認したら、制限を解除し、クエリを実行して出力のデータセット CREATE TABLE tablename AS SELECT を生成します。

クエリエディターでのツールの作成

  • 自動構文のハイライト表示: SQLの読み取りと整理を容易にします。
  • SQLキーワードオートコンプリート: 開始がクエリを入力し、矢印キーを使用して目的のキーワードに移動し、 Enterキーを押します
  • テーブルとフィールドのオートコンプリート: 目的のテーブル名を入力した開始が SELECT 、矢印キーを使用して目的のテーブルに移動し、 Enterキーを押します 。 テーブルを選択すると、オートコンプリートでそのテーブル内のフィールドが認識されます。

エラー検出

クエリ・エディタは、クエリの書き込み時に自動的に検証を行い、汎用SQL検証と固有の実行検証を提供します。 クエリの下に赤い下線が引かれている場合(下の画像を参照)は、クエリ内のエラーを表します。
エラーが検出された場合は、SQLコードの上にカーソルを置くと、特定のエラーメッセージを表示できます。

クエリの詳細

クエリエディターでクエリを表示している間、 クエリの詳細 パネルには、選択したクエリを管理するためのツールが表示されます。
このパネルでは、UIから直接出力データセットを生成したり、表示されたクエリを削除または名前を付けたり、SQLコードを表示したり、 SQLクエリ タブに簡単にコピーできる形式で表示したりできます。 このパネルには、クエリが最後に変更されたときや、該当する場合は誰が変更したかなど、有用なメタデータも表示されます。 データセットを生成するには、「 出力データセット 」をクリックします。 # ダイアログが表示されます。 名前と説明を入力し、「クエリを 実行 」をクリックします。 新しいデータセットは、プラットフォームのクエリサービスユーザーインターフェイスの「 データセット 」タブに表示されます。

クエリの保存

クエリエディタには、クエリを保存して後で操作できる保存機能が用意されています。 クエリを保存するには、クエリエディタの右上隅にある 保存 (Save)をクリックします。 クエリを保存する前に、 クエリの詳細 パネルを使用してクエリに名前を指定する必要があります。

以前のクエリの検索方法

クエリエディターから実行されるすべてのクエリは、ログテーブルに取り込まれます。 「 ログ 」タブの検索機能を使用して、クエリ実行を検索できます。 保存したクエリは、「 参照 」タブに表示されます。
詳しくは、 クエリサービスのUIの概要 (英語)を参照してください。
実行されないクエリは、ログに保存されません。 クエリをクエリサービスで使用するには、クエリエディターで実行または保存する必要があります。

クエリエディターを使用したクエリの実行

クエリエディターでクエリを実行するには、エディターでSQLを入力するか、「 ログ 」または「 参照 」タブから前のクエリを読み込み、「 再生 」をクリックします。 クエリ実行のステータスは、下の 「コンソール 」タブに表示され、出力データは「 結果 」タブに表示されます。

コンソール

コンソールは、クエリサービスのステータスと操作に関する情報を提供します。 コンソールには、クエリサービスへの接続状態、実行中のクエリ操作、およびこれらのクエリによって生じたエラーメッセージが表示されます。
コンソールには、クエリの実行に起因するエラーのみが表示されます。 クエリの実行前にクエリの検証エラーは表示されません。

クエリ結果

クエリが完了すると、結果が「 結果 」タブの「 コンソール 」タブの横に表示されます。 この表示は、クエリの表形式の出力を表示します。最大100行まで表示できます。 この表示を使用すると、クエリが期待どおりの出力を生成しているかどうかを確認できます。 クエリーでデータセットを生成するには、返される行に対する制限を解除し、を使用してクエリを実行し、出力データセット CREATE TABLE tablename AS SELECT を生成します。 クエリエディターでクエリ結果からデータセットを生成する方法については、 「データセットの 生成」のチュートリアルを参照してください。

次の手順

これで、クエリエディターの機能とアプリケーションのナビゲーション方法がわかり、独自のクエリを開始オーサリングする際に、Platformを直接使用できます。 Data Lakeでのデータセットに対するSQLクエリの実行の詳細については、『クエリの 実行に関するガイド 』を参照してください。 Adobe AnalyticsとAdobeターゲットデータを使用するSQLクエリのサンプルについては、 サンプルクエリリファレンスを参照してください