此前曾经在文章《推荐一款数据库通用客户端(也支持OB)》里介绍过DBeaver可以连接OceanBase数据库，准确的说只能连接OceanBase的MySQL租户。OceanBase 从2.0开始新增兼容ORACLE的租户，DBeaver也可以通过新增数据库java驱动方式支持OceanBase的ORACLE租户。DBeaver不愧是一款优秀的通用的SQL客户端(有社区版，可以免费下载：https://dbeaver.io
)！
OceanBase 2.2的版本近期已通过官网放出，里面除了OceanBase数据库软件和部署软件外，还会有个数据库驱动文件，名字是：oceanbase-client-1.0.9.jar
文件。该驱动完全兼容 MySQL JDBC 的使用方式并且可以自动识别 OceanBase 租户的兼容模式是 MySQL 还是 Oracle，在协议层兼容 2 种模式，且兼容 OB2.0 协议。
DBeaver新增OceanBase驱动方法
I. 打开DBeaver，点击菜单【数据库(D)】-【驱动管理器】
II. 在【驱动管理器】里点击【新建(N)】。
III. 填写OceanBase驱动相关信息类名：com.alipay.oceanbase.obproxy.mysql.jdbc.Driver
URL模板：jdbc:oceanbase://<server>:<port>/<database>
默认端口：2883
这个默认端口是OBProxy的连接端口，默认都是2883. 当然也有的运维人员会把它设置为1521. 有关OBProxy简介请参考《从ORACLE/MySQL到OceanBase：数据访问代理》。
IV. 点击【添加文件】，找到驱动文件oceanbase-client-1.0.8.jar
位置。
DBeaver新增ORACLE租户连接
I. 在DBeaver里点击【数据库】-【新建连接】或者点击图标
II.填写数据库连接相关信息
用户名：格式有两种：账户名@租户名#集群名 或者 集群名:租户名:账户名
密码：账户名对应密码
用户名反映了OceanBase集群的数据架构的分层特征。一个OceanBase集群将一组物理服务器聚合为一个超级大的资源池，然后从中分配出大小和类型不同的租户(即实例)。租户才是给到业务方使用的，也就是通常说的数据库。当租户兼容MySQL时，租户就像MySQL实例，下面有很多database
，创建不同的用户访问不同的数据库；当租户兼容ORACLE时，租户就像ORACLE实例，下面有很多schema
(跟用户一一对应)。
这里还需要在【驱动属性】里填写数据库IP和端口、以及默认数据库(或schema
)
点击【测试链接】，会有“已连接”的提示！
ORACLE租户下SQL示例
OceanBase ORACLE租户下能运行一些常用的SQL语法，可以查询常用的视图。由于驱动本身没有实现所有接口，所以还不能使用DBEaver的图形化设计能力管理数据库对象(如表)，但是可以使用一些SQL操作。并且ORACLE租户保留了一些MySQL租户的SHOW
命令，很方便查看数据库对象。
用户权限管理
-
建用户
-- 用户管理
CREATE USER scott identified BY tiger;
GRANT ALL PRIVILEGES ON scott.* TO scott WITH GRANT option;
GRANT SELECT,CREATE ,DROP ON *.* TO scott;
-
查看用户
-
查看用户权限
表管理
-
建表
CREATE TABLE DEPT(
DEPTNO NUMBER(2) NOT NULL
,DNAME VARCHAR2(14)
,LOC VARCHAR2(13)
,CONSTRAINT PK_DEPT PRIMARY KEY(DEPTNO)
);
-- DROP TABLE EMP;
CREATE TABLE EMP(
EMPNO NUMBER(4)
,ENAME VARCHAR2(10)
,JOB VARCHAR2(9)
,MGR NUMBER(4) NULL
,HIREDATE DATE
,SAL NUMBER(7,2)
,COMM NUMBER(7,2)
,DEPTNO NUMBER(2) -- CONSTRAINT FK_DEPTNO REFERENCES DEPT
,CONSTRAINT PK_EMP PRIMARY KEY(EMPNO)
);
-
查看表结构
SHOW CREATE TABLE scott.dept;
-
查看索引结构
SELECT t1.owner, t1.table_name, t1.index_name, t1.index_type, t1.uniqueness, t2.column_name, t2.column_position, descend
FROM all_indexes t1 JOIN all_ind_columns t2 ON (t1.owner=t2.table_owner AND t1.table_name=t2.table_name AND t1.index_name=t2.index_name)
WHERE t1.owner ='SCOTT' AND t1.table_name='DEPT'
;
创建存储过程
-- obclient -h127.1 -utpcc@tnt_oracle#obdemo -P2883 -p123456
delimiter //
CREATE OR REPLACE PROCEDURE stocklevel (
ware_id INTEGER,
dist_id INTEGER,
threshold INTEGER,
low_stock OUT INTEGER
)
IS
BEGIN
SELECT count (DISTINCT s_i_id)
INTO low_stock
FROM ordl, stok, dist
WHERE ol_w_id = ware_id AND d_id = dist_id AND d_w_id = ware_id AND
d_id = ol_d_id AND d_w_id = ol_w_id AND
ol_i_id = s_i_id AND ol_w_id = s_w_id AND
s_quantity < threshold AND
ol_o_id BETWEEN (d_next_o_id - 20) AND (d_next_o_id - 1);
COMMIT;
END stocklevel;
//
delimiter ;存储过程的创建在DBeaver里创建跟在命令工具obclient
里有点不同，不需要借助delimiter
命令改变语句终结符。直接选中存储过程SQL，按快捷键CTRL+ENTER
即可。
-
查看存储过程内容
SHOW CREATE PROCEDURE stocklevel;
Java应用连接OceanBase的方法
Java应用也可以使用OceanBase Java驱动连接租户(实例)。
添加 Maven 依赖
<dependency>
<groupId>com.alipay.oceanbase</groupId>
<artifactId>oceanbase-client</artifactId>
<version>1.0.9</version>
</dependency>
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<!--推荐版本18，经过测试14~18都可以-->
<version>18.0</version>
</dependency>
修改 JDBC 连接串
连接串的前缀需要设置为 jdbc:oceanbase
，其他部分的使用方式与原生的 MySQL 使用方式保持一致。
String url = "jdbc:oceanbase://10.***.***.83:2883/SYS?useUnicode=true&characterEncoding=utf-8";
String username = "scott@tnt_oracle#obdemo";
String password = "tiger";
Connection conn = null;
try {
Class.forName("com.alipay.oceanbase.obproxy.mysql.jdbc.Driver");
conn = DriverManager.getConnection(url, username, password);
PreparedStatement ps = conn.prepareStatement("select to_char(sysdate,'yyyy-MM-dd HH24:mi:ss') from dual;");
ResultSet rs = ps.executeQuery();
rs.next();
System.out.println("sysdate is:" + rs.getString(1));
rs.close();
ps.close();
} catch (Exception e) {
e.printStackTrace();
} finally {
if (null != conn) {
conn.close();
}
}
对于 Druid 框架，如果没有使用 DriverManager，需要直接指定 DrvierClass，如下
<property name"driverClassName" value="com.alipay.oceanbase.obproxy.mysql.jdbc.Driver">
OceanBase错误号
初次使用OceanBase时，经常会碰到各种错误，需要查看相应的错误号才能初步理解报错原因。
OceanBase MySQL租户的错误号都是负数，[-4000, -1]期间的跟MySQL错误号保持一致, 小于-4000的错误号为OceanBase新增的错误号。 详细错误号定义请查看帮助文档( https://tech.antfin.com/docs/2/YQ1174849)。
OceanBase ORACLE租户的错误号有些跟ORACLE错误号定义是一致的，有些是自己特有的。详细错误号定义请查看帮助文档(https://tech.antfin.com/docs/2/YQ1243092)。
其他
DBeaver可以一定程度方便初学者了解OceanBase，但图形化使用上跟OB驱动还不完全彼此兼容，所以体验还不是非常好。OceanBase开发团队也在开发适合OceanBase的图形化客户端工具。