クエリスケジュール
クエリスケジュールを作成して、クエリの実行を自動化できます。 スケジュールされたクエリは、カスタムサイクルで実行され、頻度、日付、時間に基づいてデータを管理します。 必要に応じて、結果に使用する出力データセットを選択することもできます。 テンプレートとして保存したクエリは、クエリエディターからスケジュールできます。
スケジュールされたクエリは、「 スケジュール済みクエリ タブのリストに追加されます。 そのワークスペースから、UI を使用して、スケジュールされたすべてのクエリジョブのステータスを監視できます。 スケジュール済みクエリ タブでは、クエリの実行に関する重要な情報を見つけたり、アラートを購読したりできます。 使用可能な情報には、ステータス、スケジュールの詳細、実行が失敗した場合のエラーメッセージ/コードが含まれます。 詳しくは、 スケジュール済みクエリドキュメントの監視を参照してください。
このワークフローでは、クエリサービス UI のスケジュールプロセスについて説明します。 API を使用してスケジュールを追加する方法について詳しくは、スケジュールされたクエリのエンドポイントガイドを参照してください。
クエリスケジュールの作成 create-schedule
クエリをスケジュールするには、「 テンプレート 」タブまたは スケジュール済みクエリ タブの テンプレート 列からクエリテンプレートを選択します。 テンプレート名を選択すると、クエリエディターに移動します。
クエリエディターから保存済みクエリにアクセスする場合は、クエリのスケジュールを作成するか、詳細パネルからクエリのスケジュールを表示できます。
スケジュールを追加 を選択して、 スケジュールの詳細ページに移動します。
または、クエリ名の下にある「スケジュール」タブを選択します。
スケジュールワークスペースが表示されます。UI に、テンプレートが関連付けられているスケジュールされた実行のリストが表示されます。 「スケジュールを追加」を選択して、スケジュールを作成します。
スケジュールの詳細を追加 schedule-details
スケジュールの詳細ページが表示されます。このページでは、スケジュールされたクエリの様々な詳細を編集できます。 詳細には スケジュールされたクエリの頻度と平日実行、開始日と終了日、結果の書き出し先のデータセット、 クエリステータスアラートが含まれます。
スケジュールされたクエリの頻度 scheduled-query-frequency
頻度 では、次のオプションが選択できます。
- 毎時:スケジュールされたクエリは、1 時間ごとに、選択した期間で実行されます。
- 毎日:スケジュールされたクエリは、 X 日ごとに、選択した時間、期間に実行されます。選択した時間は、ローカルタイムゾーンではなく、UTC であることに注意してください。
- 毎週:選択したクエリは、選択した曜日、時間および期間に実行されます。選択した時間は、ローカルタイムゾーンではなく、UTC であることに注意してください。
- 毎月:選択したクエリは、毎月、選択した日、時間および期間に実行されます。選択した時間は、ローカルタイムゾーンではなく、UTC であることに注意してください。
- 毎年:選択したクエリは、毎年、選択した日、月、時間および期間に実行されます。選択した時間は、ローカルタイムゾーンではなく、UTC であることに注意してください。
データセットの詳細を入力 dataset-details
既存のデータセットにデータを追加するか、新しいデータセットを作成してデータを追加することで、クエリ結果を管理します。
初めてクエリを実行するときにデータセットを作成するには、「作成して新しいデータセットに追加」を選択します。 その後の実行では、引き続きそのデータセットにデータが挿入されます。 最後に、データセットの名前と説明を入力します。
INSERT INTO
または CREATE TABLE AS SELECT
をクエリの一部として含める必要は ありません。INSERT INTO
または CREATE TABLE AS SELECT
をスケジュールされたクエリの一部として含めた場合、エラーが発生します。
または、既存のデータセットに追加 を選択したあと、データセットアイコン( )を選択します。
出力データセットを選択 ダイアログが表示されます。
次に、既存のデータセットを参照するか、検索フィールドを使用してオプションをフィルタリングします。 使用するデータセットの行を選択します。 データセットの詳細は、右側のパネルに表示されます。 「完了」を選択して、選択を確定します。
クエリが継続的に失敗する場合に強制隔離 quarantine
スケジュールを作成する際は、クエリを強制隔離機能に登録して、システムリソースを保護し、潜在的な中断を防ぐことができます。 強制隔離機能は、繰り返し失敗するクエリを自動的に識別して分離し、それらのクエリを 強制隔離 状態にします。 10 回連続して失敗した後にクエリを強制隔離すると、問題を介入、確認および修正してから追加の実行を許可できます。 これにより、運用効率とデータの整合性を維持できます。
。
クエリが強制隔離機能に登録されると、このクエリのステータス変更に関するアラートを登録できます。 スケジュールされたクエリが強制隔離で登録されていない場合、 アラートダイアログにオプションとして表示されません。
また、「 予定クエリ タブのインラインアクションから強制隔離機能に予定クエリを登録することもできます。 詳しくは、 クエリドキュメントの監視を参照してください。
スケジュールされたクエリステータスに対するアラートの設定 alerts-for-query-status
また、スケジュールされたクエリ設定の一部として、クエリアラートを購読することもできます。 様々な状況で通知を受け取るように設定できます。 アラートは、強制隔離状態、クエリ処理の遅延、クエリのステータスの変更に対して設定できます。 使用可能なクエリ状態アラートオプションには、開始、成功、失敗があります。 アラートは、ポップアップ通知またはメールとして受け取ることができます。 スケジュールされたクエリのそのステータスに関するアラートを登録するには、チェックボックスをオンにします。
次の表に、サポートされるクエリのアラートタイプを示します。
start
success
failed
quarantine
delay
アラートルールの定義方法など、Adobe Experience Platformのアラートの概要については、 アラートの概要を参照してください。 Adobe Experience Platform UI 内のアラートとアラートルールの管理に関するガイダンスについては、 アラート UI ガイドを参照してください。
スケジュールされたパラメーター化クエリのパラメーターの設定 set-parameters
パラメーター化クエリ用のスケジュールされたクエリを作成している場合は、これらのクエリの実行にパラメーター値を設定する必要があります。
スケジュールの詳細を確認したら、「保存」を選択して、スケジュールを作成します。 テンプレートの「スケジュール」タブに戻ります。 このワークスペースには、スケジュール ID、スケジュール自体、スケジュールの出力データセットなど、新しく作成されたスケジュールの詳細が表示されます。
スケジュールされたクエリの実行の表示 scheduled-query-runs
テンプレートの スケジュール タブで、スケジュール ID を選択して、新しくスケジュールされたクエリのクエリ実行のリストに移動します。
または、クエリテンプレートのスケジュールされた実行のリストを表示するには、「スケジュール済みクエリ」タブに移動し、使用可能なリストからテンプレート名を選択します。
スケジュールされたクエリのクエリ実行のリストが表示されます。
UI を使用してすべてのクエリジョブのステータスを監視する方法について詳しくは、 スケジュール済みクエリの監視ガイドを参照してください。
リストから クエリ実行 ID を選択して、クエリ実行の概要に移動します。 クエリ実行の概要で利用できる情報の完全な分類については、スケジュールされたクエリの監視に関するドキュメントを参照してください。
Query Service API を使用してスケジュールされたクエリを監視するには、 スケジュールされたクエリ実行エンドポイントガイドを参照してください。
スケジュールの有効化、無効化または削除 delete-schedule
特定のクエリのスケジュールワークスペース、またはすべてのスケジュール済みクエリを一覧表示する スケジュール済みクエリ ワークスペースで、スケジュールを有効、無効または削除できます。
選択したクエリの「 スケジュール 」タブにアクセスするには、「 テンプレート 」タブまたは「 スケジュール済みクエリ 」タブからクエリテンプレートの名前を選択する必要があります。 これにより、そのクエリのクエリエディターに移動します。 クエリエディターから スケジュール を選択して、スケジュールワークスペースにアクセスします。
使用可能なスケジュールの行からスケジュールを選択して、詳細パネルに入力します。 切替スイッチを使用して、スケジュールされたクエリを無効(または有効)にします。
無効なクエリの削除
確認ダイアログが表示されます。 「無効」を選択して、アクションを確定します。
「スケジュールを削除」を選択して、無効なスケジュールを削除します。
または、「 予定クエリ 」タブには、予定された各クエリに対するインラインアクションのコレクションが用意されています。 使用可能なインラインアクションには、スケジュールされたクエリのアラートに対する スケジュールを無効にする または スケジュールを有効にする 、 スケジュールを削除 および 登録 が含まれます。 「スケジュール済みクエリ」タブを使用してスケジュール済みクエリを削除または無効にする方法について詳しくは、 スケジュール済みクエリの監視ガイドを参照してください。