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 キーを押します。テーブルを選択すると、オートコンプリートによってそのテーブルのフィールドが認識されます。

画像

エラーの検出

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 ( クエリの実行.

このページ