Query Editor UI ガイド

Query Editor は、Adobe Experience Platform Query Service が提供するインタラクティブなツールで、Experience Platform ユーザーインターフェイス内でカスタマーエクスペリエンス(顧客体験)データのクエリを記述、検証および実行できます。Query Editor では、分析およびデータ調査のためのクエリを開発できます。また、開発目的でインタラクティブクエリを実行できるほか、非インタラクティブクエリを実行して Experience Platform のデータセットに入力することもできます。

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

NOTE
一部のクエリサービス機能は、従来のバージョンのクエリエディターでは提供されていません。 このドキュメントで使用するスクリーンショットは、特に記載がない限り、クエリエディターの拡張バージョンを使用して撮影します。 詳しくは、 クエリエディターの強化 を参照してください。

はじめに 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 にアクセスできる組織内のすべてのユーザーが利用できます。

IMPORTANT
従来のエディターは 2024 年 4 月 1 日に廃止され、使用できなくなります。

クエリエディターの切り替え機能の強化 enhanced-editor-toggle

「UI」切り替えを使用して、クエリエディターのレガシーバージョンと拡張バージョンを切り替えることができます。 レガシーバージョンはデフォルトで有効になっていますが、拡張バージョンはアクセシビリティと複数テーマのサポートを強化します。拡張バージョンを有効にして、クエリエディター設定にアクセスします。

拡張クエリエディター切り替えがハイライト表示されたクエリエディター。

切り替えを有効にすると、エディターが明るいテーマに切り替わり、構文の読みやすさが向上します。 また、オートコンプリート切り替えを組み込むクエリエディター入力フィールドの上に設定アイコンが表示されます。 設定アイコンから、ダークテーマを有効にしたり、オートコンプリートを無効/有効にしたりできます。

TIP
拡張されたクエリエディターを使用すると、次の操作を実行できます。 構文のオートコンプリートを無効にする クエリの作成中に進行状況が失われることはありません。 通常、編集中にオートコンプリート機能を無効にすると、クエリに対するすべての変更が失われます。

暗いテーマまたは明るいテーマを有効にするには、設定アイコン ( 設定アイコン。 ) に続いて、表示されるドロップダウンメニューのオプションが表示されます。

設定アイコンと「ダークテーマを有効にする」ドロップダウンメニューオプションがハイライトされたクエリエディター。

複数の順次クエリを実行 execute-multiple-sequential-queries

クエリエディターの拡張版を使用すると、クエリエディターで複数のクエリを記述し、すべてのクエリを順番に実行できます。

1 つのシーケンスで複数のクエリを実行すると、それぞれログエントリが生成されます。 ただし、最初のクエリの結果のみがクエリエディターコンソールに表示されます。 実行されたクエリのトラブルシューティングや確認が必要な場合は、クエリログを確認します。 詳しくは、 クエリログドキュメント を参照してください。

NOTE
クエリエディターで最初のクエリの後に CTAS クエリが実行された場合でも、テーブルは作成されますが、クエリエディターコンソールには出力はありません。

選択したクエリを実行 execute-selected-query

複数のクエリを記述したが、1 つのクエリのみを実行する必要がある場合は、選択したクエリをハイライト表示し、
選択したクエリを実行 アイコン。 このアイコンは、エディターでクエリ構文を選択するまで、デフォルトでは無効になっています。

クエリエディターと 選択したクエリを実行 アイコンがハイライト表示されます。

結果数 result-count

クエリエディターには、最大 50,000 行の出力があります。 クエリエディターコンソールで一度に表示する行数を選択できます。 コンソールに表示される行数を変更するには、 結果数 ドロップダウンで、50、100、150、300、500 の各オプションを選択します。

結果数ドロップダウンがハイライト表示されたクエリエディター。

クエリの記述 writing-queries

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

SQL 入力フィールドと「再生」がハイライト表示されたクエリエディター

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

Query Editor の記述ツール writing-tools

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

