ApsaraDB for OceanBase：匯入結構和資料

背景資訊

ODC 支援大量匯入資料庫物件的結構和資料。

通過 ODC 匯入任務可以分別匯入資料庫物件的結構和資料、僅匯入資料或者僅匯入結構。

• 匯入結構和資料：同時匯入資料庫物件的定義語句及其資料。

• 僅匯入資料：僅匯入表/視圖對象的資料。

• 僅匯入結構：僅匯入資料庫物件的定義語句。

匯入檔案格式

ODC 匯入工具支援匯入 ZIP 壓縮檔（大量匯入和單表匯入）、SQL 檔案（大量匯入）和 CSV 檔案（單表匯入）。

其中，ZIP 壓縮檔是以 .zip 結尾的壓縮包。建立匯入任務時在面板中的 匯入內容 項中選擇了 ZIP 壓縮檔 後還需在 資料格式 項中選擇壓縮包中的資料格式是 CSV 格式 或 SQL 格式。

大量匯入時支援匯入 SQL 檔案，SQL 檔案是以 .sql 結尾包含可直接在資料庫中執行的SELECT、INSERT、UPDATE、DELETE、CREATE和DROP語句的檔案。

單表匯入時支援匯入 CSV 檔案，CSV 檔案是 .csv 或 .txt 結尾的支援自訂分割符的資料檔案。

注意事項

• Web 版 ODC 對匯入上傳的檔案大小有限制，最大支援匯入 2GB（壓縮後）的檔案，超出部分無法上傳。如需匯入大量資料，請使用導數工具 OBLOADER。

• 最大支援 5 個匯入任務並行運行，後續任務在隊列中等待運行。

• 匯入任務涉及的檔案預設保留 14 天。

• OceanBase V4.0.0 及之前版本的資料來源中配置 sys 租戶帳號和密碼可以提升匯入速度。ODC 通過分區位置可以計算最佳的導數並行策略，除匯出表、視圖之外的其它對象，OceanBase V4.0.0 及之前版本需要通過 sys 租戶查詢和確定分區位置。

• OceanBase V4.0.0 之後版本的資料來源中無需配置 sys 租戶帳號和密碼，ODC 支援通過業務租戶的視圖查詢和確定分區位置。

建立匯入任務

樣本：將本地磁碟中表 employee 和 salary 的結構和資料大量匯入到資料庫 odc_test 中。

1. 在 工單 頁簽中單擊 匯入 > 建立匯入。

   

2. 在彈出的工作面板中，選擇匯入檔案格式。

   

   說明

   • ODC 目前支援大量匯入CSV 檔案、SQL 檔案和ZIP 壓縮檔。

   • 匯入檔案格式為 CSV 檔案時，支援跳過首列欄位列頭欄位。

   • 匯入檔案格式為 ZIP 壓縮檔時，支援匯入單表或者多表和跳過已存在的結構。

3. 上傳匯入檔案。

   單擊檔案池進入檔案總管以選擇需要匯入的檔案，或者直接將檔案拖入檔案池中以完成檔案上傳。上傳的檔案格式需要與所選擇的匯入檔案格式相同，ZIP 壓縮檔支援上傳 .zip 結尾的檔案、SQL 檔案支援上傳 .sql 檔案以及 CSV 檔案支援上傳 .csv 檔案。

4. 選擇檔案編碼。

   ODC 目前支援 ASCII、ISO-8859-1、GB2312、GBK、GB18030、Unicode（UTF-8）、Unicode（UTF-16）、Unicode（UTF-32）和 BIG5 等編碼格式。

5. 進入匯入設定面板。

   單擊 下一步：匯入設定 對匯入的檔案進行設定。

6. 選擇匯入內容。

   

   說明

   • 當 匯入格式 為 ZIP 壓縮檔時需指定該項。

   • ODC 目前支援僅匯入資料、僅匯入結構和匯入資料和結構三種方式。其中匯入結構指是否要匯入對象的定義語句。

7. 選擇所屬庫。

   選擇匯入對象所在的資料庫。該項下同時顯示目標任務所在資料庫的資料來源名稱。

8. 設定匯入資料。

   當匯入格式為 ZIP 壓縮檔且匯入內容不為僅匯入結構時需設定匯入資料。該項包含以下設定項：

   • 匯入前清空資料：勾選該項後，匯入資料時將首先清空目標對象中原有的資料。

   • 批量提交數量：單擊匯入資料設定標籤後的進階按鈕，在彈出的列表中可指定該項。通過指定批量提交數量，可在匯入檔案中匯入指定數量資料時添加一句COMMIT命令。

   • 不匯入的資料類型（可選）：可以通過該項指定匯入資料時要跳過的資料類型。MySQL 和 Oracle 下可跳過的類型不同，支援多選。

9. 設定匯入結構。

   當匯入內容為僅匯入資料時，該項不可被指定。在該項下選擇當對象結構已存在時的操作。選擇跳過操作則在匯入時跳過匯入檔案中的結構定義語句直接匯入資料，該項會保留對象中的原資料。選擇替換操作時則執行匯入檔案中的結構定義語句以重新建立並替換原對象，該項會清Null 物件中的原資料。

11. 設定任務錯誤處理和執行方式。

    • ODC 提供停止任務和忽略錯誤繼續任務兩種錯誤處理方式。需要在任務錯誤處理標籤下選擇需要的處理方式。

    • 支援選擇立即執行/定時執行。

12. 保留當前配置。

    指定所有資訊後，勾選面板左下角的保留當前配置以保留當前部分資料檔案和結構檔案配置。

13. 產生匯入任務。

    指定所有資訊後，單擊面板右下角的 提交 按鈕以產生匯入任務。

14. 查看匯入任務。

    任務產生後會自動彈出工作中樞面板，在工作中樞可以查看任務資訊。

查看匯入任務

工作清單

匯入任務產生後會自動彈出工單面板，在匯入列表中可以查看任務審批狀態、任務資訊和任務日誌。

匯入工作清單中包含如下資訊：

任務資訊

1. 如上圖所示，在匯入工作清單中單擊查看按鈕。

2. 彈出目標任務的任務詳情面板，單擊任務資訊標籤查看任務基本資料、匯入檔案資訊和匯入對象資訊。

   資訊項	說明
   任務基本資料	顯示執行狀態、任務編號、所屬資料庫、任務類型、風險等級、執行方式、建立人和建立時間等資訊。
   匯入檔案資訊	顯示建立匯入任務時選擇的匯入檔案格式、匯入檔案、檔案編碼、資料格式和任務錯誤處理等資訊。
   匯入對象資訊	顯示該任務中您選擇的對象在匯入資料時的完成情況，包括對象名稱、物件類型、實際處理數量和資料處理狀態等資訊。

任務流程

在目標任務的任務詳情面板中，單擊任務流程標籤查看發起任務、審批和執行狀態等資訊。

任務日誌

在目標任務的任務詳情面板，單擊任務日誌標籤查看任務的全部日誌和警示日誌。

同時，工具列提供了以下功能鍵：

相關文檔

• 匯出結構和資料