通过 OBClient 连接 OceanBase 租户

OceanBase 客户端 OBClient 是 OceanBase 数据库专用的命令行工具,通过 OBClient 您可以连接 OceanBase 数据库的 MySQL 模式和 Oracle 模式租户。本文主要介绍连接方式的前提条件和操作步骤。

前提条件

请确认已下载并安装了 OBClient 应用。如果未下载 OBClient 应用,您可以访问软件中心下载对应版本的 OBClient(OceanBase 命令行客户端)。

操作步骤

  1. 在命令行中输入 OBclient 的运行参数。格式请参见如下示例。

    $ obclient -hxxx.xxx.xxx.xxx -P3306 -u a**** -p****** -c -A -Doceanbase

    参数说明:

    参数

    含义

    -h

    提供 OceanBase 数据库连接的域名。

    -P

    提供 OceanBase 数据库连接端口,MySQL 模式租户默认是 3306。

    -u

    提供租户的连接账号。

    -p

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

    -A

    表示连接数据库时不获取全部表信息,以快速登录数据库。

    -c

    表示在 MySQL 运行环境中不忽略注释。

    -D

    访问的数据库名,可以改为对应的业务数据库。

  2. 连接成功后,命令行终端出现默认的 OBClient 命令行提示符,如下例所示:

    obclient [oceanbase]>
  3. 如需退出 OBClient 命令行,可以输入exit后按回车键,或者使用快捷键 Ctrl + D

示例

  1. 通过 OBClient 连接 OceanBase 数据库的 MySQL 模式租户。

    $ obclient -hxxx.xxx.xxx.xxx -P3306 -u a**** -p****** -c -A -Doceanbase

    登录成功后,返回如下结果:

    Welcome to the OceanBase.  Commands end with ; or \g.
    Your OceanBase connection id is 117093
    Server version: OceanBase 3.2.4.2 (…) (Built Feb 27 2023 17:31:19)
    
    <省略>
    
    Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
    
    obclient [oceanbase]> 
  2. 查看数据库。

    obclient [oceanbase]> SHOW DATABASES;

    结果如下:

    +--------------------+
    | Database           |
    +--------------------+
    | oceanbase          |
    | information_schema |
    | mysql              |
    | rainoon            |
    +--------------------+
    4 rows in set
    Bye
  3. 输入 exit 后按回车键退出。

    obclient [oceanbase]> exit

    执行结果如下:

    Bye