全部產品
Search
文件中心

ApsaraDB for OceanBase (Deprecated):資料庫變更管理

更新時間:Oct 14, 2025

背景資訊

ODC 支援對資料庫中的資料進行變更。使用者可以通過資料庫變更任務運行耗時較高的 SQL 陳述式以避免語句執行逾時。

注意事項

  • 只支援對 UPDATE 和 DELETE 變更語句自動產生復原語句。

  • 支援的變更影響行數上限為 100W,超過則不支援自動產生復原語句。

  • 若表中包含大欄位,不支援自動產生復原語句。

  • OceanBase MySQL、MySQL 資料來源下,若表中無主鍵或者唯一鍵,不支援自動產生復原語句。

  • UPDATE 語句的修改欄位(Set)和條件欄位(Where)相同,不支援自動產生復原語句。

  • 最大支援產生的自動復原語句指令碼大小為 256MB。

建立資料庫變更任務

樣本:將資料庫 odc_test 中表 employee 的 name 值 xiaoguo 修改為 xiaofeng。

資訊項

樣本值

專案名稱

odc_4.2.0

所屬資料來源

mysql420

資料庫名稱

odc_test

表名稱

employee

  1. 專案 > 全部專案 頁面中單擊專案名稱 odc_4.2.0

    image.png

  2. 工單 頁簽中單擊 資料庫變更 > 建立資料庫變更

    image.png

  3. 建立資料庫變更 頁面中,輸入以下資訊。

    image

    資訊項

    說明

    資料庫

    選擇需變更的資料庫。

    SQL 內容

    選擇 SQL 錄入 上傳附件

    • SQL 錄入:SQL 錄入為預設,可在編輯區中直接錄入 SQL 指令碼。

      說明
      • 在 SQL 錄入中,最大允許輸入 500000 個字元,如超限可上傳附件。

      • 單擊 IN 值 轉化按鈕,可將批量複製的資料轉化成 in('A','B')格式。

      • 列值分隔字元號為分行符號。

      • 行值分隔字元為空白格或 TAB 值。

    • 上傳附件:選擇上傳附件方式後,單擊檔案池進入檔案總管選擇要匯入的檔案或者直接將匯入檔案拖入檔案池中以完成檔案上傳。

      說明
      • 最多支援上傳 500 個檔案,總檔案大小不超過 256 MB。

      • 預設附件按上傳的先後排序,可拖拽改變順序,任務執行時按檔案順序執行。

      • 當前只支援上傳 .sql 尾碼的 SQL 檔案。

    SQL 檢查

    單擊該按鈕檢查 SQL 文法。

    復原方案

    指定 復原方案。 復原方案支援 SQL 文本錄入及上傳附件方式,參見 SQL 內容 資訊。

    說明

    勾選 產生備份復原方案, 支援對 UPDATE/DELETE 語句自動產生備份復原 SQL。

    • OceanBase MySQL 模式下,自動產生備份復原方案僅支援對包含主鍵或者唯一鍵的表進行 UPDATE/DELETE 時產生對應復原 SQL。

    • 自動產生備份復原方案支援的單條變更 SQL 的影響行數不超過 10w 行,資料庫變更的總影響行數不超過 100w 行。

    分隔字元

    支援 Delimiter 分隔字元號。

    查詢結果限制

    支援設定查詢結果限制 (1-100w)。

    任務設定

    • SQL 重試次數:重試次數大於 1,表示 SQL 陳述式執行失敗後,ODC 會在三分鐘後重新執行該 SQL 陳述式。

    • 資料庫變更工具提供兩種任務錯誤處理方式:

      • 停止任務:停止任務為預設,運行指令碼的過程中出現錯誤時會停止運行。

      • 忽略錯誤繼續任務:選擇忽略錯誤繼續任務方式,在運行指令碼出現錯後將跳過錯誤語句繼續執行。

    • 選擇 立即執行/定時執行 設定任務執行方式。

    執行逾時時間

    執行逾時時間 文字框中輸入數字指定語句執行逾時時間,單位為小時(預設逾時時間為 48 小時,最大不超過 480 小時)。

    描述

    可在 任務描述 文字框中輸入不超過 200 個字元的描述資訊,該項為選填項。

  4. 單擊 建立,完成建立資料庫變更。

  5. 任務產生後可以在 工單 > 資料庫變更 列表中查看任務資訊。

    image

查看資料庫變更任務

任務資訊

  1. 如上圖所示,在 工單 的資料庫變更列表中,單擊操作項下的 查看 按鈕。

  2. 在彈出的任務詳情面板中,單擊 任務資訊 頁簽查看所屬資料庫、任務類型、風險等級、SQL 內容和復原內容等資訊。

    • 當變更有復原方案時,支援單擊 下載備份復原方案,下載 ODC 對 UPDATE/DELETE 語句自動產生的備份復原方案檔案。

    • 如果是查詢類任務,在執行成功後,支援在工單下方進行 查詢結果下載查詢結果

      說明

      您可以在系統設定中對查詢結果是否支援查詢和下載進行配置,詳情請參見系統設定

    image

  3. 單擊 再次發起,可重新發起資料庫變更任務;單擊 復原,復原資料。

任務流程

image

在任務詳情面板中,單擊任務流程頁簽查看發起任務狀態、審批狀態、執行狀態和執行結果等資訊。

執行結果

image

在任務詳情面板中,單擊執行結果頁簽查看執行成功和執行失敗記錄。

復原工單

在任務詳情面板中,單擊復原工單查看任務

任務日誌

image

在任務詳情面板中,單擊 任務日誌 頁簽查看任務的全部日誌和警示日誌。

資訊項

說明

全部日誌

全部日誌顯示任務的 INFOERROR WARN 日誌等全量資訊。 單擊 尋找下載 複製 按鈕,可尋找資訊、下載或複製全部日誌資訊。

警示日誌

警示日誌單獨顯示任務的 ERROR WARN 日誌。當任務失敗時,可通過警示日誌查看錯誤資訊。 單擊 尋找下載 複製 按鈕,可尋找資訊、下載或複製警示日誌資訊。

相關文檔