通过 MySQL 客户端连接数据库

更新时间：2023-07-19 13:03:06

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

mysql 是 MySQL 数据库命令行下客户端，需要单独安装。OceanBase 数据库租户包括 MySQL 兼容租户和 Oracle 兼容租户。当访问 MySQL 兼容租户时，可以通过 mysql 连接。

连接 OceanBase 数据库后，在 mysql 的命令行环境里，可以运行 mysql 运维命令和 SQL 语句来执行以下任务：

计算、存储和打印查询结果。
创建数据库对象、检查和修改对象定义。
执行数据库管理和修改参数等。

前提条件

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

确保本地已正确安装 MySQL 客户端。OceanBase 数据库当前版本支持的 MySQL 客户端版本包括 V5.5、V5.6 和 V5.7。
确保环境变量 PATH 中包含了 MySQL 客户端命令所在目录。
连接租户前，请确认当前客户端在租户白名单中，租户白名单的查询及设置具体操作请参见设置和查看租户白名单。

操作步骤

打开一个命令行终端。
使用 MySQL 命令连接 MySQL 租户。
- 通过 OBProxy 连接的方式
```
$mysql -h10.10.10.1 -uusername@obmysql#obdemo -P2883 -ppassword -c -A oceanbase
```
  或者
```
$mysql -h10.10.10.1 -uobdemo:obmysql:username -P2883 -ppassword -c -A oceanbase
```
  参数说明：
  - -h：提供 OceanBase 数据库连接 IP，通常是一个 OBProxy 地址。
  - -u：提供租户的连接账户，格式有两种：用户名@租户名#集群名或者 集群名:租户名:用户名。使用 My SQL 客户端仅支持连接 MySQL 租户，MySQL 租户的管理员用户名默认是 root。
  - -P：提供 OceanBase 数据库连接端口，也是 OBProxy 的监听端口，默认是 2883，可以自定义。
  - -c：表示在 MySQL 运行环境中不要忽略注释。
  - -A：表示在 MySQL 连接数据库时不自动获取统计信息。
  - oceanbase：访问的数据库的名称，可以更改为业务数据库。
  示例：
```
$mysql -h10.10.10.1 -u******@obmysql#obdemo -P2883 -p****** -c -A oceanbase
```
  或者
```
$mysql -h10.10.10.1 -uobdemo:obmysql:****** -P2883 -p****** -c -A oceanbase
```
- 通过直连方式
```
$mysql -h10.10.10.1 -uusername@obmysql -P2881 -ppassword -c -A oceanbase
```
  参数说明：
  - -h：提供 OceanBase 数据库连接 IP，通常是一个 OBServer 的 IP 地址。
  - -u：提供租户的连接账户，格式为：用户名@租户名。使用 My SQL 客户端仅支持连接 MySQL 租户，MySQL 租户的管理员用户名默认是 root。
  - -P：提供 OceanBase 数据库连接端口，默认是 2881，可以自定义。
  - -p：提供账户密码，为了安全可以不提供，改为在后面提示符下输入，密码文本不可见。
  - -c：表示在 MySQL 运行环境中不要忽略注释。
  - -A：表示在 MySQL 连接数据库时不自动获取统计信息。
  - oceanbase：访问的数据库的名称，可以更改为业务数据库。
  - 普通租户通过直连方式连接时，需要确保该租户的资源分布在该 OBServer上，如果该租户的资源未分布在该 OBServer 上，则无法通过直连该 OBServer 连接到该租户。
  示例：
```
$mysql -h10.10.10.1 -u******@obmysql -P2881 -p****** -c -A oceanbase
```
连接成功后，默认会有命令行提示符。
```
MySQL [oceanbase]> 
```
如果需要退出 MySQL 命令行，输入 exit 后回车，或者按快捷键 Ctrl + D 。

示例

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

$mysql -h10.10.10.1 -u******@obmysql#obdemo -P2883 -p****** -c -A oceanbase
Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MySQL connection id is 127765
Server version: 5.6.25 OceanBase 3.2.0 (...) (Built Jun 19 2021 11:36:47)
<Omitted>
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

MySQL [oceanbase]> SHOW DATABASES;
+--------------------+
| Database           |
+--------------------+
| oceanbase          |
| information_schema |
| mysql              |
| test               |
+--------------------+
4 rows in set (0.00 sec)
MySQL [oceanbase]> exit
Bye

通过 MySQL 客户端连接数据库

前提条件

操作步骤

示例

更多信息