需要使用 OceanBase 数据库 的 MySQL 租户时,可以使用 MySQL 客户端连接该租户。

操作步骤

  1. 打开一个命令行终端,确保环境变量 PATH 包含了 MySQL 客户端命令所在目录。

  2. 参照下面格式提供 MySQL 的运行参数:

    • 通过 OBProxy 连接的方式

      1. $mysql -h10.10.10.1 -uroot@obmysql#obdemo -P2883 -pabcABC123 -c -A oceanbase

      说明

      • -h:提供 OceanBase 数据库连接 IP,通常是一个 OBProxy 地址。

      • -u:提供租户的连接账户,格式有两种:用户名@租户名#集群名 或者 集群名:租户名:用户名。MySQL 租户的管理员用户名默认是 root。

      • -P:提供 OceanBase 数据库连接端口,也是 OBProxy 的监听端口,默认是 2883,可以自定义。

      • -c:表示在 MySQL 运行环境中不要忽略注释。

      • -A:表示在 MySQL 连接数据库时不自动获取统计信息。

      • oceanbase:访问的数据库名,可以更改为业务数据库。

    • 通过直连方式

      1. $mysql -h10.10.10.1 -uroot@obmysql -P2881 -pabcABC123 -c -A oceanbase

      说明

      • -h:提供 OceanBase 数据库连接 IP,通常是一个 OBServer 的 IP 地址。

      • -u:提供租户的连接账户,格式有两种:用户名@租户名 或者 租户名:用户名。MySQL 租户的管理员用户名默认是 root。

      • -P:提供 OceanBase 数据库连接端口,默认是 2881,可以自定义。

      • -p:提供账户密码,为了安全可以不提供,改为在后面提示符下输入,密码文本不可见。

      • -c:表示在 MySQL 运行环境中不要忽略注释。

      • -A:表示在 MySQL 连接数据库时不自动获取统计信息。

      • oceanbase:访问的数据库名,可以更改为业务数据库。

      • 普通租户通过直连方式连接时,需要确保该租户的资源分布在该 OBServer上,如果该租户的资源未分布在该 OBServer 上,则无法通过直连该 OBServer 连接到该租户。

  3. 连接成功后,默认会有命令行提示符:

    1. MySQL [oceanbase]>
  4. 如果需要退出 OceanBase 数据库命令行,输入 exit 后回车,或者按快捷键 Ctrl + D

示例

通过 MySQL 客户端连接 OceanBase 数据库的 MySQL 租户:

  1. $mysql -h10.10.10.1 -uroot@obmysql#obdemo -P2883 -pabcABC123 -c -A oceanbase
  2. Welcome to the MariaDB monitor. Commands end with ; or \g.
  3. Your MySQL connection id is 3221495183
  4. Server version: 5.7.25 OceanBase 2.2.74 (…) (Built Oct 23 2020 11:00:48)
  5. <…省略…>
  6. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
  7. MySQL [oceanbase]> SHOW DATABASES;
  8. +--------------------+
  9. | Database |
  10. +--------------------+
  11. | oceanbase |
  12. | information_schema |
  13. | mysql |
  14. | test |
  15. +--------------------+
  16. 4 rows in set (0.00 sec)
  17. MySQL [oceanbase]> exit
  18. Bye