クエリスケジュール

クエリのスケジュールを作成して、クエリの実行を自動化できます。 スケジュールされたクエリはカスタムケイデンスで実行され、頻度、日付、時間にもとづいてデータを管理します。 必要に応じて、結果の出力データセットを選択することもできます。 テンプレートとして保存されたクエリは、クエリエディターからスケジュールできます。

スケジュールされたクエリのアカウント要件 technical-account-user-requirements

スケジュールされたクエリを確実に実行するために、Adobeでは、スケジュールされたクエリを作成するためのテクニカルアカウント（OAuth サーバー間の資格情報を使用）をプロビジョニングすることをお勧めします。 スケジュールされたクエリは個人ユーザーアカウントでも作成できますが、この方法で作成されたクエリは、そのユーザーのアクセス権が削除または無効になっている場合、実行を停止します。

テクニカルアカウントの設定と必要な権限の割り当てについて詳しくは、資格情報ガイドの前提条件およびAPI認証を参照してください。

テクニカルアカウントの作成と設定に関する追加ガイダンスについては、以下を参照してください。

クエリサービス UIのみを使用する場合は、必要な権限があるか、テクニカルアカウントを管理する管理者と調整する必要があります。 スケジュール済みのクエリは、​ スケジュール済みのクエリ ​ タブのリストに追加されます。このタブでは、スケジュール済みのすべてのクエリ ジョブのステータス、スケジュールの詳細、エラーメッセージを監視したり、アラートを購読したりできます。 クエリの監視と管理について詳しくは、​ スケジュール済みクエリの監視ドキュメント ​を参照してください。

このワークフローでは、クエリサービス UIのスケジューリングプロセスについて説明します。 APIを使用してスケジュールを追加する方法については、​ スケジュールクエリエンドポイントガイド ​を参照してください。

クエリスケジュールの作成 create-schedule

クエリをスケジュールするには、「​ テンプレート ​」タブまたは「​ スケジュールされたクエリ ​」タブの「​ テンプレート ​」列からクエリテンプレートを選択します。 テンプレート名を選択すると、クエリエディターに移動します。

クエリエディターから保存されたクエリにアクセスする場合は、クエリのスケジュールを作成するか、詳細パネルからクエリのスケジュールを表示できます。

![ スケジュールを表示および​ スケジュールを追加がハイライト表示されたクエリエディター。]

「スケジュールを追加」を選択して、​ スケジュールの詳細ページ ​に移動します。

または、クエリ名の下にある「スケジュール」タブを選択します。

スケジュールワークスペースが表示されます。 UIには、テンプレートが関連付けられているスケジュール済み実行のリストが表示されます。 「スケジュールを追加」を選択して、スケジュールを作成します。

スケジュールの詳細を追加 schedule-details

スケジュールの詳細ページが表示されます。 スケジュールされたクエリのスケジュール設定を設定するには、このページを使用します。 詳細には、スケジュールされたクエリ 🔗実行の頻度と平日、開始日と終了日、結果をエクスポートするデータセット、および​ クエリステータスアラート ​が含まれます。

スケジュールされたクエリ頻度 scheduled-query-frequency

頻度​に対して次のオプションを選択できます。

データセットの詳細を提供 dataset-details

既存のデータセットにデータを追加するか、新しいデータセットを作成してデータを追加することで、クエリの結果を管理します。

クエリを初めて実行する際にデータセットを作成するには、新しいデータセットに作成して追加​を選択します。 その後の実行では、そのデータセットにデータを挿入し続けます。 最後に、データセットの名前と説明を入力します。

または、既存のデータセットに追加​を選択し、その後にデータセットアイコン（ ）を選択します。

出力データセットを選択 ダイアログが表示されます。

次に、既存のデータセットを参照するか、検索フィールドを使用してオプションをフィルタリングします。 使用するデータセットの行を選択します。 データセットの詳細が右側のパネルに表示されます。 完了​を選択して、選択を確定します。

継続的に失敗する場合は、クエリを強制隔離します quarantine

スケジュールを作成する際に、システムリソースを保護し、潜在的な中断を防ぐために、強制隔離の機能にクエリを登録できます。 強制隔離の機能は、繰り返し失敗したクエリを自動的に識別して分離し、強制隔離状態にします。 10回連続して失敗した後にクエリを強制隔離することで、問題を修正、確認、修正してからさらに実行することができます。 これは、業務効率とデータの整合性を維持するのに役立ちます。

![ クエリ強制隔離が強調表示され、はい選択されたクエリ スケジュール ワークスペース ​]

強制隔離の機能にクエリが登録されると、このクエリステータスの変更に関するアラートを購読できます。 スケジュールされたクエリが強制隔離に登録されていない場合、​ アラートダイアログ ​にオプションとして表示されません。

また、​ スケジュール済みクエリ ​ タブのインラインアクションから、スケジュール済みクエリを強制隔離の機能に登録することもできます。 詳しくは、​ モニタークエリのドキュメント ​を参照してください。

スケジュールされたクエリステータスのアラートの設定 alerts-for-query-status

スケジュールされたクエリ設定の一部として、クエリアラートを購読することもできます。 様々な状況に応じて通知を受信するように設定できます。 アラートは、強制隔離された状態、クエリ処理の遅延、クエリのステータスの変更に設定できます。 使用可能なクエリ状態アラートオプションには、開始、成功、失敗などがあります。 アラートは、ポップアップ通知または電子メールとして受信できます。 スケジュールされたクエリのステータスに関するアラートを購読するには、チェックボックスを選択します。

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

