Query Editor UI ガイド

Query Editor はAdobe Experience Platformが提供するインタラクティブなツ Query Serviceールで、ユーザーインターフェイス内で顧客体験データのクエリを記述、検証、実行 Experience Platform できます。Query Editor は、分析およびデータ調査のためのクエリの開発をサポートし、開発用にインタラクティブクエリを実行したり、にデータセットを設定する非インタラクティブクエリを実行したりでき Experience Platformます。

Query Serviceの概念と機能について詳しくは、「クエリサービスの概要」を参照してください。 Platform上でクエリサービスのユーザーインターフェイスを操作する方法について詳しくは、クエリサービスのUIの概要を参照してください。

概要

Query Editor には、に接続することでクエリを柔軟に実行で Query Serviceきます。クエリは、この接続がアクティブな間にのみ実行されます。

Query Serviceに接続中

Query Editor は、開いたときに、初期化と接続に数秒 Query Service かかります。クエリサービスに接続されると、コンソールに示されます(以下を参照)。エディターがクエリサービスに接続される前にクエリを実行しようとすると、接続が完了するまで実行が待機されます。

画像

Query Editorからのクエリの実行方法

Query Editorから実行されたクエリは、インタラクティブに実行されます。 つまり、ブラウザーを閉じたり、別の場所に移動したりすると、クエリはキャンセルされます。また、クエリ出力からデータセットを生成するために実行するクエリも同様です。

Query Editorを使用したクエリオーサリング

Query Editorを使用すると、顧客体験データのクエリを記述、実行、保存できます。 Query Editorで実行または保存されたすべてのクエリは、Query Serviceへのアクセス権を持つ組織のすべてのユーザーが使用できます。

Query Editor へのアクセス

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

画像

クエリの記述

クエリエディターは、クエリをできるだけ簡単に記述できるように構成されています。次のスクリーンショットは、UI でエディターがどのように表示されるかを示しています。ここでは、プレイする​ボタンと SQL 入力フィールドがハイライトされています。

画像

開発時間を最小限に抑えるために、返される行を制限してクエリを開発することをお勧めします。たとえば、SELECT fields FROM table WHERE conditions LIMIT number_of_rows のように設定します。クエリが目的どおりの出力を生成することを確認したら、制限を解除して、CREATE TABLE tablename AS SELECT と設定してクエリを実行し、データセットを生成します。

Query Editorの書き込みツール

  • 構文の自動ハイライト: SQL の読み取りと構成が容易になります。

画像

  • SQL キーワードのオートコンプリート:​クエリの入力を開始し、矢印キーを使用して目的の用語に移動して、Enter キーを押します。

画像

  • テーブルとフィールドのオートコンプリートSELECT 元のテーブル名の入力を開始し、矢印キーを使用して目的の表に移動して、Enter キーを押します。テーブルを選択すると、オートコンプリートによってそのテーブルのフィールドが認識されます。

画像

エラーの検出

Query Editor 一般的なSQL検証と特定の実行検証を提供し、書き込み時にクエリが自動的に検証されます。以下の画像のように、クエリの下に赤い下線が表示される場合は、クエリ内にエラーがあります。

画像

エラーが検出された場合、SQL コードの上にカーソルを置くと、特定のエラーメッセージが表示されます。

画像

クエリの詳細

Query Editorでクエリを表示している間、クエリの詳細​パネルには、選択したクエリを管理するためのツールが表示されます。

画像

このパネルでは、UI から出力データセットを直接生成したり、表示されたクエリを削除したり、クエリに名前を付けたりすることができます。また、「SQL クエリ」タブには、SQL コードが簡単にコピーできる形式で表示されます。このパネルには、クエリの最終変更日時や最終変更者(該当する場合)などの有効なメタデータも表示されます。データセットを生成するには、「データセットを出力」を選択します。 データセットを出力​ダイアログが表示されます。名前と説明を入力し、「クエリを実行」を選択します。 新しいデータセットは、PlatformのQuery Serviceユーザーインターフェイスの「データセット」タブに表示されます。

クエリの保存

Query Editor には、クエリを保存し、後で操作するための保存関数が用意されています。クエリを保存するには、Query Editorの右上隅にある「保存」を選択します。 クエリを保存する前に、クエリの詳細​パネルを使用してクエリに名前を付ける必要があります。

以前のクエリを検索する方法

Query Editorから実行されたすべてのクエリは、ログテーブルにキャプチャされます。 「ログ」タブの検索機能を使用して、クエリの実行を検索できます。保存したクエリは「参照」タブに表 示されます。

詳しくは、クエリサービス UI の概要を参照してください。

メモ

実行されなかったクエリは「ログ」に保存されません。Query Serviceでクエリを使用するには、Query Editorでクエリを実行または保存する必要があります。

クエリエディターを使用してクエリを実行する

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

コンソール

コンソールは、Query Serviceの状態と操作に関する情報を提供します。 コンソールには、Query Serviceへの接続状態、実行中のクエリ操作、およびこれらのクエリによって生じたエラーメッセージが表示されます。

画像

メモ

コンソールには、クエリの実行時に発生したエラーのみが表示されます。クエリを実行する前に、クエリ検証エラーは表示されません。

クエリの結果

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

画像

Query Serviceチュートリアルビデオでクエリを実行

次のビデオでは、Adobe Experience PlatformインターフェイスおよびPSQLクライアントでクエリを実行する方法を示します。 さらに、XDMオブジェクトでの個々のプロパティの使用、Adobe定義関数の使用、CREATE TABLE AS SELECT(CTAS)の使用が示されます。

次の手順

これで、Query Editorで使用できる機能とアプリケーションの操作方法がわかったので、Platformで直接独自のクエリの作成を開始できます。 Data Lake内のデータセットに対してSQLクエリを実行する方法について詳しくは、クエリの実行に関するガイドを参照してください。

このページ