ApsaraDB for OceanBase：旁路匯入

概述

OceanBase 資料庫支援以旁路匯入的方式向資料庫中插入資料。此功能可以繞過傳統的 SQL 層介面，直接向資料庫的檔案寫入資料，從而提高資料匯入的效率。若您希望更深入瞭解，可以參考 旁路匯入概述。

前提條件

在開啟旁路匯入連接埠時，請您進行如下檢查，只有滿足下述情況時，才可以進行開啟旁路匯入連接埠的操作。

• 當前叢集為運行中狀態。

• 當前租戶為運行中狀態。

• 代理版本為 V4.3.0 及以上。

  說明

  若版本不符合要求，請聯絡 OceanBase 支援人員協助升級。

• 主地址的私網地址為運行狀態。

開啟旁路匯入

1. 登入 OceanBase 管理主控台。

2. 在左側導覽列中，單擊 執行個體列表。

3. 在執行個體列表中找到目的地組群執行個體，單擊叢集名稱，進入 叢集執行個體工作台。

4. 在左側導覽列，單擊 資料庫代理。

5. 在Proxy 位址列表中，您可以單擊 開啟 為主地址的私網地址開啟旁路匯入連接埠。

6. 在二次確認彈窗上單擊 確定。

匯入資料

1. 下載最新版本的 OceanBase 導數工具。

   OceanBase 導數工具的詳情請參見 產品介紹。

2. 查看和設定環境變數。

   1. 查看 Java 和 PATH 相關的環境變數。

      [root@iZbxxxx rpc]# env | grep JAVA
      JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.382.b05-2.0.3.al8.x86_64
      [root@iZbxxxx rpc]# env | grep PATH
      PATH=/root/ob-loader-dumper-4.3.0-RELEASE/bin/:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin

   2. 設定 Java 和 PATH 環境變數。

      [root@iZbxxxx rpc]# export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.382.b05-2.0.3.al8.x86_64
      [root@iZbxxxx rpc]# export PATH=/root/ob-loader-dumper-4.3.0-RELEASE/bin/:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin:$PATH

3. 通過旁路匯入方式匯入資料。

   說明

   匯入的檔案內容格式需要符合規範，請參考 《準備好您的資料了嗎？》 識別檔案中的資料格式。

   [root@iZbxxxx rpc]# obloader -h<host> -u<user_name> -p<pass_word> -D <db_name> --table '<table_name>' -f output1 --public-cloud --csv --direct --rpc-port 3307 -P3306

   參數	描述
   -h	指定 OceanBase 資料庫的主機地址。
   -u	用於串連 OceanBase 資料庫的使用者名稱、租戶名和叢集名，格式為 <user>@<tenant>#<cluster>。例如，-u user@tenant#cluster。
   -p	指定串連 OceanBase 資料庫的使用者密碼。
   -D	指定需要匯入資料庫物件定義和表資料的 OceanBase 資料庫的名稱。
   --table	對 OceanBase 資料庫中的指定表進行操作。例如，--table 'example'。
   -f	指定待匯入檔案名稱的首碼。例如，該條命令表示待匯入的資料被儲存在以output1為首碼命名的檔案中。
   --public-cloud	用於標識從OceanBase 部署的 OceanBase 叢集中匯入資料庫物件或者表資料。
   --csv	指定待匯入的資料檔案格式為 CSV。您可以根據待匯入資料的實際格式進行指定，例如，--sql、--par 和--orc等。
   --direct	指定使用旁路匯入模式。該參數與 --rpc-port、--parallel 搭配使用。
   --parallel	用於旁路匯入時載入資料的並行度。該參數可選，預設值為 1，與 --rpc-port、--direct 搭配使用。
   --rpc-port 3307	用於串連 OBServer RPC 的連接埠。 表示雖然串連資料庫的連接埠為 3306（由 -P3306 指定），但是實際的資料匯入通過 3307 連接埠的 RPC 服務完成，以提高匯入效能。
   -P 3306	指定串連 OceanBase 資料庫的主機連接埠。

關閉旁路匯入

1. 登入 OceanBase 管理主控台。

2. 在左側導覽列中，單擊 執行個體列表。

3. 在執行個體列表中找到目的地組群執行個體，單擊叢集名稱，進入 叢集執行個體工作台。

4. 在左側導覽列，單擊 資料庫代理。

5. 在Proxy 位址列表中，單擊 關閉 為主地址的私網地址，關閉旁路匯入連接埠。

6. 在二次確認彈窗上單擊 確定。