OceanBase产品家族及基础概念、导入数据、OceanBase支持多种客户端工具、黑屏工具、 白屏工具、通过MySQL客户端连接MySQL租户

第二章：OceanBase产品家族及基础概念

2. 导入数据

2.1 OceanBase支持多种客户端工具

2.1.1 黑屏工具

2.1.1.1 OceanBase客户端

OceanBase 客户端（OBClient）同时兼容访问OceanBase 的 MySQL 以及Oracle 租户，因此是推荐的黑屏客户端工具。

2.1.1.2 MySQL客户端

OceanBase 全面兼容MySQL 协议，可以使用标准的 MySQL 客户端连接 OceanBase 的MySQL 租户，推荐使用5.6 或 5.7 版本的MySQL 客户端

2.1.2 白屏工具

2.1.2.1 OceanBase云平台

不仅提供对 OceanBase 集群和租户等组件的全生命周期管理服务，同时也对OceanBase 相关的资源（主机、网络和软件包等）提供管理服务

2.1.2.2 OceanBase开发者中心

企业级数据库开发平台。ODC 支持连接 OceanBase 中 MySQL 和 Oracle 模式下的数据库，同时为数据库开发者提供了数据库日常开发操作、WebSQL、SQL 诊断、会话管理和数据导入导出等功能

2.2 通过MySQL客户端连接MySQL租户

需要使用 OceanBase 的 MySQL 租户时，可以使用 MySQL 客户端连接该租户

2.2.1 操作步骤

• 打开一个命令行终端，确保环境变量 PATH 包含了 MySQL 客户端命令所在目录
• 参照下面格式提供 MySQL 的运行参数
$mysql -h192.168.1.101 -uroot@obmysql#obdemo -P2883 -pabcABC123 -c -A oceanbase

2.2.2 参数说明

• -h：提供 OceanBase 数据库连接 IP，通常是一个 OBProxy 地址
• -u：提供租户的连接账户，格式有两种：用户名@租户名#集群名或者 集群名:租户名:用户名 。MySQL 租户的管理员用户名默认是root
• -P：提供 OceanBase 数据库连接端口，也是 OBProxy 的监听端口，默认是2883，可以自定义
• -p：提供账户密码，为了安全可以不提供，改为在后面提示符下输入，密码文本不可见
• -c：表示在 MySQL 运行环境中不要忽略注释
• -A：表示在 MySQL 连接数据库时不自动获取统计信息
• oceanbase：访问的数据库名，可以改为业务数据库

连接成功后，默认会有命令行提示符：MySQL [oceanbase]>。如果要退出 OceanBase 命令行，输入exit 后回车，或者按快捷键 ctrl + d

2.3 通过obclient连接OceanBase租户

obclient 是 OceanBase 专用的命令行客户端工具，通过 obclient 可以连接 OceanBase 的 MySQL 和 ORACLE 租户参照下面格式提供 obclient 的运行参数：
$ obclient -h192.168.1.101 -usys@t_oracle0_91#obdoc -P2883 -pabcABC123 -c -A sys

2.3.1 说明:

• -h:提供OceanBase数据库连接的IP，通常是一个OBProxy 地址。
• -u:提供租户的连接帐户，格式有两种:“用户名@租户名#集群名"或者“集群名:租户名:用户名”。Oracle 租户的管理员用户名默认是sys。
• -P:提供OceanBase 数据库连接端口，也是OBProxy的监听端口，默认是2883，可以自定义。
• -p∶提供帐户密码。为了安全可以不提供，改为在后面提示符下输入，密码文本不可见。
• -C:表示在将SQL语句中的注释发往数据库端。
• -A∶表示在连接数据库时不去获取全部表信息，可以使登录数据库速度最快。. sys:访问的数据库名，可以改为业务数据库。

• 连接成功后，默认会有如下命令行提示符，obclient>，
• 如果要退出 OceanBase 命令行，输入exit 后回车，或者按快捷键 ctrl + d。

2.4 Java数据库连接驱动

• OceanBase 实现了自己的 JDBC 驱动，使 Java 能够将 SQL 语句发送到 OceanBase 的MySQL 租户和 Oracle 租户。OceanBase JDBC 支持为 Java 暴露 SQL 数据类型、PL/SQL 对象，并快速访问SQL数据
• OceanBase JDBC 驱动文件名为：oceanbase-client-[版本号].jar
• OceanBase 数据库驱动文件1.0 相关版本的类名为:com.alipay.oceanbase.obproxy.mysql.jdbc.Driver
• OceanBase 数据库驱动文件从1.1.0 后类名更改为：com.alipay.oceanbase.jdbc.Driver ，原类名会保留，但是不推荐使用

OceanBase 的 MySQL 租户兼容 MySQL 的连接协议，使用标准的 MySQL JDBC 可以连接 OceanBase 的MySQL 租户。但 JDBC 默认不支持 Oracle 租户的连接协议

2.5 通过ODC连接 OceanBase 数据库

在创建连接页面选择连接模式为 MySQL/Oracle，在页面中输入连接名称、主机名、端口、集群、租户、数据库用户名和数据库密码，点击保存，如果可以保存成功，说明连接数据库成功。

2.6 关于数据迁移和同步

• 数据从传统数据库迁移到 OceanBase 数据库上，可以选择将数据导出为 CSV 文件、SQL 文件，然后再导入到OceanBase 中
• 也可以使用 OceanBase 产品 DataX 或 OMS 在传统数据库和 OceanBase 之间做离线或在线数据迁移
• 注意：当数据迁移的数据量非常大时，如果迁移速度很快，可能导致 OceanBase 的增量内存消耗速度快于转储和合并释放内存的速度。此时需要针对数据迁移做参数修改，或内存写入限速，或者对实例做内存扩容

2.7 通用数据同步框架 DataX介绍

• DataX 是阿里巴巴集团内被广泛使用的离线数据同步工具/平台，实现包括 MySQL、Oracle、SqlServer、Postgre、HDFS、Hive、ADS、HBase、TableStore(OTS)、MaxCompute(ODPS)、DRDS 和 OceanBase 等各种异构数据源之间高效的数据同步功能
• DataX 本身作为数据同步框架，将不同数据源的同步抽象为从源头数据源读取数据的 Reader 插件，以及向目标端写入数据的 Writer 插件，理论上 DataX 框架可以支持任意数据源类型的数据同步工作
• DataX 安装后，默认目录在 /home/admin/datax3 。目录下有个文件夹 job ，默认存放数据迁移任务的配置文件，当然也可以自定义目录
• 每个任务的参数文件是一个 json 格式，主要由一个 reader 和一个 writer 组成。job 文件夹下有个默认的示例任务配置文件 job.json
• DataX 官网支持绝大部分主流数据源的读写插件，并且有详细的使用文档。针对 Oracle 数据库，用 oraclereader 和 oraclewriter 插件来读写