クエリエディター UI ガイド
クエリエディターは、Adobe Experience Platform クエリサービスから提供されるインタラクティブなツールで、これを使用すれば、Experience Platform ユーザーインターフェイス内でカスタマーエクスペリエンス（顧客体験）データのクエリを記述、検証および実行できます。 クエリエディターでは、分析およびデータ調査のためのクエリを作成できます。また、開発目的でインタラクティブクエリを実行できるほか、非インタラクティブクエリを実行して Experience Platform のデータセットに入力することもできます。
クエリサービスの概念と機能について詳しくは、「Query Service overview」を参照してください。Experience Platform 上でクエリサービスのユーザーインターフェイスを操作する方法について詳しくは、クエリサービス UI の概要を参照してください。
はじめに getting-started
クエリエディターでは、クエリサービスに接続することでクエリを柔軟に実行できます。クエリは、この接続がアクティブなときにのみ実行されます。
クエリエディターへのアクセス accessing-query-editor
Experience Platform UI で、左側のナビゲーションメニューの「Queries」を選択して、クエリサービス ワークスペースを開きます。 次に、クエリの記述を開始するには、画面の右上にある「Create Query」を選択します。 このリンクは、クエリサービスのワークスペースのどのページからも利用できます。
クエリサービスへの接続 connecting-to-query-service
クエリエディターを開くと、クエリサービスが初期化され接続されるまでに数秒かかります。 クエリサービスに接続されると、コンソールに表示されます（以下を参照）。エディターがクエリサービスに接続される前にクエリを実行しようとすると、接続が完了するまで実行が待機されます。
クエリエディターからのクエリの実行 run-a-query
クエリエディターから実行されるクエリはインタラクティブに実行されるので、ブラウザーを閉じたり、ブラウザーから移動したりすると、クエリがキャンセルされます。 クエリ出力からデータセットを生成するように作成されたクエリについても、同じことが言えます。
拡張クエリエディターを使用したクエリオーサリング query-authoring
クエリエディターを使用して、顧客体験データのクエリを記述、実行および保存できます。クエリエディターで実行または保存されたすべてのクエリは、クエリサービスにアクセスできる組織内のすべてのユーザーが利用できます。
データベースセレクター database-selector
クエリエディターの右上にあるドロップダウンメニューから、クエリするデータベースを選択します。 選択したデータベースがドロップダウンに表示されます。
設定 settings
クエリエディター入力フィールドの上にある設定アイコンには、ダークテーマを有効/無効にするオプションや、オートコンプリートを無効/有効にするオプションが含まれています。
暗いテーマまたは明るいテーマを有効にするには、設定アイコン（
オートコンプリート auto-complete
クエリエディターでは、クエリの記述時に、可能性のある SQL キーワードとテーブル名または列名の候補を自動的に表示します。 オートコンプリート機能はデフォルトで有効になっており、クエリエディターの設定で、いつでも無効または有効にすることができます。
オートコンプリートの設定はユーザーごとに行われ、そのユーザーが次にログインしたときも記憶されています。 この機能を無効にすると、いくつかのメタデータコマンドが処理されなくなり、クエリの編集時に作成者のスピードアップにつながるレコメンデーションが提案されます。
複数の順次クエリの実行 execute-multiple-sequential-queries
拡張クエリエディターを使用すると、複数のクエリを記述し、すべてのクエリを順番に実行できます。 複数のクエリを順番に実行すると、それぞれログエントリが生成されます。 ただし、クエリエディターコンソールには、最初のクエリの結果のみが表示されます。 実行されたクエリのトラブルシューティングや確認が必要な場合は、クエリログを確認します。 詳しくは、 クエリログドキュメント を参照してください。
選択したクエリの実行 execute-selected-query
複数のクエリを記述したが、実行する必要があるクエリが 1 つだけの場合は、選択したクエリをハイライト表示し、
Run selected query アイコン。 このアイコンは、エディター内でクエリ構文を選択するまで、デフォルトで無効になっています。
クエリエディターセッションをキャンセル cancel-query
長時間実行されるクエリをキャンセルすることで、クエリの実行を制御し、生産性を向上させます。 このアクションは、クエリの実行中にクエリエディターをクリアします。 クエリは引き続きバックグラウンドで実行されることに注意してください。 CTAS クエリの場合でも、出力データセットが生成されます。 エディターでの実行をキャンセルして SQL 文の作成を続行するには、クエリを実行した後で Cancel query を選択します。
確認ダイアログが表示されます。 「Confirm」を選択すると、クエリの実行がキャンセルされます。
結果数 result-count
クエリエディターの出力行は最大 50,000 行です。 クエリエディターコンソールに一度に表示する行数を選択できます。 コンソールに表示される行数を変更するには、「Result count」ドロップダウンを選択し、「50」、「100」、「150」、「300」、「500」、「1000」の中から選択します。
クエリの記述 writing-queries
クエリ Query Editor できるだけ簡単に記述できるように構成されています。 次のスクリーンショットは、UI でエディターがどのように表示されるかを示しています。ここでは、SQL 入力フィールドと「再生」がハイライト表示されています。
開発時間を最小限に抑えるために、返される行数に制限のあるクエリを開発することをお勧めします。 たとえば、SELECT fields FROM table WHERE conditions LIMIT number_of_rows のように設定します。クエリが目的どおりの出力を生成することを確認したら、制限を解除して、CREATE TABLE tablename AS SELECT と設定してクエリを実行し、データセットを生成します。
クエリエディターの記述ツール writing-tools
クエリエディターの記述ツールを使用して、クエリオーサリングプロセスを強化します。 機能には、テキストの書式設定、SQL のコピー、クエリの詳細の管理、進行状況に応じた作業内容の保存またはスケジュール設定を行うオプションが含まれています。
テキストを書式設定 format-text
Format text 機能を使用すると、標準化された構文スタイルを追加して、クエリをわかりやすくすることができます。 「Format text」を選択すると、クエリエディター内のすべてのテキストが標準化されます。
SQL をコピー copy-sql
コピーアイコンを選択して、クエリエディターからクリップボードに SQL をコピーします。 このコピー機能は、クエリテンプレートと、クエリエディターで新しく作成されたクエリの両方で使用できます。
クエリの詳細 query-details
クエリエディターでクエリを表示するには、「Templates」タブから保存済みのテンプレートを選択します。 クエリの詳細パネルには、選択したクエリを管理するための詳細情報とツールが表示されます。 また、クエリの最終変更日時や最終変更者（該当する場合）などの便利なメタデータも表示されます。
詳細パネルでは、UI から直接出力データセットを生成したり、表示されたクエリを削除または名前付けしたり、クエリ実行スケジュールを表示したり、クエリをスケジュールに追加したりできます。
出力データセットを生成するには、「Run as CTAS」を選択します。 Enter output dataset details ダイアログが表示されます。 名前と説明を入力し、「Run as CTAS」を選択します。 新しいデータセットが、「Datasets ータ参照」タブに表示されます。 組織で使用可能なデータセットについて詳しくは、 データセットの表示に関するドキュメント を参照してください。
Run as CTAS アクションを実行すると、確認メッセージがポップアップ表示され、アクションが成功したことが通知されます。 このポップアップメッセージには、クエリログワークスペースに移動するのに便利な方法を提供するリンクが含まれています。 クエリログについて詳しくは、 クエリログドキュメント を参照してください。
クエリの保存 saving-queries
クエリエディターには保存機能があり、クエリを保存して後で作業できます。 クエリを保存するには、クエリエディターの右上隅にある「Save」を選択します。 クエリを保存する前に、Query Details パネルを使用してクエリに名前を付ける必要があります。
クエリエディターでクエリを保存すると、確認メッセージがポップアップ表示され、アクションが成功したことが通知されます。 このポップアップメッセージには、クエリスケジュールワークスペースに移動する便利な方法を提供するリンクが含まれています。 カスタムケイデンスでクエリを実行する方法については、 クエリのスケジュール設定ドキュメント を参照してください。
スケジュール済みクエリ scheduled-queries
テンプレートとして保存したクエリは、クエリエディターからスケジュールできます。 クエリをスケジュール設定すると、カスタムケイデンスでクエリの実行を自動化できます。 頻度、日時に基づいてクエリのスケジュールを設定したり、必要に応じて結果の出力データセットを選択したりできます。 クエリスケジュールは、UI から無効または削除することもできます。
スケジュールは、クエリエディターで設定します。 クエリエディターを使用する場合、既に作成および保存されたクエリにのみスケジュールを追加できます。 Query Service API にも同じ制限は適用されません。
UI でクエリスケジュールを作成 する方法については、クエリスケジュールのドキュメントを参照してください。 また、API を使用してスケジュールを追加する方法について詳しくは、 スケジュールされたクエリのエンドポイントガイド を参照してください。
スケジュールされたクエリは、「Scheduled queries」タブのリストに追加されます。 そのワークスペースから、UI を使用して、スケジュールされたすべてのクエリジョブのステータスを監視できます。 「Scheduled queries」タブでは、クエリの実行に関する重要な情報を見つけたり、アラートを購読したりできます。 使用可能な情報には、ステータス、スケジュールの詳細、実行が失敗した場合のエラーメッセージ/コードが含まれます。 詳しくは、 スケジュール済みクエリドキュメントの監視 を参照してください。
以前のクエリを検索する方法 previous-queries
クエリエディターで実行したクエリはすべて「ログ」テーブルに保存されます。「Log」タブの検索機能を使用して、クエリの実行を検索できます。 保存したクエリは「Templates」タブに表示されます。
クエリがスケジュールされている場合、「Scheduled Queries」タブでは、UI を使用してこれらのクエリジョブをより明確に表示できます。 詳しくは、クエリモニタリングのドキュメントを参照してください。
オブジェクトブラウザー object-browser
オブジェクトブラウザーを使用すると、データセットを簡単に検索およびフィルタリングできます。 オブジェクトブラウザーを使用すると、多数のデータセットがある大規模な環境で、テーブルやデータセットの検索に費やす時間を短縮できます。 関連するデータとメタデータへの効率的なアクセスにより、クエリのオーサリングに集中でき、ナビゲーションに集中できなくなります。
オブジェクトブラウザーを使用してデータベース内を移動するには、検索フィールドにテーブル名を入力するか、「Tables」を選択して使用可能なデータセットとテーブルのリストを展開します。 検索フィールドを使用すると、使用可能なテーブルのリストが、入力に基づいて動的にフィルタリングされます。
選択したデータベース に含まれているすべてのデータセットが、クエリエディターの左側のナビゲーションパネルに表示されます。
オブジェクトブラウザーに表示されるスキーマは、観察可能なスキーマです。 つまり、変更が直ちに表示されるので、これを使用して変更と更新をリアルタイムで監視できます。 観測可能なスキーマは、データの同期を確保するのに役立ち、デバッグや分析のタスクに役立ちます。
現在の制限事項 current-limitation
システムではクエリが順番に処理されます。つまり、一度に実行できるクエリは 1 つだけです。 クエリの進行中は、左側のナビゲーションから追加のテーブルにアクセスすることはできません。
テーブルメタデータへのアクセス table-metadata
クイック検索に加えて、テーブル名の横にある「i」アイコンを選択することで、任意のテーブルのメタデータに簡単にアクセスできるようになりました。 これにより、選択したテーブルに関する詳細情報が提供され、クエリを記述する際に十分な情報に基づいた決定を行うのに役立ちます。
子テーブルの調査
子テーブルまたはリンクされたテーブルを検索するには、リスト内のテーブル名の横にあるドロップダウン矢印を選択します。 これにより、テーブルが展開され、関連する子テーブルが表示されます。また、データ構造が明確に表示され、より複雑なクエリ構成が可能になります。 フィールド名の横にあるアイコンは、列のデータタイプを示し、複雑なクエリ中に列のデータタイプを識別するのに役立ちます。
クエリエディターを使用してクエリを実行する executing-queries
クエリエディターでクエリを実行するには、エディターに SQL を入力するか、「Log」タブまたは「Templates」タブから以前のクエリを読み込み、「再生」を選択します。 以下の「Console」タブにクエリの実行状況が表示され、「Results」タブに出力データが表示されます。
コンソール console
コンソールには、クエリサービスのステータスと処理に関する情報が表示されます。コンソールには、クエリサービスへの接続ステータス、実行中のクエリ処理、およびこれらのクエリの実行時に発生したエラーメッセージが表示されます。
クエリの結果 query-results
クエリが完了すると、結果が「Results」タブ（「Console」タブの横）に表示されます。 この表示には、クエリの表形式出力が表示され、選択した 結果数 に応じて 50～1000 行の結果が表示されます。 このビューを使用すると、クエリが目的どおりの出力を生成することを確認できます。クエリでデータセットを生成するには、返される行の制限を解除し、CREATE TABLE tablename AS SELECT と設定してクエリを実行します。クエリエディターでクエリの結果からデータセットを生成する方法については、データセットの生成についてのチュートリアルを参照してください。
クエリ結果のダウンロード download-query-results
クエリが正常に実行されたら、結果を CSV、XLSX または JSON 形式でダウンロードし、オフライン分析、レポートまたはスプレッドシートのワークフローで使用します。 この機能により、オフラインでの分析、レポートおよび Excel ベースのプロセスのクエリ結果にすぐにアクセスできるようになるので、マーケティングチームや分析チームのワークフローが合理化されます。
クエリ結果をダウンロードするには、クエリエディターの Download タブの右上隅にある「Result」を選択します。 次に、ドロップダウンメニューから「CSV」、「XLSX」または「JSON」を選択します。 ファイルがローカルマシンに自動的にダウンロードされます。 ユースケースに合った形式、軽量エクスポートの場合は CSV、フォーマットされたスプレッドシートの場合は XLSX、構造化データ処理の場合は JSON を選択します。
「データが失われる可能性があります。 このブックをコンマ区切り（.csv）形式で保存すると、一部の機能が失われることがあります。 これらの機能を保持するには、Excel ファイル形式で保存します。」
また、日付と時刻の形式は、ファイルタイプによって異なる場合があることに注意してください。 CSV ファイルはクエリ結果に表示される形式を保持しますが、XLSX ファイルは Excel で自動的にローカライズされた形式を適用できます。 この警告が表示された場合は、続行しても問題ありません。 Excel 固有の書式を保持するには、代わりにファイルを XLSX として保存します。
結果を全画面で表示 view-results
クエリが正常に実行されたら、「View results」タブの「Result」を選択して、結果を表形式でフルスクリーン表示で開きます。
フルスクリーンプレビューを使用すると、幅の広いテーブルを簡単にスキャンし、水平スクロールせずに行レベルの詳細を調べることができます。 フルスクリーン表示では、出力がサイズ変更可能なグリッドで表示されるので、大きなデータセットの確認や、列をまたいだスキャンが容易になります。
結果をコピー copy-results
クエリエディターの拡張コピー機能を使用すると、クエリ結果をコンマ区切り値（CSV）でコピーして Excel などのスプレッドシートツールに貼り付け、即座に検証またはレポートを作成できます。 この機能により、サードパーティのツールを使用しなくても、読みやすさが向上し、書式設定が保持され、ワークフローが効率化されます。
クエリ結果は、「Result」タブまたは結果のフルスクリーンのプレビューからコピーできます。 「Result」タブで、コピーアイコン（
または、「View results」を選択して、フルスクリーンプレビューを開きます。 このダイアログから、個々の行を選択するか、左上隅のチェックボックスを使用してすべての行を選択してから、コピーアイコン（
従来の結果テーブル（限定提供） legacy-results-table
従来のバージョンのクエリエディターは、QA やスプレッドシートベースのレビューなど、柔軟な手動のデータワークフローに依存するユーザーを対象としています。
ネイティブのブラウザーベースのドラッグ選択がサポートされるので、標準の選択動作を使用して、出力の任意の部分（個々のセルやブロックを含む）をハイライトしてコピーできます。 これは、構造化行の選択と専用のコピーアクションを使用する拡張テーブルとは対照的です。
コピーされたデータはタブで区切られているので、Excel などのツールに貼り付けた際に、列の位置が固定され、読み取り可能な状態になります。 列ヘッダーは、ヘッダー行全体をドラッグ&選択する際にも含まれます。
例 examples
クエリサービスは、業界やビジネスシナリオをまたいだ様々なユースケースに対するソリューションを提供します。 これらの例は、サービスが多様なニーズに対応する上での柔軟性と影響を示しています。 クエリサービスが特定のビジネスニーズにどのように価値をもたらすことができるかを明らかにする には、ユースケースに関するドキュメントの包括的なコレクションを参照してください。 クエリサービスを使用して、運用効率とビジネス成功を強化するためのインサイトとソリューションを提供する方法を説明します。
クエリサービスを使用したクエリの実行のチュートリアルビデオ query-tutorial-video
次のビデオでは、Adobe Experience Platform インターフェイスおよび PSQL クライアントでクエリを実行する方法を説明します。 また、このビデオでは、XDM オブジェクト内での個々のプロパティの使用、Adobe定義関数、CREATE TABLE AS SELECT （CTAS）クエリの使用方法についても説明します。
同時セッションの監視と管理 monitor-manage-sessions
セッション管理を使用して、サンドボックス間でアクティブなクエリエディターセッションを表示し、アイドル状態のセッションを特定して、共有容量を解放するように終了します。 クエリをアクティブに実行しているセッションを中断することはできません。 この機能は管理者のみを対象としており、Manage Query Session 権限が必要です。
セッション管理にアクセスするには、クエリサービス ワークスペースの「Admin」タブを選択します。 セッションの詳細の表示、セッションステータスの解釈、アイドルセッションの終了の手順については、 クエリサービスセッションの管理 を参照してください。
次の手順
クエリエディターで使用できる機能とアプリケーションの操作方法について説明しました。これで、独自のクエリを Experience Platform で直接記述できます。 Data Lake のデータセットに対して SQL クエリを実行する方法については、クエリの実行に関するガイドを参照してください。