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 から直接出力データセットを生成したり、表示されたクエリを削除または名前を付けたり、クエリにスケジュールを追加したりできます。

このパネルには、クエリの最終変更日時や最終変更者(該当する場合)などの有効なメタデータも表示されます。データセットを生成するには、「データセットを出力」を選択します。 データセットを出力​ダイアログが表示されます。名前と説明を入力し、「クエリを実行」を選択します。 新しいデータセットは、Platform の Query Service ユーザーインターフェイスの「データセット」タブに表示されます。

スケジュール済みクエリ

メモ

スケジュールは、既に作成、保存、実行されたクエリにのみ追加できます。 さらに、 は、パラメータ化されたクエリにスケジュールを追加できません。

クエリにスケジュールを追加するには、「スケジュールを追加」を選択します。

画像

スケジュールの詳細 ページが表示されます。 このページでは、スケジュール済みクエリの頻度、スケジュール済みクエリの実行日、およびクエリのエクスポート先のデータセットを選択できます。

画像

頻度 に対して、次のオプションを選択できます。

  • 1 時間ごと:スケジュール済みクエリは、選択した日付期間に対して 1 時間ごとに実行されます。
  • 毎日:スケジュール済みクエリは、選択した日時と期間に X 日ごとに実行されます。選択した時刻は UTC であり、ローカルのタイムゾーンではありません。
  • 毎週:選択したクエリは、曜日、時間、および選択した日付期間に対して実行されます。選択した時刻は UTC であり、ローカルのタイムゾーンではありません。
  • 毎月:選択したクエリは、毎月、選択した日時と期間に実行されます。選択した時刻は UTC であり、ローカルのタイムゾーンではありません。
  • 年別:選択したクエリは、毎年、選択した日、月、時刻、および日付期間に実行されます。選択した時刻は UTC であり、ローカルのタイムゾーンではありません。

データセットの場合は、既存のデータセットを使用するか、新しいデータセットを作成するかを選択できます。

重要

既存のデータセットを使用するか、新しいデータセットを作成するので、データセットは既に設定されているので、クエリの一部に INSERT INTO または CREATE TABLE AS SELECT を含める必要はありません。​スケジュールされたクエリの一部に INSERT INTO または CREATE TABLE AS SELECT を含めると、エラーが発生します。

これらの詳細をすべて確認したら、「保存」を選択してスケジュールを作成します。

クエリの詳細ページが再び表示され、新しく作成したスケジュールの詳細(スケジュール ID、スケジュール自体、スケジュールの出力データセットなど)が表示されます。 スケジュール ID を使用して、スケジュール済みクエリ自体の実行に関する詳細を検索できます。 詳しくは、『 スケジュール済みクエリ実行エンドポイントガイド 』を参照してください。

メモ

UI を使用して、1 つの クエリテンプレートのみスケジュールできます。 クエリテンプレートにスケジュールを追加する場合は、API を使用する必要があります。 API を使用してスケジュールが既に追加されている場合、UI を使用してスケジュールを追加することは できません。 複数のスケジュールが既にクエリテンプレートに添付されている場合は、最も古いスケジュールのみが表示されます。 API を使用してスケジュールを追加する方法については、『 スケジュール済みクエリエンドポイントガイド 』を参照してください。

また、表示するスケジュールの最新の状態が必要な場合は、ページを更新する必要があります。

スケジュールの削除

スケジュールを削除するには、「スケジュールを削除」を選択します。

画像

重要

クエリのスケジュールを削除する場合は、まずスケジュールを無効にする必要があります。

クエリの保存

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

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

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

詳しくは、クエリサービス 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 クエリを実行する方法については、 クエリの実行 に関するガイドを参照してください。

このページ