Query Service UI ガイド

Adobe Experience Platform Query Service は、クエリの書き込みと実行、以前に実行したクエリの表示、組織内のユーザーが保存したクエリへのアクセスに使用できるユーザーインターフェイスを提供します。 Adobe Experience Platform 内の UI にアクセスするには、左側のナビゲーションで「クエリ」を選択します。

Query Editor

Query Editor を使用すると、外部クライアントを使用せずにクエリを書き込んだり、実行したりできます。「クエリを作成」を選択して Query Editor を開き、新しいクエリを作成します。「ログ」タブまたは「テンプレート」タブからクエリを選択して、Query Editor にアクセスすることもできます。以前に実行または保存したクエリを選択すると、Query Editor が開き、選択したクエリの SQL が表示されます。

「クエリの作成」がハイライト表示されたクエリダッシュボード。

Query Editor には、クエリの入力を開始できる編集スペースが用意されています。ユーザーが入力すると、エディターによって、テーブル内の SQL 予約語、テーブル、およびフィールド名が自動入力されます。クエリの作成が完了したら、「再生」ボタンを選択し、クエリを実行します。エディターの下にある「コンソール」タブには、Query Service が現在何を実行しているか、クエリがいつ返されたかが表示されます。コンソールの横にある「結果」タブには、クエリ結果が表示されます。Query Editor の使用について詳しくは、クエリエディターガイドを参照してください。

Query Editorのズームインビュー。

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

テンプレートとして既に保存されているクエリは、定期的に実行するようにスケジュールできます。 クエリをスケジュールする際に、実行頻度、開始日と終了日、スケジュールされたクエリが実行される曜日およびクエリのエクスポート先のデータセットを選択できます。 クエリスケジュールは、クエリエディターを使用して設定します。

UI を使用してクエリをスケジュールする方法については、 スケジュールされたクエリガイドを参照してください。 API を使用してスケジュールを追加する方法について詳しくは、スケジュールされたクエリのエンドポイントガイドを参照してください。

クエリがスケジュールされると、「​ スケジュール済みクエリ ​」タブのスケジュール済みクエリのリストに表示されます。 リストからスケジュール済みクエリを選択すると、クエリ、実行、作成者およびタイミングに関する詳細を確認できます。

「スケジュール済みクエリ」タブがハイライト表示され、クエリスケジュールの行が表示されているクエリワークスペース。

説明
名前
名前フィールドは、テンプレート名か SQL クエリの最初の数文字のどちらかです。 クエリエディターを使用して UI から作成したクエリは、開始時に名前が付けられます。API を使用してクエリが作成された場合、クエリの名前は、クエリの作成に使用された最初の SQL のスニペットになります。
テンプレート
クエリのテンプレート名。 テンプレート名を選択してクエリエディターに移動します。 便宜上、クエリエディターにクエリテンプレートが表示されます。 テンプレート名がない場合、行はハイフンでマークされ、クエリエディターにリダイレクトしてクエリを表示することはできません。
SQL
SQL クエリのスニペット。
実行頻度
これは、クエリを実行するように設定されるケイデンスです。 指定可能な値は Run onceScheduled です。クエリは、実行頻度に従ってフィルタリングできます。
作成者
クエリを作成したユーザーの名前。
作成日
クエリが作成されたときのタイムスタンプ(UTC 形式)。
前回実行されたタイムスタンプ
クエリ実行時の最新のタイムスタンプ。 この列では、現在のスケジュールに従ってクエリが実行されたかどうかがハイライト表示されます。
前回の実行ステータス
最新のクエリ実行ステータス。 ステータス値は successfulfailedin progress のいずれかです。

クエリサービス UI を使用してクエリを監視する方法について詳しくは、ドキュメントを参照してください。

テンプレート browse

テンプレート」タブには、組織のユーザーによって保存されたクエリが表示されます。これらをクエリプロジェクトと考えると便利です。ここで保存したクエリは、まだ作成中の可能性があります。「テンプレート」タブに表示されるクエリは、「ログ」タブに実行クエリとしても表示されます(以前に Query Service によって実行されている場合)。

保存済みのクエリが複数表示された「クエリダッシュボードのテンプレート」タブのズームインビュー。

説明
名前
名前フィールドは、ユーザーが作成したクエリ名か、SQL クエリの最初の数文字のどちらかです。クエリエディターを使用して UI から作成したクエリは、開始時に名前が付けられます。API を使用してクエリが作成された場合、クエリの名前は、クエリの作成に使用された最初の SQL のスニペットになります。クエリ名を選択して、Query Editor でクエリを開くことができます。検索バーを使用して、クエリの名前で検索することもできます。検索では大文字と小文字が区別されます。
SQL
SQL クエリの最初の数文字。コードの上にカーソルを置くと、完全なクエリが表示されます。
変更者
最後にクエリを変更したユーザー。Query Service へのアクセス権を持つ、組織内のすべてのユーザーがクエリを変更できます。
最終変更日
ブラウザーのタイムゾーンでの、クエリが最後に編集された日付と時間。

Platform UI のテンプレートについて詳しくは、 クエリテンプレートのドキュメントを参照してください。

ログ log

ログ」タブには、以前に実行されたクエリのリストが表示されます。デフォルトでは、ログはクエリを逆年代順にリストします。

クエリダッシュボードの「ログ」タブに、クエリのリストが時系列順に表示されたズームインビュー。

説明
名前
クエリ名。SQL クエリの最初の数文字で構成されます。テンプレート名を選択して、その実行の ​ クエリログの詳細 ​ ビューを開きます。 検索バーを使用して、クエリ名で検索できます。 検索では大文字と小文字が区別されます。
開始時刻
クエリが実行された時刻。
完了時間
クエリの実行完了時間。
ステータス
クエリの現在の状態。
データセット
クエリが使用する入力データセット。データセットを選択して、入力データセットの詳細画面に移動します。
クライアント
クエリに使用されるクライアント。
作成者
クエリを作成した人物の名前。

鉛筆アイコン( 鉛筆アイコンを選択します。 )を選択し、クエリログの任意の行から Query Editor に移動します。 クエリは、編集に便利なように事前設定されています。

クエリイベントによって自動生成されるログファイルについて詳しくは、 クエリログのドキュメントを参照してください。

資格情報

資格情報」タブには、有効期限のある資格情報と有効期限のない資格情報の両方が表示されます。これらの資格情報を使用して外部クライアントと接続する方法について詳しくは、資格情報ガイドを参照してください。

「資格情報」タブがハイライト表示されたクエリダッシュボード

次の手順

これで Platform の Query Service ユーザーインターフェイスをよく理解したので、次に、Query Editor にアクセスして、独自のクエリプロジェクトの作成を開始し、組織内の他のユーザーと共有することができます。Query Editor でのクエリの作成と実行について詳しくは、Query Editor ユーザガイドを参照してください。

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