首批通过分布式安全可靠测评,为关键业务系统打造
通过桌面版 ODC 连接 OB Cloud 云数据库
更新时间:2026-06-24 09:08:46
ODC 桌面版支持连接 OB Cloud 的 MySQL 兼容模式租户。本文主要介绍该连接方式的前提条件和连接操作。
前提条件
已安装 OceanBase 开发者中心(ODC)桌面版。详细操作,请参见 安装桌面版 ODC。
已在 OB Cloud 实例下获取目标 MySQL 兼容模式租户的连接串。详细操作,请参见 获取连接串。
操作步骤
打开 ODC 桌面版,在 数据源 界面左侧顶部的搜索框旁,单击 + > OB Cloud MySQL。

在弹出的 新建数据源 面板中,根据 前提条件 中获取的连接串,填写或选择以下信息。
信息项 说明 智能解析(可选) 您可以选择在智能解析文本框中粘贴连接串信息,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 传输加密 和 公有云 OceanBase SSL 链路加密。 - 连接初始化脚本:支持通过 SQL 语句配置连接会话。示例:
set session ob_query_timeout=60000000 - 驱动属性:支持配置 驱动属性 连接到 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 或不上传证书均无法成功创建连接。
单击面板右下角的 确定 按钮,并在弹框中输入自定义的数据源名称,完成创建数据源。