構文カラーハイライト表示の例を示すクエリエディター内の SQL ステートメント

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

クエリエディターで SQL を数文字入力するとオートコンプリートドロップダウンメニューに選択肢が表示される様子

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

クエリエディターに入力するとドロップダウンにテーブル名の候補が表示される様子

テキストの書式設定 format-text

The テキストの書式設定 機能により、標準化された構文スタイルを追加することで、クエリがより読みやすくなります。 選択 テキストの書式設定 を使用して、クエリエディター内のすべてのテキストを標準化します。

NOTE
The テキストの書式設定 機能は匿名ブロックでは動作しません。 1 つ以上の SQL 文を順番にチェーンする方法については、 匿名ブロックドキュメント.

クエリエディターと テキストの書式設定 ハイライト表示された SQL 文

SQL をコピー copy-sql

コピーアイコンを選択して、クエリエディターからクリップボードに SQL をコピーします。 このコピー機能は、クエリテンプレートと、クエリエディターで新しく作成されたクエリの両方で使用できます。

クエリワークスペースには、コピーアイコンが強調表示されたクエリテンプレートの例が表示されています。

オートコンプリート UI 設定の切り替え auto-complete

Query Editor では、クエリの記述時に、可能性のある SQL キーワードとテーブル名または列名の候補を自動的に表示します。オートコンプリート機能はデフォルトで有効になっており、クエリエディターの右上にある構文のオートコンプリートを切り替えることで、いつでも無効または有効にすることができます。

オートコンプリートの設定はユーザーごとに行われ、そのユーザーが次にログインしたときも記憶されています。

NOTE
構文のオートコンプリート切り替えは、クエリエディターの旧バージョンでのみ使用できます。

構文のオートコンプリート切り替えがハイライト表示されたクエリエディター

この機能を無効にすると、いくつかのメタデータコマンドが処理されなくなり、クエリの編集時に作成者のスピードアップにつながるレコメンデーションが提案されます。

切り替えスイッチを使用してオートコンプリート機能を有効にすると、短い一時停止の後、テーブル名や列名の推奨候補や SQL キーワードを使用できるようになります。 クエリエディターの下のコンソールの成功メッセージは、この機能がアクティブであることを示します。

オートコンプリート機能を無効にした場合は、ページを更新して設定を反映させる必要があります。 構文のオートコンプリート切り替えを無効にすると、3 つのオプションを含んだ確認ダイアログが表示されます。

  • キャンセル
  • 変更を保存して更新
  • 変更を保存せずに更新
IMPORTANT
この機能を無効にする際にクエリを作成または編集する場合は、ページを更新する前にクエリに対する変更を保存する必要があります。保存しないと、すべての進行状況が失われます。

オートコンプリート機能を無効にするための確認ダイアログ。

オートコンプリート機能を無効にするには、適切な確認オプションを選択します。

エラーの検出 error-detection

Query Editor は、クエリを記述する際に自動的に検証を行い、汎用 SQL 検証と特定の実行検証を行ないます。以下の画像のように、クエリの下に赤い下線が表示される場合は、クエリ内にエラーがあります。

SQL を赤で下線付きで表示するクエリエディター入力は、エラーを示します。

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

エラーメッセージを含むダイアログ。

クエリの詳細 query-details

クエリエディターにクエリを表示するには、保存済みのテンプレートを テンプレート タブをクリックします。 クエリの詳細パネルには、選択したクエリを管理するための詳細情報とツールが表示されます。 また、クエリが最後に変更された日時や最後に変更したユーザー(該当する場合)などの有用なメタデータも表示されます。

NOTE
The スケジュールを表示, スケジュールを追加 および クエリを削除 オプションは、クエリをテンプレートとして保存した後でのみ使用できます。 The スケジュールを追加 」オプションを選択すると、クエリエディターからスケジュールビルダーに直接移動します。 The スケジュールを表示 「 」オプションを選択すると、そのクエリの在庫を直接スケジュールできます。 方法については、クエリスケジュールのドキュメントを参照してください。 UI でのクエリスケジュールの作成.

