OceanBase 如何導(dǎo)入數(shù)據(jù)

本篇教程介紹在 OceanBase 開發(fā)者中心（OceanBase Developer Center，ODC）中進(jìn)行數(shù)據(jù)批量導(dǎo)入操作的詳細(xì)步驟。

背景信息

為了讓數(shù)據(jù)庫開發(fā)者更方便的維護(hù)數(shù)據(jù)庫內(nèi)的數(shù)據(jù)，ODC 提供批量導(dǎo)入導(dǎo)出和單表導(dǎo)入導(dǎo)出功能。通過批量導(dǎo)入導(dǎo)出您可以批量選擇數(shù)據(jù)庫中的對象以導(dǎo)入或?qū)С銎渲械臄?shù)據(jù)或結(jié)構(gòu)，通過單表導(dǎo)入導(dǎo)出，您可以導(dǎo)出目標(biāo)表中的數(shù)據(jù)。目前 ODC 支持的導(dǎo)出數(shù)據(jù)格式有 CSV 格式和 SQL 格式，支持的導(dǎo)入文件格式有 ZIP 壓縮文件、SQL 文件（批量導(dǎo)入）和 CSV 文件（單表導(dǎo)入）。

創(chuàng)建導(dǎo)入或?qū)С鋈蝿?wù)后，您可以進(jìn)入任務(wù)中心下載導(dǎo)出文件和查看任務(wù)詳情和日志等信息。

本教程以批量導(dǎo)入為例，為您展示如何在 ODC 中導(dǎo)入數(shù)據(jù)的詳細(xì)步驟。

前提條件

• 確認(rèn)字符集。OceanBase V2.2.30 及之后版本支持字符編碼 UTF8、GBK、GB18030 和 UTF16。OceanBase V2.2.30 版本之前僅支持字符編碼 UTF8。ODC 目前導(dǎo)出文件的編碼為 UTF-8，暫不支持修改。

• 確認(rèn)連接方式。在 ODC V2.2.1 及之前的低版本中使用導(dǎo)入導(dǎo)出功能時(shí)必須通過 OBProxy 連接至目標(biāo)實(shí)例，直連時(shí) ODC 不支持導(dǎo)入導(dǎo)出功能。

• 配置 root@sys 賬戶。ODC V2.4.1 版本后，您可以選擇配置 sys 租戶賬號以提升導(dǎo)出導(dǎo)入速度。同時(shí)，導(dǎo)出時(shí)如果勾選了表和視圖之外的其它對象，必須配置該項(xiàng)以使用 sys 租戶賬號進(jìn)行導(dǎo)出。

操作步驟

1. 進(jìn)入 批量導(dǎo)入 面板。

   進(jìn)入連接后，單擊上方導(dǎo)航欄中的 工具 按鈕，在彈出的列表中選擇 導(dǎo)入，然后 ODC 會從右側(cè)彈出 批量導(dǎo)入 面板。

2. 指定 任務(wù)名。

   彈出面板后 ODC 會自動生成默認(rèn)的任務(wù)名，格式為連接名_模式名_日期，您也可以在文本框中修改自動生成的任務(wù)名。

3. 選擇 導(dǎo)入格式。

   目前 ODC 支持的導(dǎo)入格式有 ZIP 壓縮文件、SQL 文件（批量導(dǎo)入）和 CSV 文件（單表導(dǎo)入）。其中 SQL 格式和 CSV 格式是 OceanBase 導(dǎo)入導(dǎo)出工具特有的格式。具體格式信息，請參見導(dǎo)出導(dǎo)入格式。本教程選擇導(dǎo)入格式為 ZIP 壓縮文件。

4. 上傳 導(dǎo)入文件。

   單擊文件池進(jìn)入文件資源管理器選擇要導(dǎo)入的文件，或者直接將文件拖入文件池中以完成文件上傳。上傳的文件格式需要與您選擇的導(dǎo)入文件格式相同，ZIP 壓縮文件支持上傳 .zip 結(jié)尾的文件。SQL 文件支持上傳 .sql 文件。上傳的文件的格式需要與您在步驟 3 中選擇的 導(dǎo)入格式 相同。

5. 選擇 文件編碼。

   ODC 目前支持 ASCII、ISO-8859-1、GB2312、GBK、GB18030、Unicode（UTF-8）、Unicode（UTF-16）、Unicode（UTF-32）和 BIG5 等編碼格式。您需要在 文件編碼 下拉框中選擇需要的編碼格式。

