背景
OceanBase 開発者センター (ODC) では、データベース内のデータを変更できます。データベース変更タスクを作成して、時間のかかる SQL 文を実行し、実行タイムアウトを回避できます。
注意事項
ROLLBACK 文は、UPDATE 文および DELETE 文に対してのみ自動的に生成できます。
変更タスクで影響を受ける行数は最大 100 万行です。影響を受ける行数が 100 万行を超えると、この変更タスクの ROLLBACK 文は自動的に生成できません。
テーブルにラージオブジェクト (LOB) フィールドが含まれている場合、ROLLBACK 文は自動的に生成できません。
データソースが OceanBase MySQL 互換または MySQL データソースの場合、テーブルに主キーまたは一意キーがないと、ROLLBACK 文は自動的に生成できません。
UPDATE 文の SET 句と WHERE 句が同じ場合、ROLLBACK 文は自動的に生成できません。
自動生成されるロールバックスクリプトの最大サイズは 256 MB です。
データベース変更タスクの作成
例: odc_test データベースの employee テーブルで、name の値を xiaoguo から xiaofeng に変更します。
パラメーター | 値の例 |
プロジェクト名 | odc_4.2.0 |
データソース | mysql420 |
データベース名 | odc_test |
テーブル名 | employee |
[Projects] > [All Projects] を選択します。表示されたタブで、プロジェクト名 [odc_test] をクリックします。
[Tickets] タブで、[Database Change] > [Create New] を選択します。
[Create Database Change Ticket] ページで、次のパラメーターを設定します。
パラメーター
説明
データベース
データベース変更タスクが属するデータベースを選択します。
SQL コンテンツ
[SQL Entry] または [Upload File] を選択します。
[SQL Entry]: これは SQL コンテンツを指定するデフォルトの方法です。編集エリアに直接 SQL スクリプトを記述できます。
説明SQL ウィンドウに入力できる SQL 文の最大サイズは 500,000 文字に制限されています。実行する SQL スクリプトが 500,000 文字を超える場合は、スクリプトファイルを直接アップロードできます。
[IN Value Conversion] をクリックして、バッチコピーされたデータを in('A','B') フォーマットに変換できます。
列の値は改行で区切られます。
行の値はスペースまたはタブで区切られます。
[Upload File]: ファイルプールをクリックしてファイルエクスプローラーに移動し、インポートするファイルを選択します。ファイルをファイルプールに直接ドラッグしてアップロードすることもできます。
説明最大 500 個のファイルをアップロードできます。合計ファイルサイズは 256 MB を超えることはできません。
デフォルトでは、ファイルはアップロードされた順序でソートされます。ドラッグアンドドロップで順序を変更できます。タスクはファイルの順序で実行されます。
.sql のサフィックスが付いた SQL ファイルのみがサポートされます。
SQL チェック
このアイコンをクリックして、SQL 文の構文をチェックします。
ロールバック計画
[Rollback Plan] を指定します。SQL スクリプトを記述するか、ファイルをアップロードしてロールバック計画を指定できます。詳細については、「[SQL Content]」の説明をご参照ください。
説明[Generate Backup Rollback Plan] を選択すると、UPDATE 文および DELETE 文のバックアップロールバック SQL 文が自動的に生成されます。
MySQL 互換モードの OceanBase Database の場合、ROLLBACK SQL 文は、主キーまたは一意キーを持つテーブルで実行される UPDATE 文または DELETE 文に対してのみ生成できます。
バックアップロールバック SQL 文は、データベース変更文が影響する行数が 100,000 行以下で、かつデータベース変更タスクが影響する行数が 100 万行以下の場合にのみ生成できます。
区切り文字
区切り文字がサポートされています。
クエリ結果の制限
クエリ結果で許可される最大行数を設定できます。有効値: 1 ～ 1,000,000。
タスク設定
SQL 再試行回数: 1 より大きい値を指定すると、SQL 文の実行が失敗した場合、ODC は 3 分後にその文を再実行します。
データベース変更ツールには、2 つのエラー処理メソッドがあります。
[Abort Task]: これはデフォルトのオプションです。このオプションを選択すると、スクリプトの実行中にエラーが発生した場合にタスクが中断されます。
[Ignore Error and Continue]: このオプションを選択すると、システムはエラーが発生した誤った文をスキップし、スクリプト内の他の文の実行を続行します。
[Execute Now] または [Scheduled Execution] を選択します。
実行タイムアウト値
[Execution Timeout Value] フィールドに値を時間単位で指定します。デフォルト値: 48。最大値: 480。
説明
[Task Description] に 200 文字以内で説明を入力できます。このフィールドはオプションです。
[Create] をクリックします。
[Tickets] タブで、データベース変更タスクリストのタスク情報を表示します。
データベース変更タスクの表示
タスク情報
前の図に示す [Tickets] タブのデータベース変更タスクリストで、対象タスクの [アクション] 列にある [View] をクリックします。
チケット詳細パネルで、[Basic Information] タブをクリックして、タスクのデータベース、タイプ、リスクレベル、SQL コンテンツ、および ROLLBACK 文を表示します。
[Download Backup Rollback Plan] をクリックして、ODC が UPDATE 文および DELETE 文に対して自動的に生成したロールバック計画ファイルをダウンロードできます。
クエリタスクの場合、タスクが正常に実行された後、チケットの下でクエリ結果を表示およびダウンロードできます。
説明システム設定でクエリ結果の表示とダウンロードをサポートするかどうかを指定できます。詳細については、「システム設定」をご参照ください。
[Initiate Again] をクリックしてデータベース変更タスクを再度開始するか、[Roll Back] をクリックしてタスクをロールバックします。
タスクプロセス
チケット詳細パネルで、[Workflow] タブをクリックし、タスクの開始ステータス、承認ステータス、実行ステータス、実行結果などの情報を表示します。
実行結果
チケット詳細パネルで、[Result] タブをクリックして、実行の成功および失敗のレコードを表示します。
ロールバックチケット
チケット詳細パネルで、[Rollback Ticket] をクリックしてロールバックタスクを表示します。
タスクログ
チケット詳細パネルで、[Logs] タブをクリックして、タスクのすべてのログとアラートログを表示します。
タブ | 説明 |
すべてのログ | [INFO]、[ERROR]、[WARN] ログを含む、すべてのタスクログの完全な情報を表示します。[Search]、[Download]、または [Copy] をクリックして、すべてのログを検索、ダウンロード、またはコピーできます。 |
アラートログ | タスクの [ERROR] および [WARN] ログを表示します。タスクが失敗した場合、アラートログでエラーメッセージを表示できます。[Search]、[Download]、または [Copy] をクリックして、アラートログを検索、ダウンロード、またはコピーできます。 |