文档

通过 MySQL 客户端连接 OceanBase 租户

更新时间:

需要使用 OceanBase 数据库的 MySQL 租户时,可以使用 MySQL 客户端连接该租户。本节主要介绍该连接方式的前提条件、连接操作和示例。

前提条件

通过 MySQL 客户端连接数据库前,需要确认以下信息:

  • 确保本地已正确安装 MySQL 客户端。OceanBase 数据库当前版本支持的 MySQL 客户端版本包括 V5.5、V5.6 和 V5.7。

  • 确保环境变量PATH中包含了 MySQL 客户端命令所在目录。

操作步骤

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

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

    参数说明:

    参数

    含义

    -h

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

    -P

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

    -u

    提供租户的连接账号。

    -p

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

    -A

    表示在连接数据库时不去获取全部表信息,可以使登录数据库速度最快。

    -c

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

    -D

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

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

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

示例

  1. 通过 MySQL 客户端连接 OceanBase 的 MySQL 租户。

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

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

    Welcome to the MariaDB monitor. Commands end with ; or \g.
    Your MySQL connection id is 62488
    Server version: 5.6.25 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.
    
    MySQL [oceanbase]>
  2. 查看数据库。

    MySQL [oceanbase]> SHOW DATABASES;

    结果如下:

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

    MySQL [oceanbase]> exit
  4. 执行结果如下:

    Bye