OceanBase 客户端（OBClient） 是 OceanBase 数据库专用的命令行客户端工具，通过 OBClient 您可以连接 OceanBase 数据库的 MySQL 和 Oracle 租户。

前提条件

已从 OceanBase 数据库技术团队人员处获取了 OBClient 应用。

操作步骤

  1. 打开一个命令行终端。

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

    • 通过 OBProxy 连接的方式

      1. $obclient -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. $obclient -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. obclient>

  4. 如果需要退出 OceanBase 数据库命令行，输入 exit 后回车，或者按快捷键 Ctrl + D。

示例

  • 通过 OBClient 连接 OceanBase 数据库的 MySQL 租户。

    1. $obclient -h10.10.10.1 -uroot@obmysql#obdemo -P2883 -pabcABC123 -c -A sys
    2. obclient: [Warning] Using a password on the command line interface can be insecure.
    3. Welcome to the OceanBase monitor.  Commands end with ; or \g.
    4. Your OceanBase connection id is 3221495183
    5. Server version: 5.7.25 OceanBase 2.2.77 (…) (Built Oct 23 2020 11:00:48)
    7. <省略>
    9. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
    11. obclient> SELECT SYSDATE() FROM dual;
    12. +---------------------+
    13. | SYSDATE()           |
    14. +---------------------+
    15. | 2020-12-24 13:52:11 |
    16. +---------------------+
    17. 1 row in set (0.00 sec)
    19. obclient> exit
    20. Bye

  • 通过 OBClient 连接 OceanBase 数据库的 Oracle 租户。

    1. $obclient -h10.10.10.1 -usys@t_oracle0_91#obdoc -P2883 -pabcABC123 -c -A sys
    2. obclient: [Warning] Using a password on the command line interface can be insecure.
    3. Welcome to the OceanBase monitor.  Commands end with ; or \g.
    4. Your OceanBase connection id is 3221841095
    5. Server version: 5.7.25 OceanBase 2.2.74 (...) (Built Jul 15 2020 21:30:23)
    7. <省略>
    9. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
    11. obclient> SELECT SYSDATE FROM dual;
    12. +-----------+
    13. | SYSDATE   |
    14. +-----------+
    15. | 24-DEC-20 |
    16. +-----------+
    17. 1 row in set (0.01 sec)
    19. obclient> exit
    20. Bye