スケジュール済みクエリの監視
Adobe Experience Platform では、UI を使用して、すべてのクエリジョブのステータスをより的確に把握できるようになりました。次から: スケジュール済みクエリ 「 」タブを使用すると、ステータス、スケジュールの詳細、失敗した場合のエラーメッセージ/コードなど、クエリの実行に関する重要な情報を確認できます。 「スケジュール済みクエリ」タブから、これらの任意のクエリについて、UI を使用して、ステータスに基づくクエリのアラートの配信を登録することもできます。
スケジュール済みクエリ
The スケジュール済みクエリ 「 」タブには、スケジュールされたすべての CTAS および ITAS クエリの概要が表示されます。 すべてのスケジュール済みクエリの実行の詳細と、失敗したクエリのエラーコードおよびメッセージが見つかります。
「スケジュール済みクエリ」タブに移動するには、左側のナビゲーションバーから「クエリ」、「スケジュール済みクエリ」の順に選択します。
使用可能な各列を以下のテーブルに示します。
Run once
と Scheduled
です。クエリは、実行頻度に従ってフィルタリングできます。Success
, Failed
, In progress
、および No runs
.スケジュール済みクエリの現在のステータス。 5 つの潜在的な値があります。 登録中, アクティブ, 非アクティブ, 削除済み、およびハイフン
- ハイフンは、スケジュール済みクエリが 1 回限りの、繰り返し発生しないクエリであることを示します。
- The 登録中 「 」ステータスは、クエリの新しいスケジュールの作成をシステムがまだ処理していることを示します。 スケジュール済みクエリの登録中に、そのクエリを無効にしたり削除したりすることはできません。
- The アクティブ ステータスは、スケジュール済みクエリに まだ経過していない 完了日時。
- The 非アクティブ ステータスは、スケジュール済みクエリに 渡された 完了日時。
- The 削除済み 「 」ステータスは、クエリスケジュールが削除されたことを示します。
スケジュール済みクエリのテーブル設定のカスタマイズ customize-table
「スケジュール済みクエリ」タブの列は、必要に応じて調整できます。を開くには、 テーブルをカスタマイズ 設定ダイアログが開き、使用可能な列を編集する場合は、設定アイコン ( ) を画面の右上からクリックします。
該当するチェックボックスを切り替えて、テーブル列を削除または追加します。 次に、「適用」をクリックして選択を確定します。
インラインアクションを使用したスケジュール済みクエリの管理 inline-actions
The スケジュール済みクエリ 「表示」では、スケジュールされたすべてのクエリを 1 か所で管理する様々なインラインアクションを提供します。 インラインアクションは、各行に省略記号付きで示されます。 管理するスケジュール済みクエリの省略記号を選択し、ポップアップメニューで使用可能なオプションを表示します。 使用可能なオプションは次のとおりです。 スケジュールを無効にする または スケジュールを有効にする, スケジュールを削除、および 購読 アラートを問い合わせるには、次の手順に従います。
スケジュール済みクエリの無効化または有効化 disable
スケジュール済みクエリを無効にするには、管理するスケジュール済みクエリの省略記号を選択し、「 」を選択します。 スケジュールを無効にする を選択します。 アクションを確認するダイアログが表示されます。 選択 無効にする をクリックして設定を確定します。
スケジュール済みクエリを無効にした後は、同じ手順でスケジュールを有効にできます。 省略記号を選択し、「 スケジュールを有効にする を選択します。
スケジュール済みクエリの削除 delete
スケジュール済みクエリを削除するには、管理するスケジュール済みクエリの省略記号を選択し、「 スケジュールを削除 を選択します。 アクションを確認するダイアログが表示されます。 選択 削除 をクリックして設定を確定します。
スケジュール済みクエリを削除すると、 not スケジュール済みクエリのリストから削除されました。 省略記号で提供されるインラインアクションは削除され、灰色表示のアラートの追加アイコンに置き換えられます。 削除したスケジュールのアラートを購読することはできません。 行は UI に残り、スケジュール済みクエリの一部として実行される実行に関する情報を提供します。
そのクエリテンプレートの実行をスケジュールする場合は、適切な行からテンプレート名を選択してクエリエディターに移動し、次の手順に従います。 クエリにスケジュールを追加する手順 ドキュメントで説明されているとおりです。
アラートの配信を登録 alert-subscription
スケジュール済みクエリの実行に関するアラートをサブスクライブするには、管理するスケジュール済みクエリの省略記号を選択し、「 」を選択します。 購読 を選択します。
The アラート ダイアログが開きます。 The アラート ダイアログは、UI 通知と E メールアラートの両方を購読します。 アラートは、クエリのステータスに基づいています。使用できるオプションは、start
、success
および failure
の 3 つです。該当するボックスをオンにし、「 」を選択します。 保存 購読する アラートが 前回の実行のタイムスタンプ の値です。
詳しくは、 アラート購読 API ドキュメント を参照してください。
クエリの詳細を表示 query-details
情報アイコン ( ) をクリックして、クエリの詳細パネルを表示します。 詳細パネルには、スケジュール済みクエリテーブルに含まれる事実以外の、クエリに関するすべての関連情報が表示されます。 追加情報には、クエリ ID、最終変更日、クエリの SQL、スケジュール ID、現在の設定スケジュールが含まれます。
クエリのフィルタリング filter
実行頻度に基づいてクエリをフィルタリングできます。「スケジュールされたクエリ」タブで、フィルターアイコン( )を選択して、フィルターサイドバーを開きます。
実行頻度に基づいてクエリのリストをフィルターするには、 Scheduled または 1 回実行 フィルターチェックボックス。
フィルター条件を有効にしたら、「フィルターを非表示」を選択して、フィルターパネルを閉じます。
クエリ実行スケジュールの詳細 query-runs
スケジュールの詳細ページを開くには、 スケジュール済みクエリ タブをクリックします。 このビューには、スケジュールされたクエリの一部として実行されたすべての実行内容のリストが表示されます。表示される情報に含まれているのは、開始時間と終了時間、ステータス、使用されたデータセットです。
この情報は 5 列の表として表示されます。各行はクエリを 1 回実行したことを示しています。
successful
、failed
、in progress
のいずれかです。スケジュールされたクエリの詳細は、プロパティパネルに表示されています。このパネルには、初回クエリ ID、クライアントタイプ、テンプレート名、クエリ SQL、スケジュールのケイデンスが含まれています。
クエリ実行 ID を選択して実行の詳細ページに移動し、クエリ情報を表示します。
クエリ実行の概要 query-run-overview
The クエリ実行の概要 は、このスケジュール済みクエリの個々の実行に関する情報と、実行ステータスの詳細な分類を提供します。 また、このページには、クライアント情報と、クエリの失敗を引き起こした可能性のあるエラーの詳細も含まれています。
クエリステータスセクションには、クエリが失敗した場合のエラーコードとエラーメッセージが表示されます。
このビューからクエリ SQL をクリップボードにコピーできます。 クエリをコピーするには、SQL スニペットの右上にあるコピーアイコンを選択します。 コードがコピーされたことを確認するポップアップメッセージが表示されます。
匿名ブロックを含むクエリの詳細を実行 anonymous-block-queries
匿名ブロックを使用して SQL ステートメントを構成するクエリは、個々のサブクエリに分割されます。 サブクエリに分割すると、各クエリブロックの実行詳細を個別に検査できます。
匿名ブロックは、 $$
プレフィックスを使用します。 クエリサービスの匿名ブロックについて詳しくは、 匿名ブロックドキュメント.
匿名ブロックサブクエリの実行ステータスの左側にタブがあります。 実行の詳細を表示するタブを選択します。
匿名ブロッククエリが失敗したイベントでは、この UI を使用してその特定のブロックのエラーコードを見つけることができます。
「クエリ」を選択してスケジュール詳細画面に戻るか、「スケジュール済みクエリ」を選択して「スケジュール済みクエリ」タブに戻ります。