スケジュール済みクエリの監視

Adobe Experience Platform では、UI を使用して、すべてのクエリジョブのステータスをより的確に把握できるようになりました。から スケジュール済みクエリ タブに、ステータス、スケジュールの詳細、失敗した場合のエラーメッセージ/コードなど、クエリの実行に関する重要な情報が表示されるようになりました。 「スケジュール済みクエリ」タブから、これらの任意のクエリについて、UI を使用して、ステータスに基づくクエリのアラートの配信を登録することもできます。

スケジュール済みクエリ

この スケジュール済みクエリ タブには、スケジュールされたすべての CTAS および ITAS クエリの概要が表示されます。 すべてのスケジュール済みクエリの実行詳細のほか、失敗したクエリのエラーコードとメッセージを確認できます。

「スケジュール済みクエリ」タブに移動するには、左側のナビゲーションバーから「クエリ」、「スケジュール済みクエリ」の順に選択します。

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

使用可能な各列を以下のテーブルに示します。

NOTE
アラート購読アイコン( アラート購読アイコン。 )が、名称未設定列の各行に含まれています。 詳しくは、アラート配信登録の節を参照してください。
説明
名前
名前フィールドは、テンプレート名か SQL クエリの最初の数文字のどちらかです。 クエリエディターを使用して UI から作成したクエリは、開始時に名前が付けられます。API を使用してクエリが作成された場合、その名前はクエリの作成に使用された最初の SQL のスニペットになります。 クエリに関連付けられているすべての実行のリストを表示するには、 名前 列。 詳しくは、 クエリ実行スケジュールの詳細 セクション。
テンプレート
クエリのテンプレート名。 テンプレート名を選択してクエリエディターに移動します。 便宜上、クエリエディターにクエリテンプレートが表示されます。 テンプレート名がない場合、行はハイフンでマークされ、クエリエディターにリダイレクトしてクエリを表示することはできません。
SQL
SQL クエリのスニペット。
実行頻度
クエリを実行するように設定されるケイデンス。 指定可能な値は次のとおりです Run once および Scheduled.
作成者
クエリを作成したユーザーの名前。
作成日
クエリが作成されたときのタイムスタンプ(UTC 形式)。
前回の実行タイムスタンプ
クエリ実行時の最新のタイムスタンプ。 この列では、現在のスケジュールに従ってクエリが実行されたかどうかがハイライト表示されます。
前回の実行ステータス
最新のクエリ実行ステータス。 ステータス値は次のとおりです。 Success, Failed, In progress、および No runs.
スケジュールのステータス

スケジュールされたクエリの現在のステータス。 次の 6 つの値が考えられます。 登録中, アクティブ, Inactive, 削除済み、ハイフン、および 強制隔離.

  • この 登録中 status は、クエリの新しいスケジュールの作成をシステムが処理中であることを示します。 登録中は、スケジュール済みクエリを無効にしたり削除したりすることはできません。
  • この アクティブ ステータスは、スケジュールされたクエリに次があることを示します まだ合格していません その完了日時。
  • この Inactive ステータスは、スケジュールされたクエリに次があることを示します 渡された 完了日時またはがユーザーによって非アクティブ状態であることがマークされています。
  • この 削除済み ステータスは、クエリスケジュールが削除されたことを示します。
  • ハイフンは、スケジュールされたクエリが 1 回限りの繰り返さないクエリであることを示します。
  • この 強制隔離 ステータスは、クエリが 10 回連続して実行に失敗し、それ以上実行する前に介入が必要であることを示します。
TIP
クエリエディターに移動する場合は、「クエリ」を選択して「テンプレート」タブに戻ることができます。

スケジュール済みクエリのテーブル設定のカスタマイズ customize-table

「スケジュール済みクエリ」タブの列は、必要に応じて調整できます。を開くには テーブルをカスタマイズ 設定ダイアログで使用可能な列を編集するには、設定アイコン( 設定アイコン。 )を選択します。

NOTE
この 作成日時 スケジュールの作成日を参照する列は、デフォルトでは非表示になっています。

「テーブル設定をカスタマイズ」アイコンが強調表示された「スケジュールされたクエリ」タブ

