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 キーワードのオートコンプリート： クエリの入力を開始し、矢印キーを使用して目的の語句に移動して、 入力.
- テーブルとフィールドのオートコンプリート：
SELECT元のテーブル名の入力を開始し、矢印キーを使用して目的の表に移動して、Enter キーを押します。テーブルを選択すると、オートコンプリートによってそのテーブルのフィールドが認識されます。
オートコンプリート UI 設定切り替え
この Query Editor は、クエリの記述時に、SQL のキーワードの候補と、テーブルまたは列の詳細を自動的に示します。 オートコンプリート機能はデフォルトで有効になっており、いつでも 構文のオートコンプリート クエリエディターの右上に切り替えます。
自動完了の構成設定はユーザーごとに行われ、そのユーザーの連続したログインで記憶されます。
この機能を無効にすると、複数のメタデータコマンドが処理されなくなり、クエリの編集時に作成者の速度に役立つレコメンデーションが提供されます。
トグルを使用してオートコンプリート機能を有効にすると、短い一時停止の後、テーブル名や列名の推奨候補や SQL キーワードを使用できるようになります。 クエリエディターの下のコンソールの成功メッセージは、この機能がアクティブであることを示します。
オートコンプリート機能を無効にした場合、この機能を有効にするにはページを更新する必要があります。 を無効にすると、3 つのオプションを含む確認ダイアログが表示されます 構文のオートコンプリート 切り替え：
- キャンセル
- 変更を保存して更新
- 変更を保存せずに更新
この機能を無効にする際にクエリを記述または編集する場合、ページを更新する前にクエリに対する変更を保存する必要があります。保存しないと、すべての進行状況が失われます。
オートコンプリート機能を無効にするには、適切なオプションを選択します。
エラーの検出
Query Editor 一般的な SQL 検証と特定の実行検証を提供し、クエリの記述時にが自動的に検証されます。 以下の画像のように、クエリの下に赤い下線が表示される場合は、クエリ内にエラーがあります。
エラーが検出された場合、SQL コードの上にカーソルを置くと、特定のエラーメッセージが表示されます。
クエリの詳細
でクエリを表示しているとき Query Editor、 クエリの詳細 パネルには、選択したクエリを管理するためのツールが表示されます。
このパネルを使用すると、UI から直接出力データセットを生成し、表示されたクエリを削除または名前を付け、クエリにスケジュールを追加できます。
このパネルには、クエリの最終変更日時や最終変更者（該当する場合）などの有効なメタデータも表示されます。データセットを生成するには、「 データセットを出力. データセットを出力ダイアログが表示されます。名前と説明を入力し、「 」を選択します。 クエリを実行. 新しいデータセットが データセット タブ Query Service のユーザーインターフェイス Platform.
スケジュール済みクエリ
次に、クエリエディターを使用する際の、スケジュール済みクエリの制限事項を示します。 これらは、 Query Service API:
既に作成、保存、実行されたクエリにのみスケジュールを追加できます。
あなた できません パラメータ化クエリにスケジュールを追加します。
スケジュールクエリ できません には、匿名ブロックが含まれています。
クエリにスケジュールを追加するには、 スケジュールを追加.
この スケジュールの詳細 ページが表示されます。 このページでは、スケジュール済みクエリの頻度、スケジュール済みクエリが実行される日付、およびクエリのエクスポート先のデータセットを選択できます。
次のオプションを選択できます。 頻度:
- 毎時:スケジュール済みクエリは、選択した日付期間に対して 1 時間ごとに実行されます。
- 毎日:スケジュール済みクエリは、選択した日時と期間に X 日ごとに実行されます。 選択した時間は UTCローカルタイムゾーンではなく、
- 毎週:選択したクエリは、選択した曜日、時間、および期間に実行されます。 選択した時間は UTCローカルタイムゾーンではなく、
- 毎月:選択したクエリは、毎月、選択した日、時刻、および期間に実行されます。 選択した時間は UTCローカルタイムゾーンではなく、
- 毎年:選択したクエリは、毎年、選択した日、月、時間および期間に実行されます。 選択した時間は UTCローカルタイムゾーンではなく、
データセットの場合は、既存のデータセットを使用するか、新しいデータセットを作成するかのどちらかを選択できます。
既存のデータセットを使用するか、新しいデータセットを作成するので、次の操作をおこないます not 次のいずれかを含める必要があります。 INSERT INTO または CREATE TABLE AS SELECT データセットは既に設定されているので、をクエリの一部として追加します。 次のいずれかを含む INSERT INTO または CREATE TABLE AS SELECT を設定すると、エラーが発生します。
これらの詳細をすべて確認したら、「 」を選択します。 保存 スケジュールを作成します。
クエリの詳細ページが再び表示され、新しく作成したスケジュールの詳細（スケジュール ID、スケジュール自体、スケジュールの出力データセットなど）が表示されます。 スケジュール ID を使用して、スケジュール済みクエリ自体の実行に関する詳細を検索できます。 詳しくは、 スケジュールされたクエリ実行エンドポイントガイド.
スケジュールできるのは 1 つ UI を使用したクエリテンプレート。 クエリテンプレートにスケジュールを追加する場合は、API を使用する必要があります。 API を使用してスケジュールが既に追加されている場合は、次の手順を実行します。 not UI を使用してスケジュールを追加できます。 複数のスケジュールが既にクエリテンプレートにアタッチされている場合は、最も古いスケジュールのみが表示されます。 API を使用してスケジュールを追加する方法については、 スケジュール済みクエリエンドポイントガイド.
また、表示しているスケジュールの最新の状態を確認するには、ページを更新する必要があります。
スケジュールの削除
スケジュールを削除するには、 スケジュールの削除.
クエリのスケジュールを削除する場合は、まずスケジュールを無効にする必要があります。
クエリの保存
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. でのデータセットに対して SQL クエリを実行する方法の詳細 Data Lake ( クエリの実行.
リソース
アドビアカウント
