スケジュール済みクエリの監視
Adobe Experience Platform では、UI を使用して、すべてのクエリジョブのステータスをより的確に把握できるようになりました。から スケジュール済みクエリ タブに、ステータス、スケジュールの詳細、失敗した場合のエラーメッセージ/コードなど、クエリの実行に関する重要な情報が表示されるようになりました。 「スケジュール済みクエリ」タブから、これらの任意のクエリについて、UI を使用して、ステータスに基づくクエリのアラートの配信を登録することもできます。
スケジュール済みクエリ
この スケジュール済みクエリ タブには、スケジュールされたすべての CTAS および ITAS クエリの概要が表示されます。 すべてのスケジュール済みクエリの実行詳細のほか、失敗したクエリのエラーコードとメッセージを確認できます。
「スケジュール済みクエリ」タブに移動するには、左側のナビゲーションバーから「クエリ」、「スケジュール済みクエリ」の順に選択します。
使用可能な各列を以下のテーブルに示します。
![アラート購読アイコン。](./media_119dda2b56be0dd252c8938b4afbc0a4bd2304e28.png?width=750&format=png&optimize=medium)
Run once
および Scheduled
.Success
, Failed
, In progress
、および No runs
.スケジュールされたクエリの現在のステータス。 次の 6 つの値が考えられます。 登録中, アクティブ, Inactive, 削除済み、ハイフン、および 強制隔離.
- この 登録中 status は、クエリの新しいスケジュールの作成をシステムが処理中であることを示します。 登録中は、スケジュール済みクエリを無効にしたり削除したりすることはできません。
- この アクティブ ステータスは、スケジュールされたクエリに次があることを示します まだ合格していません その完了日時。
- この Inactive ステータスは、スケジュールされたクエリに次があることを示します 渡された 完了日時またはがユーザーによって非アクティブ状態であることがマークされています。
- この 削除済み ステータスは、クエリスケジュールが削除されたことを示します。
- ハイフンは、スケジュールされたクエリが 1 回限りの繰り返さないクエリであることを示します。
- この 強制隔離 ステータスは、クエリが 10 回連続して実行に失敗し、それ以上実行する前に介入が必要であることを示します。
スケジュール済みクエリのテーブル設定のカスタマイズ customize-table
「スケジュール済みクエリ」タブの列は、必要に応じて調整できます。を開くには テーブルをカスタマイズ 設定ダイアログで使用可能な列を編集するには、設定アイコン(
該当するチェックボックスを切り替えて、テーブル列を削除または追加します。 次に、「適用」をクリックして選択を確定します。
インラインアクションを使用したスケジュール済みクエリの管理 inline-actions
この スケジュール済みクエリ ビューには、スケジュールされたすべてのクエリを 1 か所で管理するための様々なインラインアクションが用意されています。 インラインアクションは、各行に省略記号で示されます。 管理するスケジュールされたクエリの省略記号を選択して、ポップアップメニューに使用可能なオプションを表示します。 使用可能なオプションは次のとおりです スケジュールを無効にする または スケジュールを有効にする, スケジュールを削除, 登録 アラートをクエリする場合 Enable or 強制隔離を無効にする.
スケジュール済みクエリを無効または有効にする disable
スケジュールされたクエリを無効にするには、管理するスケジュールされたクエリの省略記号を選択し、次に選択します スケジュールを無効にする ポップアップメニューのオプションから。 アクションを確認するダイアログが表示されます。 を選択 無効 をクリックして設定を確認します。
スケジュールされたクエリが無効になると、同じプロセスでスケジュールを有効にできます。 省略記号を選択して、を選択します スケジュールを有効にする 使用可能なオプションから。
スケジュール済みクエリの削除 delete
スケジュール済みクエリを削除するには、管理するスケジュール済みクエリの省略記号を選択し、 スケジュールを削除 ポップアップメニューのオプションから。 アクションを確認するダイアログが表示されます。 を選択 削除 をクリックして設定を確認します。
スケジュールされたクエリが削除されると、次のようになります ではない スケジュール済みクエリのリストから削除されました。 省略記号によって提供されるインラインアクションは削除され、グレー表示されているアラート購読を追加アイコンに置き換えられます。 削除されたスケジュールに関するアラートを購読することはできません。 行は UI に残り、スケジュールされたクエリの一部として実行された実行に関する情報を提供します。
そのクエリテンプレートの実行をスケジュールする場合は、適切な行からテンプレート名を選択してクエリエディターに移動し、に従います クエリにスケジュールを追加する手順 ドキュメントで説明されています。
アラートの配信を登録 alert-subscription
スケジュールされたクエリ実行のアラートを購読するには、次のいずれかを選択します ...
(省略記号)またはアラート購読アイコン(
この アラート ダイアログが開きます。 この アラート ダイアログでは、UI 通知とメールアラートの両方の配信が登録されます。 複数のアラート購読オプションを使用できます。 start
, success
, failure
, quarantine
、および delay
. 該当する 1 つ以上のチェックボックスをオンにし、「保存」を選択して配信を登録します。
次の表に、サポートされるクエリのアラートタイプを示します。
start
success
failed
quarantine
delay
を参照してください。 alert subscriptions API ドキュメント を参照してください。
クエリの詳細の表示 query-details
情報アイコン(
強制隔離されたクエリ 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 を使用して、その特定のブロックのエラーコードを確認できます。
「クエリ」を選択してスケジュール詳細画面に戻るか、「スケジュール済みクエリ」を選択して「スケジュール済みクエリ」タブに戻ります。