該当するチェックボックスを切り替えて、テーブル列を削除または追加します。 次に、「適用」をクリックして選択を確定します。

NOTE
UI を使用して作成されたクエリは、作成プロセスの一環として名前付きテンプレートになります。 テンプレート列にテンプレート名が表示されます。 API を使用してクエリが作成された場合、テンプレート列は空白になります。

テーブル設定をカスタマイズダイアログ。

インラインアクションを使用したスケジュール済みクエリの管理 inline-actions

この スケジュール済みクエリ ビューには、スケジュールされたすべてのクエリを 1 か所で管理するための様々なインラインアクションが用意されています。 インラインアクションは、各行に省略記号で示されます。 管理するスケジュールされたクエリの省略記号を選択して、ポップアップメニューに使用可能なオプションを表示します。 使用可能なオプションは次のとおりです スケジュールを無効にする または スケジュールを有効にする, スケジュールを削除, 登録 アラートをクエリする場合 Enable or 強制隔離を無効にする.

インラインアクションの省略記号とポップアップメニューがハイライト表示された「スケジュールされたクエリ」タブ。

スケジュール済みクエリを無効または有効にする disable

スケジュールされたクエリを無効にするには、管理するスケジュールされたクエリの省略記号を選択し、次に選択します スケジュールを無効にする ポップアップメニューのオプションから。 アクションを確認するダイアログが表示されます。 を選択 無効 をクリックして設定を確認します。

スケジュールされたクエリが無効になると、同じプロセスでスケジュールを有効にできます。 省略記号を選択して、を選択します スケジュールを有効にする 使用可能なオプションから。

NOTE
クエリが強制隔離された場合は、スケジュールを有効にする前に、テンプレートの SQL を確認する必要があります。 これにより、テンプレートクエリで問題が解決しない場合に計算時間が無駄になるのを防ぎます。

スケジュール済みクエリの削除 delete

スケジュール済みクエリを削除するには、管理するスケジュール済みクエリの省略記号を選択し、 スケジュールを削除 ポップアップメニューのオプションから。 アクションを確認するダイアログが表示されます。 を選択 削除 をクリックして設定を確認します。

スケジュールされたクエリが削除されると、次のようになります ではない スケジュール済みクエリのリストから削除されました。 省略記号によって提供されるインラインアクションは削除され、グレー表示されているアラート購読を追加アイコンに置き換えられます。 削除されたスケジュールに関するアラートを購読することはできません。 行は UI に残り、スケジュールされたクエリの一部として実行された実行に関する情報を提供します。

削除されたスケジュール済みクエリとグレー表示されたアラート購読アイコンがハイライト表示された「スケジュール済みクエリ」タブ。

そのクエリテンプレートの実行をスケジュールする場合は、適切な行からテンプレート名を選択してクエリエディターに移動し、に従います クエリにスケジュールを追加する手順 ドキュメントで説明されています。

アラートの配信を登録 alert-subscription

スケジュールされたクエリ実行のアラートを購読するには、次のいずれかを選択します ... (省略記号)またはアラート購読アイコン( アラート購読アイコン。 )を選択します。 インラインアクション ドロップダウンメニューが表示されます。 次に、を選択します 登録 使用可能なオプションから。

省略記号、アラート購読アイコン、インラインアクションドロップダウンメニューがハイライト表示されたスケジュール済みクエリワークスペース。

この アラート ダイアログが開きます。 この アラート ダイアログでは、UI 通知とメールアラートの両方の配信が登録されます。 複数のアラート購読オプションを使用できます。 start, success, failure, quarantine、および delay. 該当する 1 つ以上のチェックボックスをオンにし、「保存」を選択して配信を登録します。

アラートの配信を登録するダイアログ。

次の表に、サポートされるクエリのアラートタイプを示します。

