---
title: "通过 MySQL 客户端连接数据库 | OceanBase 文档中心"
description: 通过 MySQL 客户端连接数据库 需要使用 OceanBase 数据库的 MySQL 租户时，可以使用 MySQL 客户端连接该租户。 mysql 是 MySQL 数据库命令行下客户端，需要单独安装。OceanBase 数据库租户包括 MySQL 兼容租户和 Oracle 兼容租户。当访问 MySQL 兼容租户时，…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 3.2.3 企业版 LTS

# 通过 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 客户端命令所在目录。
 - 连接租户前，请确认当前客户端在租户白名单中，租户白名单的查询及设置具体操作请参见 [设置和查看租户白名单](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000355590)。

## 操作步骤

1. 打开一个命令行终端。
 2. 使用 MySQL 命令连接 MySQL 租户。

      - 通过 OBProxy 连接的方式

       ```sql
       $mysql -h10.10.10.1 -uusername@obmysql#obdemo -P2883 -ppassword -c -A oceanbase

       ```

       或者

       ```sql
       $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：访问的数据库的名称，可以更改为业务数据库。

       示例：

       ```sql
       $mysql -h10.10.10.1 -u******@obmysql#obdemo -P2883 -p****** -c -A oceanbase

       ```

       或者

       ```sql
       $mysql -h10.10.10.1 -uobdemo:obmysql:****** -P2883 -p****** -c -A oceanbase

       ```
      - 通过直连方式

       ```sql
       $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 连接到该租户。

       示例：

       ```sql
       $mysql -h10.10.10.1 -u******@obmysql -P2881 -p****** -c -A oceanbase

       ```
 3. 连接成功后，默认会有命令行提示符。

   ```sql
   MySQL [oceanbase]>

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

## 示例

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

```sql
$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 客户端连接 OceanBase 数据库的过程中遇到问题，建议您查阅 MySQL 客户端官方的使用文档。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线