スケジュール済みクエリの監視
Adobe Experience Platform では、UI を使用して、すべてのクエリジョブのステータスをより的確に把握できるようになりました。「 スケジュール済みクエリ 」タブで、ステータス、スケジュールの詳細、失敗した場合のエラーメッセージ/コードなど、クエリの実行に関する重要な情報を確認できるようになりました。 「スケジュール済みクエリ」タブから、これらの任意のクエリについて、UI を使用して、ステータスに基づくクエリのアラートの配信を登録することもできます。
スケジュール済みクエリ
「 スケジュール済みクエリ 」タブには、スケジュール済みのすべての CTAS および ITAS クエリの概要が表示されます。 すべてのスケジュール済みクエリの実行詳細のほか、失敗したクエリのエラーコードとメッセージを確認できます。
「スケジュール済みクエリ」タブに移動するには、左側のナビゲーションバーから「クエリ」、「スケジュール済みクエリ」の順に選択します。
使用可能な各列を以下のテーブルに示します。
Run once
と Scheduled
です。Success
、Failed
、In progress
、No runs
です。スケジュールされたクエリの現在のステータス。 使用可能な値は 6 つあります。 登録中 、 アクティブ 、 非アクティブ 、 削除済み 、ハイフン、 強制隔離 です。
- 登録中 ステータスは、システムがクエリの新しいスケジュールの作成を処理中であることを示します。 登録中は、スケジュール済みクエリを無効にしたり削除したりすることはできません。
- アクティブ ステータスは、スケジュールされたクエリが完了日時を まだ経過していない ことを示します。
- 非アクティブ ステータスは、スケジュールされたクエリが 経過 完了日時、またはユーザーによって非アクティブ状態としてマークされていることを示します。
- 削除済み ステータスは、クエリスケジュールが削除されたことを示します。
- ハイフンは、スケジュールされたクエリが 1 回限りの繰り返さないクエリであることを示します。
- 強制隔離 ステータスは、クエリが 10 回連続して実行に失敗し、それ以上実行する前に介入が必要であることを示します。
スケジュール済みクエリのテーブル設定のカスタマイズ customize-table
「スケジュール済みクエリ」タブの列は、必要に応じて調整できます。 テーブルをカスタマイズ 設定ダイアログを開いて使用可能な列を編集するには、設定アイコン( )を選択します。
該当するチェックボックスを切り替えて、テーブル列を削除または追加します。 次に、「適用」をクリックして選択を確定します。
インラインアクションを使用したスケジュール済みクエリの管理 inline-actions
スケジュール済みクエリ ビューには、スケジュール済みクエリをすべて 1 か所で管理するための様々なインラインアクションが用意されています。 インラインアクションは、各行に省略記号で示されます。 管理するスケジュールされたクエリの省略記号を選択して、ポップアップメニューに使用可能なオプションを表示します。 使用可能なオプションには、 スケジュールを無効 または スケジュールを有効にする 、 スケジュールを削除 、 購読 クエリアラートへの、 強制隔離を有効または 無効にする などがあります。
スケジュール済みクエリを無効または有効にする disable
スケジュールされたクエリを無効にするには、管理するスケジュールされたクエリの省略記号を選択し、ポップアップメニューのオプションから スケジュールを無効にする を選択します。 アクションを確認するダイアログが表示されます。 「無効」を選択して、設定を確定します。
スケジュールされたクエリが無効になると、同じプロセスでスケジュールを有効にできます。 省略記号を選択して、使用可能なオプションから スケジュールを有効にする を選択します。
スケジュール済みクエリの削除 delete
スケジュールされたクエリを削除するには、管理するスケジュールされたクエリの省略記号を選択し、ポップアップメニューのオプションから スケジュールを削除 を選択します。 アクションを確認するダイアログが表示されます。 「削除」を選択して、設定を確定します。
スケジュールされたクエリが削除されると、スケジュールされたクエリのリストから 削除されません。 省略記号によって提供されるインラインアクションは削除され、グレー表示されているアラート購読を追加アイコンに置き換えられます。 削除されたスケジュールに関するアラートを購読することはできません。 行は UI に残り、スケジュールされたクエリの一部として実行された実行に関する情報を提供します。
そのクエリテンプレートの実行をスケジュールする場合は、適切な行からテンプレート名を選択してクエリエディターに移動し、ドキュメントの説明に従って クエリにスケジュールを追加する手順に従います。
アラートの配信を登録 alert-subscription
スケジュールされたクエリ実行のアラートを購読するには、...
(省略記号)またはアラート購読アイコン(
)を選択します。 インラインアクション ドロップダウンメニューが表示されます。 次に、使用可能なオプションから 購読 を選択します。
アラート ダイアログが開きます。 アラート ダイアログでは、UI 通知とメールアラートの両方の配信が登録されます。 使用できるアラート購読オプションには、start
、success
、failure
、quarantine
および delay
があります。 該当する 1 つ以上のチェックボックスをオンにし、「保存」を選択して配信を登録します。
次の表に、サポートされるクエリのアラートタイプを示します。
start
success
failed
quarantine
delay
詳しくは、 アラート購読 API ドキュメントを参照してください。
クエリの詳細の表示 query-details
情報アイコン( )を選択して、クエリの詳細パネルを表示します。 詳細パネルには、スケジュールされたクエリテーブルに含まれるファクト以外の、クエリに関するすべての関連情報が含まれます。 追加情報には、クエリ ID、最終変更日、クエリの SQL、スケジュール ID、現在の設定スケジュールが含まれます。
強制隔離されたクエリ quarantined-queries
強制隔離機能に登録すると、10 回連続して実行されなかったスケジュール済みクエリは、自動的に 強制隔離 ステータスになります。 このステータスのクエリは非アクティブになり、スケジュールされた頻度で実行されません。 その後、それ以上の実行を行うには、ユーザーの介入が必要です。 これにより、システムリソースが保護され、実行を再開する前に SQL の問題を確認して修正する必要があります。
強制隔離機能のスケジュールされたクエリを有効にするには、省略記号(...
)に続いて、表示されるドロップダウンメニューから 強制隔離を有効にする を選択します。
クエリは、スケジュール作成プロセス中に強制隔離機能に登録することもできます。 詳しくは、 クエリスケジュールのドキュメントを参照してください。
クエリ実行遅延 query-run-delay
クエリの遅延に関するアラートを設定して、コンピューティング時間を制御します。 クエリのパフォーマンスを監視し、特定の期間が経過してもクエリのステータスが変更されない場合に通知を受け取ることができます。 「 クエリ実行遅延 」アラートを使用すると、クエリが完了せずに特定の期間が経過した後も処理を続行する場合に通知されます。
スケジュールされたクエリ実行で アラートの購読を行う場合、使用可能なアラートの 1 つは クエリ実行遅延 です。 このアラートでは、実行に費やした時間のしきい値を設定する必要があります。その時点で、処理の遅延が通知されます。
通知をトリガーにするしきい値の期間を選択するには、テキスト入力フィールドに数値を入力するか、上下の矢印を使用して 1 分単位で増加します。 しきい値は分単位で設定されているので、クエリ実行の遅延を監視する最大時間は 1440 分(24 時間)です。 実行遅延のデフォルト期間は 150 分です。
[ クエリ実行遅延 アラートを購読 する方法については、アラートの購読の節を参照し ] ください。
クエリのフィルタリング filter
実行頻度に基づいてクエリをフィルタリングできます。「スケジュールされたクエリ」タブで、フィルターアイコン( )を選択して、フィルターサイドバーを開きます。
実行頻度に基づいてクエリのリストをフィルタリングするには、「スケジュール済み または 1 回実行 フィルターチェックボックスを選択します。
フィルター条件を有効にしたら、「フィルターを非表示」を選択して、フィルターパネルを閉じます。
クエリ実行スケジュールの詳細 query-runs
スケジュールの詳細ページを開くには、「 スケジュール済みクエリ 」タブからクエリ名を選択します。 このビューには、スケジュールされたクエリの一部として実行されたすべての実行内容のリストが表示されます。表示される情報に含まれているのは、開始時間と終了時間、ステータス、使用されたデータセットです。
この情報は 5 列の表として表示されます。各行はクエリを 1 回実行したことを示しています。
Success
、Failed
、In progress
、Quarantined
です。スケジュールされたクエリの詳細は、プロパティパネルに表示されています。このパネルには、初回クエリ ID、クライアントタイプ、テンプレート名、クエリ SQL、スケジュールのケイデンスが含まれています。
クエリ実行 ID を選択して実行の詳細ページに移動し、クエリ情報を表示します。
クエリ実行の概要 query-run-overview
クエリ実行の概要 には、このスケジュールされたクエリの個々の実行に関する情報と、実行ステータスのより詳細な分類が表示されます。 また、このページには、クライアント情報のほか、クエリが失敗する原因となった可能性のあるエラーの詳細も含まれます。
クエリステータスセクションには、クエリが失敗した場合のエラーコードとエラーメッセージが表示されます。
このビューからクエリ SQL をクリップボードにコピーできます。 クエリをコピーするには、SQL スニペットの右上にあるコピーアイコンを選択します。 コードがコピーされたことを確認するポップアップメッセージが表示されます。
匿名ブロックを含むクエリの実行詳細 anonymous-block-queries
匿名ブロックを使用して SQL 文を構成するクエリは、個々のサブクエリに分けられます。 サブクエリに分割すると、各クエリブロックの実行詳細を個別に調べることができます。
匿名ブロックは、クエリの前に $$
プレフィックスを使用して示されます。 クエリサービスの匿名ブロックについて詳しくは、 匿名ブロックドキュメントを参照してください。
匿名ブロックサブクエリには、実行ステータスの左側にタブがあります。 タブを選択して実行の詳細を表示します。
匿名ブロッククエリが失敗した場合は、この UI を使用して、その特定のブロックのエラーコードを確認できます。
「クエリ」を選択してスケジュール詳細画面に戻るか、「スケジュール済みクエリ」を選択して「スケジュール済みクエリ」タブに戻ります。