SQLスケジュールタスク

背景

OceanBase Developer Center（ODC）は、ユーザーが作成したSQLスクリプトを定期的に実行することをサポートしており、ストアドプロシージャの実行、バックアップ、データベース・テーブル構造の同期など、ユーザーの定期的なデータベース開発・運用タスクを満たすことができます。

ユーザーが**チケット**でSQLスケジュールタスクを作成すると、管理者はチケットのタスクリストでタスクを承認します。権限を申請したユーザーは、チケットのタスクリストでタスク情報と承認状況を確認できます。

このドキュメントでは、OceanBase Developer Center（ODC）でSQLスケジュールタスクを使用し、SQLスケジュールタスクの作成と管理を申請する方法について説明します。

SQLスケジュールタスクの新規作成

例：毎月29日にemployeeテーブルのデータを定期的にクエリする。

1. SQL開発ウィンドウで、タスク > SQLプラン > **SQLスケジュールの新規作成**をクリックします。

2. **SQLスケジュールの新規作成**パネルで、以下の情報を入力します。

   情報項目	説明
   データベース	データベースを選択します。
   SQL内容	SQL内容を指定する2つの方法をサポートしています： SQL入力：SQL入力はデフォルトの方法で、編集エリアに直接SQLスクリプトを入力できます。 SQL入力では、デフォルトで最大10MBの文字数まで入力可能です。上限を超える場合は、添付ファイルをアップロードできます。 **IN値変換**ボタンをクリックすると、複数コピーしたデータをin('A','B')形式に変換できます。 列値の区切り文字は改行文字です。 行値の区切り文字はスペースまたはTABです。 添付ファイルのアップロード：添付ファイルのアップロード方法を選択した後、ファイルプールをクリックしてファイルエクスプローラーを開き、インポートするファイルを選択するか、インポートファイルを直接ファイルプールにドラッグしてファイルのアップロードを完了します。 最大500個のファイルのアップロードをサポートし、総ファイルサイズは256MBを超えてはなりません。 デフォルトで添付ファイルはアップロード順に並べ替えられています。順序を変更するにはドラッグ＆ドロップでき、タスク実行時にはファイルの順序で実行されます。 現在、.sql拡張子を持つSQLファイルのアップロードのみをサポートしています。
   区切り文字	Delimiter区切り文字をサポートしています。
   クエリ結果の制限	クエリ結果の制限(1-100万)を設定できます。
   実行タイムアウト時間	**実行タイムアウト時間**テキストボックスに数字を入力して、ステートメント実行のタイムアウト時間を指定します。単位は時間です(デフォルトのタイムアウト時間は48時間、最大は480時間を超えません)。
   定期間隔	毎時/毎晩/毎週の金曜日のクイック設定方法を直接選択できます。 定期間隔を設定する2つのモードをサポートしています： デフォルトモード：毎日/毎週/毎月を選択し、必要な実行周期時間を設定します。 カスタムモード：秒/分/時/日/月/週を選択し、必要な実行周期時間を設定します。
   タスク設定	タスクのエラー処理方法を選択します： タスクの停止：タスクの停止がデフォルトの方法で、スクリプトの実行中にエラーが発生すると実行が停止します。 エラーを無視してタスクを続行：エラーを無視してタスクを続行する方法を選択すると、スクリプトの実行中にエラーが発生した場合、エラーステートメントをスキップして実行を続けます。 タスクの実行時間が期間を超えた場合の処理方法を選択します： 現在のタスクの実行が完了した後、新しい周期でタスクを開始します。 現在のタスクの状態を無視し、定期的に新しいタスクを開始します。
   備考（オプション）	200文字以内の説明情報を入力できます。この項目はオプションです。

3. **新規作成**をクリックして、タスク申請を完了します。

SQLスケジュールタスクの表示

タスクリスト

タスクが生成されると、自動的に チケット パネルがポップアップ表示されます。SQLプラン リストで、タスクの承認状況やタスク情報を確認し、エクスポートデータ構造ファイルをダウンロードできます。

SQL計画タスクページに移動すると、リストに以下の情報が表示され、フィルタリングとソートがサポートされています：

項目	説明
#	タスク番号を表示します。 検索アイコン をクリックして、タスク番号を検索およびフィルタリングできます。
所属接続	タスク対象が存在するデータベース接続名を表示します。 フィルタアイコン をクリックして、所属接続をフィルタリングできます。
実行サイクル	-
次回実行時間	SQL計画タスクの次回実行時間を表示します。
作成者	タスクを作成したユーザー。 検索アイコン をクリックして、作成者を検索およびフィルタリングできます。
更新時間	タスクが生成された日付と時刻を表示します。
ステータス	タスクの現在のステータスを表示します（ステータスによって利用可能な管理操作は異なります）。
操作	表示、承認/却下、編集、有効化/無効化 などのタスク管理操作を提供します。 表示：このボタンをクリックしてタスク詳細ページに移動し、タスク対象情報を確認します。 承認/却下：このボタンをクリックしてタスクを承認します。 有効化/無効化：タスクが実行中の場合、このボタンをクリックしてタスクを有効化または無効化します。 </ li>

タスク情報

1. チケット > SQLプラン のタスクリストページで、タスクリスト操作列の 表示 ボタンをクリックすると、タスク対象のタスク詳細パネルがポップアップ表示されます。

2. タスク詳細 パネルで、タスク情報 タブをクリックして、タスクの基本情報と設定情報を確認します。

   項目	説明
   タスク基本情報	タスクステータス、タスク番号、タスクタイプ、所属接続、備考、作成者、作成時間 などの情報を表示します。
   タスク設定情報	パーティション作成計画タスク作成時の SQL内容、定期サイクル、次回実行時間、区切り文字、クエリ結果の制限、タスクエラー処理、実行タイムアウト時間 の情報を表示します。

実行レコード

タスク詳細パネル で、実行レコード タブをクリックすると、タスク番号、所属データベース、作成日時、タスクステータス、操作 などの情報を確認できます。

操作レコード

タスク詳細パネル で、操作レコード タブをクリックすると、承認状況 および 承認レコード などの情報を確認できます。