--- title: "通过桌面版 ODC 连接 OB Cloud 云数据库 - OB Cloud 云数据库 master | OceanBase 文档中心" description: 通过桌面版 ODC 连接 OB Cloud 云数据库 ODC 桌面版支持连接 OB Cloud 的 MySQL 兼容模式租户。本文主要介绍该连接方式的前提条件和连接操作。 前提条件 已安装 OceanBase 开发者中心（ODC）桌面版。详细操作，请参见 安装桌面版 ODC 。 已在 OB Cloud 实例下获取目标… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*qbZXRo_94ZEAAAAAAAAAAAAADiGDAQ/original) OB Cloud 云数据库 # 通过桌面版 ODC 连接 OB Cloud 云数据库 更新时间：2026-06-24 09:08:46 ODC 桌面版支持连接 OB Cloud 的 MySQL 兼容模式租户。本文主要介绍该连接方式的前提条件和连接操作。 ## 前提条件 - 已安装 OceanBase 开发者中心（ODC）桌面版。详细操作，请参见 [安装桌面版 ODC](https://www.oceanbase.com/docs/common-odc-1000000001418146)。 - 已在 OB Cloud 实例下获取目标 MySQL 兼容模式租户的连接串。详细操作，请参见 [获取连接串](https://www.oceanbase.com/docs/common-oceanbase-cloud-10000000001781435)。 ## 操作步骤 1. 打开 ODC 桌面版，在 **数据源** 界面左侧顶部的搜索框旁，单击 **+** > **OB Cloud MySQL**。 ![](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/cloud/24v4/730.data-sources-management/100.create-data-sources/client%20odc/1.png) 2. 在弹出的 **新建数据源** 面板中，根据 **前提条件** 中获取的连接串，填写或选择以下信息。 ![](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/cloud/24v4/730.data-sources-management/100.create-data-sources/client%20odc/2.png) | 信息项 | 说明 | | --- | --- | | 智能解析（可选） | 您可以选择在智能解析文本框中粘贴连接串信息，ODC 会自动识别连接串并在窗口中填充各项连接信息。 | | 连接地址 | - **主机 IP/域名**：连接的数据库所在服务器的 IP 或域名信息。 - **端口**：连接的数据库所在服务器的端口号信息。 | | 数据库账号 | - **数据库用户名**：在租户中创建的账号（MySQL 模式下，该账户必须具有访问默认数据库的权限）。 - **数据库密码**：在租户中创建的账号的密码。单击 **测试连接**，测试是否能够连接到目标数据库。 #### 说明 - 如配置信息有误，会出现异常提示，例如用户或密码不对、网络异常等。 - 用户只可连接本租户下的数据库，否则会报出测试失败的错误。 - 保存前，可以单击 **测试连接** 进行数据库连接测试，如果数据库用户名和密码正确，则会显示**连接成功**。ODC V4.0.0 及之后版本支持不填账号密码即可保存连接。 | | 环境 | 用户根据需求选择环境类型：开发/测试/生产等。 | | 高级设置 | - sys 租户账号：选择是否 **使用 sys 租户账号查询租户视图**，勾选后输入 **账号** 和 **密码**。 数据库类型为物理库时，请输入拥有查询 sys 租户视图权限的账号和密码，当 **连接地址** 中已指定 **租户** 为 sys 时，该项被自动填充。 - **账户** ：拥有 sys 租户视图查看权限的账号。 - **密码** ：账号对应的密码。 输入账户和密码信息后，单击密码框后的 **测试连接** 按钮测试账户信息是否正确。 - SSL：选择是否启用 SSL 加密 SSL 链路，以保证客户端和服务器之间数据的安全传输。 通过 ODC 启用 SSL 前，须确认 OBServer 端已开启 SSL；如通过 OBProxy 连接，同样需保证 OBProxy 已开启 SSL。如何在 Server 端开启 SSL，请参见 [OBServer 传输加密](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000944716) 和 [公有云 OceanBase SSL 链路加密](https://help.aliyun.com/document_detail/254643.html)。 - 连接初始化脚本：支持通过 SQL 语句配置连接会话。示例：`set session ob_query_timeout=60000000` - 驱动属性：支持配置 [驱动属性](https://www.oceanbase.com/docs/common-oceanbase-connector-j-cn-1000000000130260) 连接到 OceanBase 数据库并实现指定功能。 #### 说明 - ODC V2.3.0 及之后的版本，导入导出功能需在创建连接的高级配置中设置 root@sys 用户。 - ODC V2.4.1 及之后的版本，导入导出功能查询视图信息时取消 root@sys 账号强依赖（如未配置 root@sys 账号，ODC 部分对象如存储过程和函数等不支持导出功能；如配置 root@sys 账号，通过访问 sys 租户下的视图信息得到最优的数据路由策略，可提升导出速度）。 - **sys 租户账号和密码** 为集群租户下用户的账号和密码 (账号请勿填入“@sys#集群”)。例如：账号为 root。 - 通过非加密方式（require none）创建的用户（默认为 require none）可根据需求选择是否开启 SSL。如果勾选 **启用 SSL**，则会创建一个 SSL 连接；如不勾选，则创建的为普通连接。 - 通过 SSL 连接方式（require ssl）创建的用户勾选 **启用 SSL** 后，即可创建 SSL 连接；如不勾选，则会连接失败。 通过 require ssl 创建的用户可不上传证书但必须勾选 **启用 SSL**，否则连接失败。推荐上传证书以验证通信双方身份（非必须）： - 上传 CA 证书，客户端会校验服务端的身份； - 上传客户端密钥和客户端证书，服务端会校验客户端的身份。 - 通过 x509 加密方式（require x509）创建的用户必须 **启用 SSL** 且上传 CA 证书以及客户端密钥和客户端证书，客户端和服务端会校验对方身份；不勾选 **启用 SSL** 或不上传证书均无法成功创建连接。 | 3. 单击面板右下角的 **确定** 按钮，并在弹框中输入自定义的数据源名称，完成创建数据源。 上一篇 下一篇 ![有帮助](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) 咨询热线