クエリスケジュール
クエリスケジュールを作成して、クエリの実行を自動化できます。 スケジュールされたクエリは、カスタムサイクルで実行され、頻度、日付、時間に基づいてデータを管理します。 必要に応じて、結果に使用する出力データセットを選択することもできます。 テンプレートとして保存したクエリは、クエリエディターからスケジュールできます。
スケジュールされたクエリが「」のリストに追加されます スケジュール済みクエリ タブ。 そのワークスペースから、UI を使用して、スケジュールされたすべてのクエリジョブのステータスを監視できます。 日 スケジュール済みクエリ タブ クエリの実行に関する重要な情報を見つけたり、アラートを購読したりできます。 使用可能な情報には、ステータス、スケジュールの詳細、実行が失敗した場合のエラーメッセージ/コードが含まれます。 を参照してください。 スケジュール済みクエリドキュメントの監視 を参照してください。
このワークフローでは、クエリサービス UI のスケジュールプロセスについて説明します。 API を使用してスケジュールを追加する方法について詳しくは、スケジュールされたクエリのエンドポイントガイドを参照してください。
クエリスケジュールの作成 create-schedule
クエリをスケジュールするには、次のいずれかからクエリテンプレートを選択します テンプレート tab キーまたは Template の列 スケジュール済みクエリ タブ。 テンプレート名を選択すると、クエリエディターに移動します。
クエリエディターから保存済みクエリにアクセスする場合は、クエリのスケジュールを作成するか、詳細パネルからクエリのスケジュールを表示できます。
を選択 スケジュールを追加 に移動します。 スケジュールの詳細ページ.
または、を選択します スケジュール tab キーを使用すると、クエリの名前を削除できます。
スケジュールワークスペースが表示されます。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
特定のクエリのスケジュールワークスペースまたは次の場所からスケジュールを有効化、無効化、削除できます スケジュール済みクエリ スケジュールされたすべてのクエリをリストするワークスペース。
にアクセスするには スケジュール 選択したクエリのタブで、次のいずれかからクエリテンプレートの名前を選択する必要があります テンプレート tab キーまたは スケジュール済みクエリ タブ。 これにより、そのクエリのクエリエディターに移動します。 クエリエディターから、次を選択します。 スケジュール スケジュールワークスペースにアクセスする
使用可能なスケジュールの行からスケジュールを選択して、詳細パネルに入力します。 切替スイッチを使用して、スケジュールされたクエリを無効(または有効)にします。
無効なクエリの削除
確認ダイアログが表示されます。 を選択 無効 をクリックしてアクションを確認します。
「スケジュールを削除」を選択して、無効なスケジュールを削除します。
または、 スケジュール済みクエリ タブには、スケジュールされた各クエリに対してインラインアクションのコレクションが表示されます。 使用可能なインラインアクションを次に示します スケジュールを無効にする または スケジュールを有効にする, スケジュールを削除、および 登録 スケジュールされたクエリに関するアラートを送信します。 「スケジュール済みクエリ」タブを使用してスケジュール済みクエリを削除または無効にする方法の完全な手順については、を参照してください。 スケジュール済みクエリ済みガイドの監視.