连接租户 #
OceanBase 数据库开源版仅兼容 MySQL 租户,连接协议兼容 MySQL 5.6。因此使用 MySQL 命令行客户端或者图形化工具理论上也能连接 OceanBase 数据库的租户。此外,OceanBase 数据库也提供专属的命令行客户端工具 OBClient 和图形化客户端工具 ODC。
客户端连接 #
OceanBase 数据库 MySQL 租户支持传统 MySQL 客户端以及 OBClient 客户端连接,跟传统 MySQL 不一样的地方是用户名的格式。
说明
OceanBase 数据库当前版本支持的 MySQL 客户端版本包括 V5.5、V5.6 和 V5.7。
连接示例如下:
mysql -h xxx.xxx.xxx.xxx -uroot@sys#obdemo -P2883 -p -c -A oceanbase
obclient -h xxx.xxx.xxx.xxx -uroot@sys#obdemo -P2883 -p -c -A oceanbase
说明:
-h:提供 OceanBase 数据库连接 IP,通常是一个 ODP 地址。
-u:提供租户的连接账户,通过 ODP 连接时格式有四种:用户名@租户名#集群名、集群名:租户名:用户名、集群名-租户名-用户名、集群名.租户名.用户名,推荐使用 用户名@租户名#集群名。如果是直连 OBServer 节点,用户名需去掉集群名。MySQL 租户的管理员用户名默认是 root。
-P:提供 OceanBase 数据库连接端口,通过 ODP 连接时为 listen_port 配置项的值,默认是 2883;通过 OBServer 节点直连时为 mysql_port 配置项的值,默认为 2881。连接端口均可在部署 OceanBase 数据库时自定义。
-p:提供账户密码,为了安全可以不提供,改为在后面提示符下输入,密码文本不可见。
-c:表示在 MySQL 运行环境中不要忽略注释。
-A:表示在 MySQL 连接数据库时不自动获取统计信息。
oceanbase:访问的数据库名,可以改为业务数据库。
新创建的业务租户的管理员(root)密码默认为空,需要修改密码。
mysql -h x.x.x.x -uroot@obmysql#obdemo -P2883 -p -c -A oceanbase
MySQL [oceanbase]> alter user root identified by 'b******t' ;
Query OK, 0 rows affected (0.118 sec)
OceanBase 连接驱动(JDBC) #
OceanBase 数据库目前支持的应用主要是 Java 和 C/C++ 。
Java 语言
MySQL 官方 JDBC 驱动下载地址: MySQL Connector/J 5.1.46
OceanBase 官方 JDBC 驱动下载地址: OceanBase-Client
C 语言
具体驱动说明请参考官网文档: OceanBase Connector/C 简介
下载地址: OceanBase Connector/C 下载
DBeaver 客户端连接 #
DBeaver 是一款通用的数据库客户端工具,其原理是使用各个数据库提供的 JDBC 驱动连接数据库,支持常见的关系型数据库、非关系型数据库、分布式数据库等等。使用 OceanBase 提供的 JDBC 驱动或者 MySQL 官方驱动,DBeaver 也可以连接 OceanBase 数据库的 MySQL 租户。
官方下载地址: https://dbeaver.io/download/
DBeaver 连接 OceanBase 数据库时可选择 MySQL 数据库类型,第一次使用会自动下载官方 MySQL 驱动。详细操作可参考 OceanBase 数据库文档 通过 DBeaver 连接数据库 一文。
ODC 客户端连接 #
OceanBase 提供官方图形化客户端工具 OceanBase Developer Center,简称 ODC,是目前对 OceanBase 数据库适配性最好的客户端工具。该工具的详细信息请参考官网文档 OceanBase 开发者中心 。
ODC 下载地址: 下载客户端版 ODC 。