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

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

背景信息

為了讓數(shù)據(jù)庫(kù)開發(fā)者更方便的維護(hù)數(shù)據(jù)庫(kù)內(nèi)的數(shù)據(jù)，ODC 提供批量導(dǎo)入導(dǎo)出和單表導(dǎo)入導(dǎo)出功能。通過(guò)導(dǎo)入導(dǎo)出您可以選擇數(shù)據(jù)庫(kù)中的對(duì)象以導(dǎo)入或?qū)С銎渲械臄?shù)據(jù)或結(jié)構(gòu)。目前 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í)必須通過(guò) OBProxy 連接至目標(biāo)實(shí)例，直連時(shí) ODC 不支持導(dǎo)入導(dǎo)出功能。

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

操作步驟

1. 進(jìn)入 導(dǎo)出設(shè)置 面板。

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

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

   彈出面板后 ODC 會(huì)自動(dòng)生成默認(rèn)的任務(wù)名，格式為連接名_模式名_日期，您也可以對(duì)任務(wù)名進(jìn)行修改以自定義導(dǎo)出任務(wù)名稱。

3. 選擇 導(dǎo)出內(nèi)容。

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

   其中導(dǎo)出結(jié)構(gòu)指是導(dǎo)出目標(biāo)對(duì)象的定義語(yǔ)句，會(huì)生成 .sql 結(jié)尾的 SQL 文件。導(dǎo)出內(nèi)容是導(dǎo)出對(duì)象中實(shí)際保存的數(shù)據(jù)，根據(jù)選擇的 導(dǎo)出格式 不同生成的數(shù)據(jù)文件格式也不同。本教程選擇導(dǎo)出內(nèi)容為 導(dǎo)出結(jié)構(gòu)和內(nèi)容。

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

   ODC 目前支持將數(shù)據(jù)導(dǎo)出為 CSV 格式 和 SQL 格式。當(dāng) 導(dǎo)出內(nèi)容 為 僅導(dǎo)出結(jié)構(gòu) 時(shí)，無(wú)需選擇數(shù)據(jù)格式。具體格式信息，請(qǐng)參見(jiàn)導(dǎo)出導(dǎo)入格式。本教程選擇導(dǎo)出數(shù)據(jù)為 CSV 格式。

5. 選擇 文件編碼。

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

6. 選擇 導(dǎo)出對(duì)象。

   在 導(dǎo)出對(duì)象 標(biāo)簽下的表格中勾選您想要導(dǎo)出的對(duì)象。表格中會(huì)展示 對(duì)象名稱 和 對(duì)象類型 信息，支持通過(guò) 對(duì)象類型 進(jìn)行篩選和使用搜索框直接進(jìn)行搜索。列表中支持批量選擇和全選，您也可以對(duì)對(duì)象類型進(jìn)行篩選。ODC 對(duì)導(dǎo)出的數(shù)據(jù)大小有限制，最大支持導(dǎo)出 250 M 的數(shù)據(jù)（壓縮前），超出部分無(wú)法導(dǎo)出。所以當(dāng)您選擇的對(duì)象中的數(shù)據(jù)累加超過(guò) 250 MB 時(shí)，最后生成的數(shù)據(jù)文件中數(shù)據(jù)將是不完整的。

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

   當(dāng) 導(dǎo)出內(nèi)容 為僅導(dǎo)出結(jié)構(gòu)時(shí)無(wú)需進(jìn)行導(dǎo)出數(shù)據(jù)設(shè)置，該項(xiàng)包含以下設(shè)置項(xiàng)：

   • 使用全局快照：勾選該項(xiàng)后 ODC 將導(dǎo)出全局中指定表的最新快照點(diǎn)中的數(shù)據(jù)，勾選該項(xiàng)可以保證全局?jǐn)?shù)據(jù)的統(tǒng)一性。

   • 批量提交數(shù)量：?jiǎn)螕?nbsp;導(dǎo)出數(shù)據(jù)設(shè)置 標(biāo)簽后的 高級(jí) 按鈕，在彈出的列表中可指定該項(xiàng)。選擇 數(shù)據(jù)格式 為 SQL 格式時(shí)，通過(guò)指定批量提交數(shù)量，可在導(dǎo)出文件中導(dǎo)出指定數(shù)量數(shù)據(jù)時(shí)添加一句 COMMIT 命令。

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

8. 指定 CSV 格式信息。

   在步驟 4 中選擇了 數(shù)據(jù)格式 為 CSV 格式，所以需要指定 CSV 格式信息。單擊 導(dǎo)出數(shù)據(jù)設(shè)置 標(biāo)簽后的 高級(jí) 按鈕，在彈出的列表中指定以下信息：

   • 包含列頭：該項(xiàng)默認(rèn)勾選，選擇導(dǎo)出數(shù)據(jù)為 CSV 格式時(shí)是否包含列頭。

   • 空字符串轉(zhuǎn)為空值：該項(xiàng)默認(rèn)勾選，選擇導(dǎo)出數(shù)據(jù)為 CSV 格式時(shí)是否將表中的空字符串轉(zhuǎn)換為空值 NULL。

   • 字段分隔符：設(shè)置字段間的分隔符。支持選擇 ,（逗號(hào)）、;（分號(hào)）和 :（冒號(hào)）作為字段分割符。同時(shí)支持自定義一個(gè)字符長(zhǎng)度的字符作為分隔符。

   • 文本識(shí)別符：設(shè)置文本內(nèi)容的識(shí)別符。支持選擇 '（單引號(hào)）和 "（雙引號(hào)）作為文本識(shí)別符。

   • 換行符號(hào)：設(shè)置換行符。支持選擇 \n、\r 和 \r\n 作為換行符。

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

   在該項(xiàng)下選擇是否 添加刪除對(duì)象語(yǔ)句。勾選后在導(dǎo)出對(duì)象結(jié)構(gòu)文件時(shí)，在對(duì)象的 CREATE 語(yǔ)句前都會(huì)添加對(duì)應(yīng)的 DROP 語(yǔ)句。

10. 進(jìn)行 sys 租戶賬號(hào)配置。

    在該項(xiàng)下選擇是否 使用 sys 租戶賬號(hào)提升導(dǎo)出速度。勾選后在彈出的 賬戶 和 密碼 文本框中填寫 sys 賬戶和對(duì)應(yīng)的密碼。設(shè)置好該項(xiàng)后會(huì)使用 sys 租戶的權(quán)限進(jìn)行導(dǎo)出，可提升導(dǎo)出的速度。同時(shí)，導(dǎo)出時(shí)如果勾選了表和視圖之外的其它對(duì)象，必須配置該項(xiàng)使用 sys 租戶賬號(hào)進(jìn)行導(dǎo)出。

11. 生成導(dǎo)出任務(wù)。

    選擇好所有要導(dǎo)出的對(duì)象后，單擊面板右下角的 導(dǎo)出 按鈕以生成導(dǎo)出任務(wù)。任務(wù)成功生成后 ODC 會(huì)自動(dòng)跳轉(zhuǎn)至任務(wù)中心，在任務(wù)中心您可以看到導(dǎo)出任務(wù)的運(yùn)行狀況。任務(wù)完成可以下載導(dǎo)出的數(shù)據(jù)文件并查看任務(wù)詳情和日志等信息。