スケジュール済みクエリの監視
Adobe Experience Platform では、UI を使用して、すべてのクエリジョブのステータスをより的確に把握できるようになりました。 「 スケジュール済みクエリ 」タブで、ステータス、スケジュールの詳細、失敗した場合のエラーメッセージ/コードを含む、クエリ実行に関する重要な情報を見つけることができるようになりました。 また、 スケジュール済みクエリ タブを使用して、UIを通じて、ステータスに基づいてクエリのアラートを購読することもできます。
スケジュール済みクエリ
「 スケジュール済みクエリ 」タブには、スケジュール済みのすべてのCTAおよびITAS クエリの概要が表示されます。 すべてのスケジュール済みクエリの実行の詳細と、失敗したクエリのエラーコードおよびメッセージが見つかります。
「 スケジュールされたクエリ 」タブに移動するには、左側のナビゲーションバーから「クエリ」を選択し、その後「スケジュールされたクエリ」を選択します
使用可能な各列を以下のテーブルに示します。
Run once と Scheduled です。Success、Failed、In progress、No runsです。スケジュールされたクエリの現在のステータス。 登録中、 アクティブ 、非アクティブ 、削除済み、ハイフン、および強制隔離の6つの潜在的な値があります。
- 登録 ステータスは、システムがクエリの新しいスケジュールの作成を処理中であることを示します。 注意：登録中にスケジュールされたクエリを無効にしたり削除したりすることはできません。
- アクティブ状態は、スケジュールされたクエリが まだ完了日時 を過ぎていないことを示します。
- 非アクティブ状態は、スケジュールされたクエリが 完了日時 を過ぎたか、ユーザーによって非アクティブ状態に設定されていることを示します。
- 削除済み ステータスは、クエリスケジュールが削除されたことを示します。
- ハイフンは、スケジュールされたクエリが1回限りの非定期クエリであることを示します。
- 強制隔離 ステータスは、クエリが10回連続で実行に失敗したことを示します。さらに実行を行う前に、ユーザーの介入が必要です。
スケジュール済みクエリのテーブル設定のカスタマイズ customize-table
「 スケジュール済みクエリ 」タブの列は、必要に応じて調整できます。 テーブルのカスタマイズ 設定ダイアログを開き、使用可能な列を編集するには、設定アイコン（
該当するチェックボックスを切り替えて、テーブル列を削除または追加します。 次に、適用を選択して、選択を確定します。
インラインアクションによるスケジュールされたクエリの管理 inline-actions
スケジュール済みクエリ ビューには、スケジュール済みクエリをすべて1か所から管理するための様々なインラインアクションが用意されています。 インラインアクションは、各行に省略記号で示されます。 管理するスケジュール済みクエリの省略記号を選択すると、ポップアップメニューに使用可能なオプションが表示されます。 利用可能なオプションには、 スケジュールを無効にするまたは スケジュールを有効にする、 スケジュールを編集、 スケジュールを削除、購読のクエリによるアラート、および強制隔離を有効または無効にするが含まれます。
スケジュールされたクエリの無効化または有効化 disable
スケジュールされたクエリを無効にするには、管理するスケジュールされたクエリの省略記号を選択し、ポップアップメニューのオプションから「スケジュールを無効にする」を選択します。 アクションを確認するダイアログが表示されます。 「無効化」を選択して、設定を確定します。
スケジュールされたクエリを無効にすると、同じプロセスでスケジュールを有効にできます。 省略記号を選択し、使用可能なオプションから「スケジュールを有効にする」を選択します。
スケジュールされたクエリの編集 edit
スケジュールされたクエリを編集するには、省略記号（…）を選択します 変更するスケジュールの場合は、ポップアップメニューのオプションから「スケジュールを編集」を選択します。 編集ワークフローが開き、頻度、終了日、クエリ強制隔離の登録、アラートサブスクリプションなど、サポートされているスケジュール設定を更新できます。
「スケジュールを編集」オプションは、アクティブなスケジュールまたは今後のスケジュールでのみ使用できます。 終了したスケジュールは読み取り専用で、変更できません。 削除されたスケジュールまたは登録中のスケジュールも、このオプションを表示しません。
編集ワークフロー、編集可能なフィールド、および適格要件に関する詳細な手順については、 スケジュールの編集を参照してください。
スケジュールされたクエリの削除 delete
スケジュールされたクエリを削除するには、管理するスケジュールされたクエリの省略記号を選択し、ポップアップメニューのオプションから「スケジュールを削除」を選択します。 アクションを確認するダイアログが表示されます。 削除を選択して、設定を確定します。
スケジュールされたクエリが削除されると、スケジュールされたクエリのリストから not が削除されます。 省略記号によって提供されるインラインアクションは削除され、グレー表示のアラート購読を追加アイコンに置き換えられます。 削除されたスケジュールのアラートを購読することはできません。 スケジュールされたクエリの一部として実行された実行に関する情報を提供するために、行はUIに残ります。
そのクエリテンプレートの実行をスケジュールする場合は、適切な行からテンプレート名を選択してクエリエディターに移動し、の手順に従って、ドキュメントの説明に従ってクエリ にスケジュールを追加します。
アラートの配信を登録 alert-subscription
スケジュールされたクエリ実行のアラートを購読するには、... （省略記号）またはアラート購読アイコン（
アラート ダイアログが開きます。 アラート ダイアログでは、UI通知と電子メールアラートの両方を購読できます。 利用可能なアラート サブスクリプションのオプションは、start、success、failure、quarantine、およびdelayです。 適切なボックスまたはボックスにチェックを入れ、保存を選択して購読します。
次の表に、サポートされるクエリアラートタイプを示します。
startsuccessfailedquarantinedelay詳しくは、 アラートサブスクリプション 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を使用して、特定のブロックのエラーコードを見つけることができます。
「クエリ」を選択してスケジュールの詳細画面に戻るか、「スケジュール済みクエリ」を選択して「 スケジュール済みクエリ 」タブに戻ります。