6. 選擇 導(dǎo)入內(nèi)容。

   ODC 目前支持 導(dǎo)入結(jié)構(gòu)和內(nèi)容、僅導(dǎo)入數(shù)據(jù) 和 僅導(dǎo)入結(jié)構(gòu) 三種方式。

   當(dāng) 導(dǎo)入格式 為 ZIP 壓縮文件時(shí)需指定該項(xiàng)。導(dǎo)入結(jié)構(gòu)是指運(yùn)行導(dǎo)入文件中的對象定義語句，導(dǎo)入后會在數(shù)據(jù)庫中創(chuàng)建新的對象，導(dǎo)入數(shù)據(jù)是向指定對象中導(dǎo)入數(shù)據(jù)文件中的數(shù)據(jù)。本教程選擇導(dǎo)入內(nèi)容為 導(dǎo)出結(jié)構(gòu)和內(nèi)容。

7. 選擇 數(shù)據(jù)格式。

   當(dāng) 導(dǎo)入格式 為 ZIP 壓縮文件時(shí)需指定該項(xiàng)。ODC 目前支持導(dǎo)入 CSV 格式 和 SQL 格式 的數(shù)據(jù)。具體格式信息，請參見導(dǎo)出導(dǎo)入格式。本教程選擇數(shù)據(jù)格式為 CSV 格式。

8. 進(jìn)行 導(dǎo)入數(shù)據(jù)設(shè)置。

   當(dāng) 導(dǎo)入格式 為 ZIP 壓縮文件且 導(dǎo)入內(nèi)容 為僅導(dǎo)入結(jié)構(gòu)時(shí)無需進(jìn)行導(dǎo)入數(shù)據(jù)設(shè)置。該項(xiàng)包含以下設(shè)置項(xiàng)：

   • 導(dǎo)入前清空數(shù)據(jù)：勾選該項(xiàng)后，導(dǎo)入數(shù)據(jù)時(shí)將首先清空目標(biāo)對象中原有的數(shù)據(jù)。

   • 批量提交數(shù)量：單擊 導(dǎo)入數(shù)據(jù)設(shè)置 標(biāo)簽后的 高級 按鈕，在彈出的列表中可指定該項(xiàng)。通過指定批量提交數(shù)量，可在導(dǎo)入文件中導(dǎo)入指定數(shù)量數(shù)據(jù)時(shí)添加一句 COMMIT 命令。

   • 跳過的數(shù)據(jù)類型：單擊 導(dǎo)入數(shù)據(jù)設(shè)置 標(biāo)簽后的 高級 按鈕，在彈出的列表中可指定該項(xiàng)。您可以通過該項(xiàng)指定導(dǎo)入數(shù)據(jù)時(shí)要跳過的數(shù)據(jù)類型。MySQL 和 Oracle 下可跳過的類型不同，支持多選。

9. 進(jìn)行 導(dǎo)入結(jié)構(gòu)設(shè)置。

   當(dāng) 導(dǎo)入內(nèi)容 為僅導(dǎo)入數(shù)據(jù)時(shí)，該項(xiàng)不可被指定。在該項(xiàng)下選擇當(dāng)對象結(jié)構(gòu)已存在時(shí)的操作。選擇 跳過 操作則在導(dǎo)入時(shí)跳過導(dǎo)入文件中的結(jié)構(gòu)定義語句直接導(dǎo)入數(shù)據(jù)，該項(xiàng)會保留對象中的原數(shù)據(jù)。選擇 替換 操作時(shí)則執(zhí)行導(dǎo)入文件中的結(jié)構(gòu)定義語句以重新創(chuàng)建并替換原對象，該項(xiàng)會清空對象中的原數(shù)據(jù)。

10. 選擇 任務(wù)錯誤處理 方式。

    ODC 提供 停止任務(wù) 和 忽略錯誤繼續(xù)任務(wù) 兩種錯誤處理方式。您需要在 任務(wù)錯誤處理 標(biāo)簽下選擇需要的處理方式。

11. 進(jìn)行 sys 租戶賬號配置。

    在該項(xiàng)下選擇是否 使用 sys 租戶賬號提升導(dǎo)入速度。勾選后在彈出的 賬戶 和 密碼 文本框中填寫 sys 賬戶和對應(yīng)的密碼。設(shè)置好該項(xiàng)后會使用 sys 租戶的權(quán)限進(jìn)行導(dǎo)入，可提升導(dǎo)入的速度。

12. 生成導(dǎo)入任務(wù)。

    單擊面板右下角的 導(dǎo)入 按鈕以生成導(dǎo)出任務(wù)。任務(wù)成功生成后 ODC 會自動跳轉(zhuǎn)至任務(wù)中心，在任務(wù)中心您可以看到導(dǎo)入任務(wù)的運(yùn)行狀況，任務(wù)完成后可以查看任務(wù)詳情和日志等信息。