アラートタイプ
説明
start
このアラートは、スケジュールされたクエリの実行が開始されたとき、または処理を開始したときに通知します。
success
このアラートは、スケジュールされたクエリの実行が正常に完了したときに、クエリがエラーなく実行されたことを示します。
failed
このアラートは、スケジュールされたクエリの実行でエラーが発生した場合、または正常に実行できなかった場合にトリガーします。 これにより、問題を迅速に特定して対処できます。
quarantine
このアラートは、スケジュールされたクエリの実行が強制隔離状態になった場合にアクティブになります。 でクエリを登録した場合 強制隔離機能を選択すると、10 回連続して実行されなかったスケジュール済みクエリは、自動的にに 強制隔離 都道府県。 その後、それ以上の実行を行うには、ユーザーの介入が必要です。
delay
このアラートは、 クエリ実行の結果の遅延 指定したしきい値を超えています。 クエリが完了または失敗せずに該当する期間に実行された場合にアラートをトリガーにするカスタム時間を設定できます。
NOTE
クエリ実行が強制隔離されたことを通知するには、まずスケジュールされたクエリ実行をに登録する必要があります 強制隔離機能.

を参照してください。 alert subscriptions API ドキュメント を参照してください。

クエリの詳細の表示 query-details

情報アイコン( 情報アイコン。 )を選択して、クエリの詳細パネルを表示します。 詳細パネルには、スケジュールされたクエリテーブルに含まれるファクト以外の、クエリに関するすべての関連情報が含まれます。 追加情報には、クエリ ID、最終変更日、クエリの SQL、スケジュール ID、現在の設定スケジュールが含まれます。

情報アイコンと詳細パネルがハイライト表示された「スケジュールされたクエリ」タブ。

強制隔離されたクエリ quarantined-queries

NOTE
強制隔離アラートは、「run-once」アドホッククエリでは使用できません。 強制隔離アラートは、スケジュールされたバッチ(CTAS および ITAS)クエリにのみ適用されます。

強制隔離機能に登録すると、10 回連続して実行されなかったスケジュール済みクエリは、自動的にに 強制隔離 ステータス。 このステータスのクエリは非アクティブになり、スケジュールされた頻度で実行されません。 その後、それ以上の実行を行うには、ユーザーの介入が必要です。 これにより、システムリソースが保護され、実行を再開する前に SQL の問題を確認して修正する必要があります。

強制隔離機能のスケジュール済みクエリを有効にするには、省略記号(...)、続いて 強制隔離を有効にする 表示されるドロップダウンメニューから。

省略記号と「インラインアクション」ドロップダウンメニューからハイライト表示された強制隔離を有効にするスケジュールクエリタブ。

クエリは、スケジュール作成プロセス中に強制隔離機能に登録することもできます。 を参照してください。 クエリスケジュールのドキュメント を参照してください。

クエリ実行遅延 query-run-delay

クエリの遅延に関するアラートを設定して、コンピューティング時間を制御します。 クエリのパフォーマンスを監視し、特定の期間が経過してもクエリのステータスが変更されない場合に通知を受け取ることができます。 「」を使用クエリ実行遅延' クエリが完了せずに特定の期間後に処理を続行する場合に通知されるアラート。

実行する場合 アラートの購読 スケジュールされたクエリの実行では、使用可能なアラートの 1 つが次のとおりです クエリ実行遅延. このアラートでは、実行に費やした時間のしきい値を設定する必要があります。その時点で、処理の遅延が通知されます。

通知をトリガーにするしきい値の期間を選択するには、テキスト入力フィールドに数値を入力するか、上下の矢印を使用して 1 分単位で増加します。 しきい値は分単位で設定されているので、クエリ実行の遅延を監視する最大時間は 1440 分(24 時間)です。 実行遅延のデフォルト期間は 150 分です。

NOTE
クエリ実行には、実行遅延時間を 1 つのみ指定できます。 遅延しきい値を変更すると、アラートを購読しているユーザーと組織全体に対して遅延しきい値が変更されます。

「クエリ実行遅延」入力フィールドがハイライト表示された、「スケジュールされたクエリ」タブのアラートダイアログ

方法については、アラートの購読の節を参照してください。 に登録 クエリ実行遅延 アラート.

クエリのフィルタリング filter

実行頻度に基づいてクエリをフィルタリングできます。「スケジュールされたクエリ」タブで、フィルターアイコン( フィルターアイコン )を選択して、フィルターサイドバーを開きます。

フィルターアイコンがハイライト表示された「スケジュールされたクエリ」タブ。

