Query Service UI ガイド

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

Query Editor

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

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

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

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

スケジュール済みクエリ

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

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

クエリがスケジュールされると、そのクエリは 予定クエリ タブをクリックします。 クエリ、実行、作成者、タイミングに関する詳細は、リストからスケジュール済みクエリを選択すると確認できます。

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

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

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

テンプレート

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

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

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

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

ログ

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

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

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

!![Note]
鉛筆アイコン (鉛筆アイコン。) をクエリログの任意の行から Query Editor. 編集を容易にするために、クエリが事前に設定されています。

詳しくは、 クエリログドキュメント を参照してください。

認証情報

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

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

次の手順

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

このページ