クエリの詳細パネルがハイライト表示されたクエリエディター。

詳細パネルから、UI から直接出力データセットを生成し、表示されたクエリを削除または名前を付け、クエリ実行スケジュールを表示し、クエリをスケジュールに追加できます。

出力データセットを生成するには、「 CTAS として実行. The 出力データセットの詳細を入力 ダイアログが表示されます。 名前と説明を入力し、「 」を選択します。 CTAS として実行. 新しいデータセットが データセット 「参照」タブ 詳しくは、 データセットの表示に関するドキュメント を参照して、組織で使用可能なデータセットの詳細を確認してください。

NOTE
The CTAS として実行 オプションは、クエリに not スケジュール済みです。

The 出力データセットの詳細を入力 ダイアログ。

を実行した後、 CTAS として実行 アクションを実行すると、成功したアクションを通知する確認メッセージがポップアップ表示されます。 このポップアップメッセージには、クエリログワークスペースに移動する便利な方法を提供するリンクが含まれています。 詳しくは、 クエリログドキュメント クエリログの詳細を参照してください。

クエリの保存 saving-queries

Query Editor にはクエリを保存して後で作業できる保存機能があります。クエリを保存するには、「 保存 ~の右上隅に Query Editor. クエリを保存する前に、クエリの詳細 ​パネルを使用してクエリに名前を付ける必要があります。

NOTE
クエリエディターを使用してで名前を付けて保存したクエリは、クエリダッシュボードの「テンプレート」タブ内でテンプレートとして使用できます。 詳しくは、テンプレートのドキュメントを参照してください。

クエリエディターでクエリを保存すると、確認メッセージがポップアップ表示され、正常なアクションが示されます。 このポップアップメッセージには、クエリのスケジュール設定ワークスペースに移動する便利な方法を提供するリンクが含まれています。 詳しくは、 スケジュールクエリドキュメント を参照して、カスタムケイデンスに対してクエリを実行する方法を確認してください。

スケジュール済みクエリ scheduled-queries

テンプレートとして保存されたクエリは、クエリエディターでスケジュールできます。 クエリのスケジュール設定を使用すると、カスタムケイデンスでクエリを自動実行できます。 頻度、日付、時刻に基づいてクエリをスケジュールし、必要に応じて結果の出力データセットを選択できます。 クエリスケジュールは、UI で無効にしたり削除したりすることもできます。

スケジュールは、クエリエディターで設定します。 クエリエディターを使用する場合は、既に作成、保存、実行されているクエリにのみスケジュールを追加できます。 同じ制限は、 Query Service API:

方法については、クエリスケジュールのドキュメントを参照してください。 UI でのクエリスケジュールの作成. また、API を使用してスケジュールを追加する方法については、 スケジュール済みクエリエンドポイントガイド.

スケジュール済みクエリは、 スケジュール済みクエリ タブをクリックします。 そのワークスペースから、UI を使用して、スケジュールされたすべてのクエリジョブのステータスを監視できます。 次の日: スケジュール済みクエリ 「 」タブでは、クエリ実行およびアラートの購読に関する重要な情報を確認できます。 使用可能な情報には、ステータス、スケジュールの詳細、実行が失敗した場合のエラーメッセージ/コードが含まれます。 詳しくは、 スケジュール済みクエリドキュメントの監視 を参照してください。

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

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

クエリがスケジュールされている場合、「スケジュールされたクエリ」タブでは、UI を使用してこれらのクエリジョブをより明確に表示できます。 詳しくは、クエリ監視のドキュメントを参照してください。

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

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

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

コンソール console

コンソールには、Query Service のステータスと処理に関する情報が表示されます。コンソールには、Query Service への接続状態、実行中のクエリ操作、およびこれらのクエリによるエラーメッセージが表示されます。

クエリエディターコンソールの「コンソール」タブ

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

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

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb