--- title: "通过 DBeaver 连接数据库 | OceanBase 文档中心" description: 通过 DBeaver 连接数据库 DBeaver 是一款通用的数据库客户端工具，其原理是使用各个数据库提供的 JDBC 驱动连接数据库，支持常见的关系型数据库、非关系型数据库、分布式数据库等等。 使用 DBeaver 自带的 OceanBase 驱动或 MySQL 驱动均可连接 OceanBase 数据库的 MySQ… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 3.1.5 社区版 # 通过 DBeaver 连接数据库 更新时间：2026-06-22 09:30:16 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V3.1.5/zh-CN/100.users-guide/500.database-connection-and-routing/400.administrator-guide-connect-to-oceanbase-database/400.connect-to-oceanbase-database-through-dbeaver.md) DBeaver 是一款通用的数据库客户端工具，其原理是使用各个数据库提供的 JDBC 驱动连接数据库，支持常见的关系型数据库、非关系型数据库、分布式数据库等等。 使用 DBeaver 自带的 OceanBase 驱动或 MySQL 驱动均可连接 OceanBase 数据库的 MySQL 租户，本文将以 OceanBase 驱动为例介绍如何使用 DBeaver 连接 OceanBase 数据库的 MySQL 租户。 ## 前提条件 - 请确保已获取并安装 DBeaver，您可访问 [DBeaver 官方下载地址](https://dbeaver.io/download/) 下载系统对应的 DBeaver。 - 请确保待连接的 OBServer 节点 IP 与 DBeaver 所在机器保持网络连通。 ## 操作步骤 > **说明** > > > > 不同 DBeaver 版本的操作界面可能不同，本文档以 DBeaver 22.0.5 版本为例提供数据库的连接指导，其他版本的操作请参考 DBeaver 对应版本的产品文档。 1. （可选）更换驱动文件版本。 DBeaver 中 OceanBase 驱动默认的驱动文件为 mysql-connector-java-5.1.44，建议使用 mysql-connector-java-5.1.47 版本。可参考如下步骤更换驱动文件。 1. 访问 MySQL 官方 [JDBC 驱动下载](https://downloads.mysql.com/archives/c-j/) 页面下载 5.1.47 版本驱动文件。 2. 单击 **数据库** > **驱动管理器**，搜索 OceanBase，选中 OceanBase 驱动后单击 **编辑**，进入到编辑驱动页面。 3. 选择 **库** 页签，选中 OceanBase 驱动自带的驱动文件，单击 **删除**。 4. 单击 **添加文件**，将下载的驱动文件添加到库中，单击 **确定** 即可完成驱动文件的更换。 2. 单击 **数据库** > **新建数据库连接**，进入到 **选择您的数据库** 页面。您也可以单击 **文件** 下方的连接符 ![连接符](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer/V3.1.3/zh-CN/1.users-guide/5.database-connection-and-routing/4.administrator-guide-connect-to-oceanbase-database/4.connect-to-oceanbase-database-through-dbeaver-01.png) 直接进入到 **选择您的数据库** 页面。 ![选择您的数据库](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer/V3.1.3/zh-CN/1.users-guide/5.database-connection-and-routing/4.administrator-guide-connect-to-oceanbase-database/4.connect-to-oceanbase-database-through-dbeaver-02.png) 3. 在 **选择您的数据库** 页面选择 **OceanBase**，单击 **下一步**，进入到 **连接设置** 页面，根据待连接的数据库信息进行填写，之后单击 **测试连接**。 ![测试](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer/V3.1.3/zh-CN/1.users-guide/5.database-connection-and-routing/4.administrator-guide-connect-to-oceanbase-database/4.connect-to-oceanbase-database-through-dbeaver-03.png) > **说明** > > > > 您可通过 IP 直连或 OBProxy 代理两种方式连接数据库。直连时 Port 填写配置的 `mysql_port` 进行连接，默认端口为 2881。使用 OBProxy 连接时，Port 填写配置的 `prometheus_listen_port`，默认端口为 2883。 > > > > 推荐使用 OBProxy 进行连接，用户名格式为：`用户名@租户名#集群名`。 4. 当 **连接测试** 弹窗中显示 **已连接**，表示可成功连接，单击 **确定** 后，单击 **完成** 即可连接到 OceanBase 数据库。 ![连接成功](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer/V3.1.3/zh-CN/1.users-guide/5.database-connection-and-routing/4.administrator-guide-connect-to-oceanbase-database/4.connect-to-oceanbase-database-through-dbeaver-04.png) 5. 双击 **数据库导航** 栏中的数据库名称，展开后如下图，即代表已成功连接 OceanBase 数据库。 ![连接结果](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer/V3.1.3/zh-CN/1.users-guide/5.database-connection-and-routing/4.administrator-guide-connect-to-oceanbase-database/4.connect-to-oceanbase-database-through-dbeaver-05.png) 上一篇 下一篇 ![有帮助](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) 咨询热线