---
title: "通过 OBClient 连接 OceanBase 数据库 | OceanBase 文档中心"
description: 通过 OBClient 连接 OceanBase 数据库 OBClient 是一个交互式和批处理查询工具，通过 OBClient 您可以连接 OceanBase 数据库。 前提条件 请确认已下载并安装了 OBClient 应用。如果未下载 OBClient 应用，您可以通过以下方式进行安装： 通过命令行安装 yum …
---
切换语言

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

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

# 通过 OBClient 连接 OceanBase 数据库

更新时间：2026-04-24 15:26:42

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V3.1.5/zh-CN/1400.developer-guide/000.connect-to-oceanbase-database/300.connect-oceanbase-tenants-through-obclient.md)  

OBClient 是一个交互式和批处理查询工具，通过 OBClient 您可以连接 OceanBase 数据库。

## 前提条件

请确认已下载并安装了 OBClient 应用。如果未下载 OBClient 应用，您可以通过以下方式进行安装：

- 通过命令行安装

  ```shell
  yum install -y obclient

  ```
 - 下载安装包：访问 [软件中心](https://open.oceanbase.com/softwareCenter/community)，打开 OBClient 的下载界面，选择需要的版本进行下载。

## 操作步骤

1. 打开一个命令行终端。
 2. 连接数据库。

   支持通过 OBProxy 连接数据库或者直接连接数据库。

      - 通过 OBProxy 连接的方式

       ```sql
       obclient -h10.10.10.1 -u****@obtenant#obdemo -P2883 -p****** -c -A oceanbase

       ```

       或者

       ```sql
       obclient -h10.10.10.1 -uobdemo:obtenant:**** -P2883 -p****** -c -A oceanbase

       ```

       > **说明**
       >
       >  
       >      - -h：提供 OceanBase 数据库连接 IP，通常是一个 OBProxy 地址。
       >      - -u：提供租户的连接账户，格式有两种：`用户名@租户名#集群名` 或者 `集群名:租户名:用户名`。租户的管理员用户名默认是 `root`。
       >      - -P：提供 OceanBase 数据库连接端口，也是 OBProxy 的监听端口，默认是 2883，可以自定义。
       >      - -p：提供帐号密码。为了安全可以不提供，改为在后面提示符下输入，密码文本不可见。
       >      - -c：表示在运行环境中不要忽略注释。
       >      - -A：表示在连接数据库时不自动获取统计信息。
       >      - oceanbase：访问的数据库的名称，可以更改为业务数据库。

       示例如下：

       ```

       或者

       ```
      - 通过直连方式

       ```sql
       obclient -h10.10.10.1 -u****@obtenant -P2881 -p****** -c -A oceanbase

       ```

       > **说明**
       >
       >  
       >      - -h：提供 OceanBase 数据库连接IP，通常是一个 OBServer 的 IP 地址。
       >      - -u：提供租户的连接账户，格式：`用户名@租户名`。租户的管理员用户名默认是 `root`
       >      - -P：提供 OceanBase 数据库连接端口，默认是 2881，可以自定义。
       >      - -p：提供账户密码，为了安全可以不提供，改为在后面提示符下输入，密码文本不可见。
       >      - -c：表示在运行环境中不要忽略注释。
       >      - -A：表示在连接数据库时不自动获取统计信息。
       >      - oceanbase：访问的数据库的名称，可以更改为业务数据库。
       >      - 普通租户通过直连方式连接时，需要确保该租户的资源分布在该 OBServer上，如果该租户的资源未分布在该 OBServer 上，则无法通过直连该 OBServer 连接到该租户。

       示例：

       ```sql
       obclient -h10.10.10.1 -u******@obtenant -P2881 -p****** -c -A oceanbase

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

   ```sql
   obclient>

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

## 示例

通过 OBClient 连接 OceanBase 数据库。

```sql
$obclient -h10.10.10.1 -u****@obmysql#obdemo -P2883 -p****** -c -A sys
Welcome to the OceanBase.  Commands end with ; or \g.
Your MySQL connection id is 5751
Server version: 5.6.25 OceanBase 3.1.4 (r10100032022041510-a09d3134c10665f03fd56d7f8bdd413b2b771977) (Built Apr 15 2022 02:16:22)

Copyright (c) 2000, 2022, OceanBase and/or its affiliates. All rights reserved.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

obclient> SELECT SYSDATE() FROM dual;
+---------------------+
| SYSDATE()           |
+---------------------+
| 2021-06-29 15:31:50 |
+---------------------+
1 row in set

obclient> exit
Bye

```

 上一篇 下一篇 ![有帮助](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) 咨询热线