実行頻度に基づいてクエリのリストをフィルタリングするには、次のいずれかを選択します スケジュール済み または 1 回実行 チェックボックスをフィルターします。

NOTE
実行されたけれどスケジュールされていないクエリは、1 回実行と認定されます。

フィルターサイドバーがハイライト表示された「スケジュールされたクエリ」タブ。

フィルター条件を有効にしたら、「フィルターを非表示」を選択して、フィルターパネルを閉じます。

クエリ実行スケジュールの詳細 query-runs

スケジュールの詳細ページを開くには、 スケジュール済みクエリ タブ。 このビューには、スケジュールされたクエリの一部として実行されたすべての実行内容のリストが表示されます。表示される情報に含まれているのは、開始時間と終了時間、ステータス、使用されたデータセットです。

スケジュールの詳細ページ。

この情報は 5 列の表として表示されます。各行はクエリを 1 回実行したことを示しています。

列の名前
説明
クエリ実行 ID
毎日の実行に対するクエリ実行 ID。 「」を選択します クエリ実行 ID に移動します。 クエリ実行の概要.
クエリ実行開始
クエリが実行されたときのタイムスタンプ。タイムスタンプは UTC 形式です。
クエリの実行完了
クエリが完了したときのタイムスタンプ。タイムスタンプは UTC 形式です。
ステータス
最新のクエリ実行ステータス。 ステータス値は次のとおりです。 Success, Failed, In progress、または Quarantined.
データセット
実行に使われたデータセット。

スケジュールされたクエリの詳細は、プロパティパネルに表示されています。このパネルには、初回クエリ ID、クライアントタイプ、テンプレート名、クエリ SQL、スケジュールのケイデンスが含まれています。

プロパティパネルがハイライト表示されたスケジュールの詳細ページ。

クエリ実行 ID を選択して実行の詳細ページに移動し、クエリ情報を表示します。

実行 ID がハイライト表示されたスケジュールの詳細画面。

クエリ実行の概要 query-run-overview

この クエリ実行の概要 このスケジュールされたクエリの個々の実行に関する情報と、実行ステータスのより詳細な分類を提供します。 また、このページには、クライアント情報のほか、クエリが失敗する原因となった可能性のあるエラーの詳細も含まれます。

概要セクションがハイライト表示された実行の詳細画面。

クエリステータスセクションには、クエリが失敗した場合のエラーコードとエラーメッセージが表示されます。

エラーセクションが強調表示された実行の詳細画面

このビューからクエリ SQL をクリップボードにコピーできます。 クエリをコピーするには、SQL スニペットの右上にあるコピーアイコンを選択します。 コードがコピーされたことを確認するポップアップメッセージが表示されます。

「SQL コピー」アイコンが強調表示された実行詳細画面

匿名ブロックを含むクエリの実行詳細 anonymous-block-queries

匿名ブロックを使用して SQL 文を構成するクエリは、個々のサブクエリに分けられます。 サブクエリに分割すると、各クエリブロックの実行詳細を個別に調べることができます。

NOTE
DROP コマンドを使用する匿名ブロックの実行の詳細は、次のようになります ではない 別のサブクエリとしてレポートされます。 CTAS クエリ、ITAS クエリ、匿名ブロックサブクエリとして使用される COPY ステートメントでは、別個の実行詳細を使用できます。 DROP コマンドの実行詳細は現在サポートされていません。

匿名ブロックは、 $$ クエリの前のプレフィックス。 クエリサービスの匿名ブロックについて詳しくは、 匿名ブロックドキュメント.

匿名ブロックサブクエリには、実行ステータスの左側にタブがあります。 タブを選択して実行の詳細を表示します。

匿名ブロッククエリが表示されているクエリ実行の概要 複数の「クエリ」タブがハイライト表示されている様子

匿名ブロッククエリが失敗した場合は、この UI を使用して、その特定のブロックのエラーコードを確認できます。

単一ブロックのエラーコードがハイライト表示された匿名ブロッククエリを表示するクエリ実行の概要。

クエリ」を選択してスケジュール詳細画面に戻るか、「スケジュール済みクエリ」を選択して「スケジュール済みクエリ」タブに戻ります。

クエリがハイライト表示された実行詳細画面

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