クエリスケジュール

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

重要

次に、クエリエディターを使用する場合のスケジュールされたクエリの制限事項を示します。Query Service API には適用されません：
既に作成、保存、実行されたクエリにのみスケジュールを追加できます。
パラメーター化クエリにスケジュールを追加することはできません。
スケジュールされたクエリに匿名ブロックを含めることはできません。

スケジュールされたクエリは、スケジュールクエリタブをクリックします。そのワークスペースから、UI を使用して、スケジュールされたすべてのクエリジョブのステータスを監視できます。のスケジュールクエリタブでは、クエリの実行に関する重要な情報を確認し、アラートを購読できます。使用可能な情報には、ステータス、スケジュールの詳細、実行が失敗した場合のエラーメッセージ/コードなどが含まれます。詳しくは、スケジュールクエリドキュメントの監視を参照してください。

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

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

API を使用してスケジュールを追加する方法について詳しくは、スケジュールされたクエリのエンドポイントガイドを参照してください。

保存したクエリにクエリエディターからアクセスすると、「スケジュール」タブがクエリ名の下に表示されます。「スケジュール」を選択します。

「スケジュール」タブがハイライトされたクエリエディター。

スケジュールワークスペースが表示されます。「スケジュールを追加」を選択して、スケジュールを作成します。

「スケジュールを追加」がハイライト表示されたクエリエディタースケジュールのワークスペース。

スケジュールの詳細ページが表示されます。このページでは、スケジュールされたクエリの頻度、開始日と終了日、スケジュールされたクエリが実行される曜日およびクエリのエクスポート先のデータセットを選択できます。

ハイライト表示されたスケジュールの詳細パネル。

頻度では、次のオプションが選択できます。

毎時：スケジュールされたクエリは、1 時間ごとに、選択した期間で実行されます。
毎日：スケジュールされたクエリは、 X 日ごとに、選択した時間、期間に実行されます。選択した時間は、ローカルタイムゾーンではなく、UTCであることに注意してください。
毎週：選択したクエリは、選択した曜日、時間および期間に実行されます。選択した時間は、ローカルタイムゾーンではなく、UTCであることに注意してください。
毎月：選択したクエリは、毎月、選択した日、時間および期間に実行されます。選択した時間は、ローカルタイムゾーンではなく、UTCであることに注意してください。
毎年：選択したクエリは、毎年、選択した日、月、時間および期間に実行されます。選択した時間は、ローカルタイムゾーンではなく、UTCであることに注意してください。

出力データセットには、既存のデータセットを使用するか、新しいデータセットを作成するかのどちらかのオプションがあります。

重要

既存のデータセットを使用または新しいデータセットを作成する際は、データセットは既に設定されているため、INSERT INTO または CREATE TABLE AS SELECT をクエリの一部として含める必要はありません。INSERT INTO または CREATE TABLE AS SELECT をスケジュールされたクエリの一部として含めた場合、エラーが発生します。

これらの詳細をすべて確認したら、「保存」を選択して、スケジュールを作成します。スケジュールワークスペースに戻ると、新しく作成したスケジュールの詳細（スケジュール ID、スケジュール自体、スケジュールの出力データセットなど）が表示されます。スケジュール ID を使用して、スケジュールされたクエリ自体の実行に関する詳細を検索できます。詳しくは、スケジュールされたクエリ実行エンドポイントガイドを参照してください。

新しく作成されたスケジュールがハイライト表示されたスケジュールワークスペース。