连接租户

连接租户 #

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++ 。

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