Query Editor UI ガイド
Query Editor は、Adobe Experience Platform Query Service が提供するインタラクティブなツールで、Experience Platform ユーザーインターフェイス内でカスタマーエクスペリエンス（顧客体験）データのクエリを記述、検証および実行できます。Query Editor では、分析およびデータ調査のためのクエリを開発できます。また、開発目的でインタラクティブクエリを実行できるほか、非インタラクティブクエリを実行して Experience Platform のデータセットに入力することもできます。
Query Service の概念と機能について詳しくは、クエリサービスの概要を参照してください。Platform 上でクエリサービスのユーザーインターフェイスを操作する方法について詳しくは、クエリサービス UI の概要を参照してください。
はじめに getting-started
Query Editor は、に接続することで、クエリを柔軟に実行できます。 Query Service、およびクエリは、この接続がアクティブなときにのみ実行されます。
Query Editor へのアクセス accessing-query-editor
Experience Platform UI で、左側のナビゲーションメニューの「クエリ」を選択して、Query Service ワークスペースを開きます。次に、クエリの記述を開始するには、を選択します クエリを作成 をクリックします。 このリンクは、Query Service ワークスペースのどのページからも利用できます。
Query Service への接続 connecting-to-query-service
クエリエディターを開くと、クエリサービスが初期化され接続されるまでに数秒かかります。 クエリサービスに接続されると、コンソールに表示されます（以下を参照）。エディターがクエリサービスに接続される前にクエリを実行しようとすると、接続が完了するまで実行が待機されます。
Query Editor からのクエリの実行方法 run-a-query
から実行されたクエリ Query Editor をインタラクティブに実行します。つまり、ブラウザーを閉じたり、ブラウザーから移動したりすると、クエリはキャンセルされます。 クエリ出力からデータセットを生成するように作成されたクエリについても、同じことが言えます。
クエリエディターの拡張版では、クエリエディターに複数のクエリを書き込み、すべてのクエリを順番に実行できます。 の節を参照してください。 複数の順次クエリの実行 を参照してください。
Query Editor を使用したクエリオーサリング query-authoring
Query Editor を使用すると、顧客体験データのクエリを記述、実行および保存できます。Query Editor で実行または保存されたすべてのクエリは、Query Service にアクセスできる組織内のすべてのユーザーが利用できます。
クエリエディターの切り替え機能の強化 enhanced-editor-toggle
UI の切り替えにより、クエリエディターのレガシーバージョンと拡張バージョンを切り替えることができます。 レガシーバージョンはデフォルトで有効になっていますが、拡張バージョンはアクセシビリティと複数テーマのサポートを強化します。拡張バージョンを有効にして、クエリエディター設定にアクセスします。
切替スイッチをアクティブ化すると、エディターがライトテーマに切り替わり、構文の読みやすさが向上します。 オートコンプリート切り替えを組み込んだクエリエディター入力フィールドの上に、設定アイコンも表示されます。 設定アイコンから、ダークテーマを有効にしたり、オートコンプリートを無効/有効にしたりできます。
暗いテーマまたは明るいテーマを有効にするには、設定アイコン（
複数の順次クエリの実行 execute-multiple-sequential-queries
クエリエディターの強化版を使用すると、クエリエディターで複数のクエリを記述し、すべてのクエリを順番に実行できます。
複数のクエリを順番に実行すると、それぞれログエントリが生成されます。 ただし、クエリエディターコンソールには、最初のクエリの結果のみが表示されます。 実行されたクエリのトラブルシューティングや確認が必要な場合は、クエリログを確認します。 を参照してください。 クエリログのドキュメント を参照してください。
選択したクエリの実行 execute-selected-query
複数のクエリを記述したが、実行する必要があるクエリが 1 つだけの場合は、選択したクエリをハイライト表示し、
選択したクエリを実行 アイコン。 このアイコンは、エディター内でクエリ構文を選択するまで、デフォルトで無効になっています。
結果数 result-count
クエリエディターの出力行は最大 50,000 行です。 クエリエディターコンソールに一度に表示する行数を選択できます。 コンソールに表示される行数を変更するには、 結果数 50、100、150、300、500 の各オプションからドロップダウンおよび選択できます。
クエリの記述 writing-queries
クエリエディターは、クエリをできるだけ簡単に記述できるように構成されています。次のスクリーンショットは、UI でエディターがどのように表示されるかを示しています。ここでは、SQL 入力フィールドと「再生」がハイライト表示されています。
開発時間を最小限に抑えるために、返される行数に制限のあるクエリを開発することをお勧めします。 たとえば、SELECT fields FROM table WHERE conditions LIMIT number_of_rows のように設定します。クエリが目的どおりの出力を生成することを確認したら、制限を解除して、CREATE TABLE tablename AS SELECT と設定してクエリを実行し、データセットを生成します。
Query Editor の記述ツール writing-tools
- 構文の自動ハイライト表示： SQL の読み取りと構成が容易になります。
- SQL キーワードのオートコンプリート： クエリの入力を開始し、矢印キーを使用して目的の用語に移動して、Enter キーを押します。
- テーブルとフィールドのオートコンプリート：
SELECT元のテーブル名の入力を開始し、矢印キーを使用して目的の表に移動して、Enter キーを押します。テーブルが選択されると、オートコンプリートはそのテーブル内のフィールドを認識します。
テキストの書式設定 format-text
この テキストの書式設定 この機能は、標準化された構文スタイルを追加することで、クエリをわかりやすくします。 を選択 テキストの書式設定 クエリエディター内のすべてのテキストを標準化します。
SQL をコピー copy-sql
コピーアイコンを選択して、クエリエディターからクリップボードに SQL をコピーします。 このコピー機能は、クエリテンプレートと、クエリエディターで新しく作成されたクエリの両方で使用できます。
オートコンプリート UI 設定の切り替え auto-complete
Query Editor では、クエリの記述時に、可能性のある SQL キーワードとテーブル名または列名の候補を自動的に表示します。オートコンプリート機能はデフォルトで有効になっており、クエリエディターの右上にある構文のオートコンプリートを切り替えることで、いつでも無効または有効にすることができます。
オートコンプリートの設定はユーザーごとに行われ、そのユーザーが次にログインしたときも記憶されています。
この機能を無効にすると、いくつかのメタデータコマンドが処理されなくなり、クエリの編集時に作成者のスピードアップにつながるレコメンデーションが提案されます。
切り替えスイッチを使用してオートコンプリート機能を有効にすると、短い一時停止の後、テーブル名や列名の推奨候補や SQL キーワードを使用できるようになります。 クエリエディターの下のコンソールに表示される成功メッセージは、この機能がアクティブであることを示します。
オートコンプリート機能を無効にした場合は、ページを更新して設定を反映させる必要があります。 構文のオートコンプリート切り替えを無効にすると、3 つのオプションを含んだ確認ダイアログが表示されます。
- キャンセル
- 変更を保存して更新
- 変更を保存せずに更新
オートコンプリート機能を無効にするには、適切な確認オプションを選択します。
エラーの検出 error-detection
Query Editor は、クエリを記述する際に自動的に検証を行い、汎用 SQL 検証と特定の実行検証を行ないます。以下の画像のように、クエリの下に赤い下線が表示される場合は、クエリ内にエラーがあります。
エラーが検出された場合、SQL コードの上にカーソルを置くと、特定のエラーメッセージが表示されます。
クエリの詳細 query-details
クエリエディターでクエリを表示するには、保存済みのテンプレートを次から選択します テンプレート タブ。 クエリの詳細パネルには、選択したクエリを管理するための詳細情報とツールが表示されます。 また、クエリの最終変更日時や最終変更者（該当する場合）などの便利なメタデータも表示されます。
詳細パネルでは、UI から直接出力データセットを生成したり、表示されたクエリを削除または名前付けしたり、クエリ実行スケジュールを表示したり、クエリをスケジュールに追加したりできます。
出力データセットを生成するには、以下を選択します CTAS として実行. この 出力データセットの詳細を入力 ダイアログが表示されます。 名前と説明を入力し、選択します CTAS として実行. 新しいデータセットがに表示されます データセット 「参照」タブ 参照： データセットの表示ドキュメント 組織で使用可能なデータセットの詳細については、こちらを参照してください。
を実行した後、 CTAS として実行 アクションが実行されると、確認メッセージがポップアップ表示され、アクションが成功したことが通知されます。 このポップアップメッセージには、クエリログワークスペースに移動するのに便利な方法を提供するリンクが含まれています。 を参照してください。 クエリログのドキュメント クエリログについて詳しくは、こちらを参照してください。
クエリの保存 saving-queries
Query Editor にはクエリを保存して後で作業できる保存機能があります。クエリを保存するには、次を選択します 保存 右上隅に Query Editor. クエリを保存する前に、クエリの詳細 パネルを使用してクエリに名前を付ける必要があります。
クエリエディターでクエリを保存すると、確認メッセージがポップアップ表示され、アクションが成功したことが通知されます。 このポップアップメッセージには、クエリスケジュールワークスペースに移動する便利な方法を提供するリンクが含まれています。 を参照してください。 クエリのスケジュール設定ドキュメント カスタムケイデンスでクエリを実行する方法を説明します。
スケジュール済みクエリ scheduled-queries
テンプレートとして保存したクエリは、クエリエディターからスケジュールできます。 クエリをスケジュール設定すると、カスタムケイデンスでクエリの実行を自動化できます。 頻度、日時に基づいてクエリのスケジュールを設定したり、必要に応じて結果の出力データセットを選択したりできます。 クエリスケジュールは、UI から無効または削除することもできます。
スケジュールは、クエリエディターで設定します。 クエリエディターを使用する場合、既に作成、保存、実行されたクエリにのみスケジュールを追加できます。 次の場合も同じ制限は適用されません。 Query Service API:
方法については、クエリスケジュールのドキュメントを参照してください ui でのクエリスケジュールの作成. または、API を使用してスケジュールを追加する方法については、以下を参照してください。 スケジュール済みクエリエンドポイントガイド.
スケジュールされたクエリが「」のリストに追加されます スケジュール済みクエリ タブ。 そのワークスペースから、UI を使用して、スケジュールされたすべてのクエリジョブのステータスを監視できます。 日 スケジュール済みクエリ タブでは、クエリの実行に関する重要な情報を見つけたり、アラートを購読したりできます。 使用可能な情報には、ステータス、スケジュールの詳細、実行が失敗した場合のエラーメッセージ/コードが含まれます。 を参照してください。 スケジュール済みクエリドキュメントの監視 を参照してください。
以前のクエリを検索する方法 previous-queries
Query Editor で実行したクエリはすべて「ログ」テーブルに保存されます。「ログ」タブの検索機能を使用して、クエリの実行を検索できます。保存したクエリは「テンプレート」タブに表示されます。
クエリがスケジュールされている場合、「スケジュールされたクエリ」タブでは、UI を使用してこれらのクエリジョブをより明確に表示できます。 詳しくは、クエリ監視のドキュメントを参照してください。
クエリエディターを使用してクエリを実行する executing-queries
Query Editor でクエリを実行するには、エディターに SQL を入力するか、「ログ」タブまたは「テンプレート」タブから以前のクエリを読み込み、「再生」を選択します。クエリ実行のステータスは下の「コンソール」タブに表示され、出力データは「結果」タブに表示されます。
コンソール console
コンソールには、Query Service のステータスと処理に関する情報が表示されます。コンソールには、Query Service への接続状態、実行中のクエリ操作、およびこれらのクエリによるエラーメッセージが表示されます。
クエリの結果 query-results
クエリが完了すると、結果が「コンソール」タブの横の「結果」タブに表示されます。この表示には、クエリの表形式出力が表示され、選択した結果に応じて 50～500 行の結果が表示されます 結果数. このビューを使用すると、クエリが目的どおりの出力を生成することを確認できます。クエリでデータセットを生成するには、返される行の制限を解除し、CREATE TABLE tablename AS SELECT と設定してクエリを実行します。Query Editor でクエリの結果からデータセットを生成する方法については、データセットの生成についてのチュートリアルを参照してください。
ユースケース use-cases
クエリサービスは、業界やビジネスシナリオをまたいだ様々なユースケースに対するソリューションを提供します。 これらの実例は、サービスが多様なニーズに対応する上で柔軟性と効果を発揮していることを示しています。 終了 クエリサービスを使用して、特定のビジネスニーズにどのように価値を提供できるかを明らかにしますの使用例に関するドキュメントの包括的なコレクションを確認します。 クエリサービスを使用して、運用効率とビジネス成功を強化するためのインサイトとソリューションを提供する方法を説明します。
Query Service チュートリアルビデオを使用したクエリの実行 query-tutorial-video
次のビデオでは、Adobe Experience Platform インターフェイスおよび PSQL クライアントでクエリを実行する方法を説明します。 また、このビデオでは、XDM オブジェクト内での個々のプロパティの使用、Adobe定義関数、CREATE TABLE AS SELECT （CTAS）クエリの使用方法についても説明します。
次の手順
Query Editor で使用できる機能とアプリケーションの操作方法について説明しました。これで、独自のクエリを Platform で直接記述できます。Data Lake のデータセットに対して SQL クエリを実行する方法については、クエリの実行に関するガイドを参照してください。