クエリスケジュールを作成することで、クエリの実行を自動化できます。 スケジュールされたクエリは、カスタムケイデンスで実行され、頻度、日時に基づいてデータを管理します。 必要に応じて、結果の出力データセットを選択することもできます。 テンプレートとして保存されたクエリは、クエリエディターでスケジュールできます。
次に、クエリエディターを使用する場合のスケジュールされたクエリの制限事項を示します。Query Service API には適用されません:
既に作成、保存、実行されたクエリにのみスケジュールを追加できます。
パラメーター化クエリにスケジュールを追加することはできません。
スケジュールされたクエリに匿名ブロックを含めることはできません。
スケジュールされたクエリは、 スケジュールクエリ タブをクリックします。 そのワークスペースから、UI を使用して、スケジュールされたすべてのクエリジョブのステータスを監視できます。 の スケジュールクエリ タブでは、クエリの実行に関する重要な情報を確認し、アラートを購読できます。 使用可能な情報には、ステータス、スケジュールの詳細、実行が失敗した場合のエラーメッセージ/コードなどが含まれます。 詳しくは、 スケジュールクエリドキュメントの監視 を参照してください。
クエリにスケジュールを追加するには、「テンプレート」タブまたは「スケジュールされたクエリ」タブからクエリテンプレートを選択して、クエリエディターに移動します。
API を使用してスケジュールを追加する方法について詳しくは、スケジュールされたクエリのエンドポイントガイドを参照してください。
保存したクエリにクエリエディターからアクセスすると、「スケジュール」タブがクエリ名の下に表示されます。「スケジュール」を選択します。
スケジュールワークスペースが表示されます。「スケジュールを追加」を選択して、スケジュールを作成します。
スケジュールの詳細ページが表示されます。このページでは、スケジュールされたクエリの頻度、開始日と終了日、スケジュールされたクエリが実行される曜日およびクエリのエクスポート先のデータセットを選択できます。
頻度では、次のオプションが選択できます。
出力データセットには、既存のデータセットを使用するか、新しいデータセットを作成するかのどちらかのオプションがあります。
既存のデータセットを使用または新しいデータセットを作成する際は、データセットは既に設定されているため、INSERT INTO
または CREATE TABLE AS SELECT
をクエリの一部として含める必要はありません。INSERT INTO
または CREATE TABLE AS SELECT
をスケジュールされたクエリの一部として含めた場合、エラーが発生します。
これらの詳細をすべて確認したら、「保存」を選択して、スケジュールを作成します。スケジュールワークスペースに戻ると、新しく作成したスケジュールの詳細(スケジュール ID、スケジュール自体、スケジュールの出力データセットなど)が表示されます。 スケジュール ID を使用して、スケジュールされたクエリ自体の実行に関する詳細を検索できます。詳しくは、スケジュールされたクエリ実行エンドポイントガイドを参照してください。
スケジュールワークスペースからスケジュールを削除または無効にできます。「テンプレート」タブまたは「スケジュールされたクエリ」タブからクエリテンプレートを選択してクエリエディターに移動し、「スケジュール」を選択してスケジュールワークスペースにアクセスする必要があります。
使用可能なスケジュールの行からスケジュールを選択します。切替スイッチを使用して、スケジュールされたクエリを無効または有効にできます。
スケジュールを無効にしてから、クエリのスケジュールを削除する必要があります。
「スケジュールを削除」を選択して、無効なスケジュールを削除します。