アラートルールの定義方法の構造など、Adobe Experience Platformのアラートの概要については、​ アラートの概要を参照してください。 Adobe Experience Platform UI内でのアラートとアラートルールの管理に関するガイダンスについては、​ アラート UI ガイド ​を参照してください。

スケジュールされたパラメーター化されたクエリのパラメーターを設定する set-parameters

​ パラメーター化されたクエリ ​に対してスケジュールされたクエリを作成する場合は、クエリ実行のパラメーター値を設定する必要があります。

スケジュールの詳細を確認したら、保存​を選択してスケジュールを作成します。 テンプレートの「スケジュール」タブに戻ります。 このワークスペースには、スケジュール ID、スケジュール自体、スケジュールの出力データセットなど、新しく作成されたスケジュールの詳細が表示されます。

スケジュールされたクエリ実行の表示 scheduled-query-runs

テンプレートの「​ スケジュール ​」タブから、スケジュール IDを選択して、新しくスケジュールされたクエリのクエリ実行のリストに移動します。

または、クエリテンプレートのスケジュールされた実行のリストを表示するには、「スケジュールされたクエリ」タブに移動し、使用可能なリストからテンプレート名を選択します。

スケジュールされたクエリのクエリ実行のリストが表示されます。

ジョブレベルでの時間の計算 compute-hours

CTAS/ITAS バッチクエリのクエリ実行レベルで消費された計算時間を追跡します。 この機能は、計算の使用状況に関するインサイトを提供し、リソース割り当ての最適化とクエリのパフォーマンス向上に役立ちます。

次の表に、スケジュールされたクエリ実行を一覧表示する詳細セクションで使用可能な各列の説明を示します。

UIを使用してすべてのクエリジョブのステータスを監視する方法の詳細については、​ スケジュール済みクエリの監視ガイド ​を参照してください。

リストから​ クエリ実行ID ​を選択して、クエリ実行の概要に移動します。 ​ クエリ実行の概要で利用できる情報の詳細については、スケジュールされたクエリの監視に関するドキュメントを参照してください。

クエリサービス APIを使用してスケジュールされたクエリを監視するには、​ スケジュールされたクエリ実行エンドポイントガイド ​を参照してください。

スケジュールの編集 edit-schedule

スケジュールエディターには、​ スケジュール済みクエリ ​ ワークスペース、スケジュール詳細ページ、またはクエリエディターからアクセスできます。 スケジュールを再作成することなく、既存のスケジュール済みクエリのサポートされている設定設定を変更できます。 スケジュールを編集すると、スケジュール設定のみが更新されます。 基礎となるSQL クエリ定義は変更されません。

編集ワークフローへのアクセス access-edit-workflow

「スケジュール済みクエリ」タブの次のいずれかのパスを使用して、適格なスケジュール済みクエリの編集ワークフローにアクセスします。

省略記号（…）を選択してください 変更するスケジュールの場合は、インラインアクションメニューから​ スケジュールを編集 ​します。 スケジュールエディターが直接開きます。 詳しくは、​ インラインアクションを使用したスケジュール済みクエリの管理を参照してください。

または、テーブルからスケジュール名を選択して、スケジュールの詳細ページを開きます。 スケジュールの詳細ページで、ページの右上隅にある「スケジュールを編集」を選択して、スケジュールエディターを開きます。

クエリエディターから既存の適格スケジュールを編集することもできます。

スケジュール設定の編集 edit-schedule-settings

スケジュール エディターを使用して、現在のスケジュール設定を確認し、サポートされている設定を更新します。

次の設定を変更できます。

スケジュールの変更を保存 save-schedule-changes

スケジュール設定を更新したら、保存​を選択して変更を適用します。 スケジュールが正常に更新されると、確認メッセージが表示されます。

更新されたスケジュール情報の確認 verify-schedule-updates

保存後、更新されたスケジュール設定が次の場所に表示されていることを確認します。

スケジュールの有効化、無効化または削除 delete-schedule

特定のクエリのスケジュールワークスペース、またはスケジュールされたすべてのクエリを一覧表示する​ スケジュールクエリ ​ ワークスペースから、スケジュールを有効、無効、または削除できます。

選択したクエリの「​ スケジュール ​」タブにアクセスするには、「​ テンプレート ​」タブまたは「​ スケジュールされたクエリ ​」タブからクエリテンプレートの名前を選択する必要があります。 クエリのクエリエディターに移動します。 クエリエディターから、スケジュール​を選択してスケジュールワークスペースにアクセスします。

利用可能なスケジュールの行からスケジュールを選択して、詳細パネルに入力します。 切り替えスイッチを使用して、スケジュールされたクエリを無効または有効にします。

無効なクエリの削除

確認ダイアログが表示されます。 「無効化」を選択して、アクションを確認します。

「スケジュールを削除」を選択して、無効なスケジュールを削除します。

または、​ スケジュール済みクエリ ​ タブには、スケジュール済みクエリごとにインラインアクションのコレクションが表示されます。 使用可能なインラインアクションには、​ スケジュールを無効にするまたは​ スケジュールを有効にする、​ スケジュールを削除、スケジュールされたクエリのアラートを購読などがあります。 「スケジュール済みクエリ」タブを使用してスケジュール済みクエリを削除または無効にする方法の詳細については、​ スケジュール済みクエリの監視ガイド ​を参照してください。