---
title: "创建个人连接 | OceanBase 文档中心"
description: 创建个人连接 背景信息 登录 OceanBase 开发者中心（OceanBase Developer Center，ODC）并进入 ODC 首页，可在 个人连接 页签的右上角单击 新建连接 按钮创建个人连接。 创建完成后，再次进入 ODC 时，可在连接列表中查看已保存的数据库连接。 注意 自 ODC V2.3.0 版…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lqS5SYzz_YEAAAAAAAAAAAAADiGDAQ/original) 开发者中心 ODCV 4.1.0 社区版

# 创建个人连接

更新时间：2026-04-13 14:45:56

[编辑](https://github.com/oceanbase/odc-doc/edit/V4.1.0/zh-CN/600.web-odc-user-guide/300.web-odc-connect-database/100.web-odc-create-private-connection.md)  

## 背景信息

登录 OceanBase 开发者中心（OceanBase Developer Center，ODC）并进入 ODC 首页，可在 **个人连接** 页签的右上角单击 **新建连接** 按钮创建个人连接。

创建完成后，再次进入 ODC 时，可在连接列表中查看已保存的数据库连接。

> **注意**
>
>  - 自 ODC V2.3.0 版本起，导入导出功能需在创建连接的高级配置中设置 root@sys 用户，否则会提示无法使用导入导出功能，因自该版本起，导入导出功能查询视图信息时依赖 root@sys 账号。
>  - 分区信息查看同样依赖 root@sys 账号，因此如需展示表的分区信息须在创建连接的高级配置中设置 root@sys 用户。
>  - 自 ODC V3.3.0 版本起，ODC 支持独立 Session 模式和共享 Session 模式。独立 Session 模式下，每个 SQL 窗口对应一个数据库会话，所有的修改只会影响当前窗口；共享 Session 模式下，所有的 SQL 窗口共享同一个数据库会话，任意 SQL 窗口的修改均会影响到其它 SQL 窗口。
>  - 事务手动提交模式下，需设置 `ob_trx_idle_timeout` 大于等于设置的 SQL 查询超时时间，否则一个事务内两个 SQL 之间的执行间隔超过 `ob_trx_idle_timeout` 设置的时间，连接会终止。同时需注意 `ob_trx_idle_timeout` 设置过大会导致该会话占用内存无法及时释放，需谨慎设置。

## 操作步骤

创建个人连接的操作步骤如下所示：

1. 进入 ODC 后，在左侧导航栏的 **连接** 页签中单击 **个人连接** > **新建个人连接** 按钮。

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/410/private%20connection/1.png)
 2. 在创建连接页签需填写或选择以下信息，如已拥有 OceanBase 数据库连接串，则以下信息均可从连接串中直接获取（mysql -h **主机名** -P **端口号** -u **数据库用户名@租户名** # **集群名** -D **默认数据库** -p ' **数据库密码** '）或直接使用页签中提供的智能解析工具进行填充：

   ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/410/private%20connection/2.png)

   | 信息项 | 说明 |
   | --- | --- |
   | 智能解析 | 在文本框中粘贴连接串信息，ODC 会自动识别连接串并在窗口中填充各项连接信息。 |
   | 连接类型 | 选择 **MySQL** 或 **Oracle** （逻辑库仅支持 MySQL 模式）。 |
   | 连接地址 | - **主机 IP** ：连接的数据库所在服务器的 IP 信息。   - **端口** ：连接的数据库所在服务器的端口号信息。   - **集群名** ：连接的数据库所在集群的名称（逻辑库无需填写）。   - **租户名** ：连接的数据库所在租户的名称（逻辑库无需填写）。  > **说明**   >  主机名和端口号可从连接的数据库所在租户信息页面获取，如在公有云或 OCP 上创建的租户。 |
   | 数据库账号 | - 数据库用户名：在租户中创建的账号（MySQL 模式下，该账户必须具有访问默认数据库的权限）。   - 数据库密码：在租户中创建的账号的密码。单击数据库密码框后的 **测试连接** 按钮，测试是否能够连接到目标数据库。   - 保存密码：关闭该项，连接信息中将不保存数据库密码信息，每次进入连接或测试连接时，需在弹出的密码弹窗中输入数据库密码以进入连接；开启该项，连接信息将保存数据库密码信息，每次进入连接无需输入数据库密码。  > **说明** >   - 如配置信息有误，会出现异常提示，例如用户或密码不对、网络异常等。 >   - 用户只可连接本租户下的数据库，否则会报出测试失败的错误。 >   - ODC V4.0.0 及之后版本支持不填账号密码即可保存连接。 |
   | 默认数据库/schema（可选） | 连接 MySQL 租户中的数据库时，需填写该连接使用的默认数据库（连接 Oracle 租户时无需填写该项）。   > **说明**   >  MySQL 模式下，如不指定默认库，则默认连接 information_schema 库。 如 information_schema 库连接失败，请将默认数据库设置为该用户有权限的库。 |
   | sys 租户账号设置 | 选择是否 **使用 sys 租户账号查询租户视图**，勾选后输入 **账号** 和 **密码**。    数据库类型为物理库时，请输入拥有查询 sys 租户视图权限的账号和密码，当 **连接地址** 中已指定 **租户** 为 sys 时，该项被自动填充。    - **账户** ：拥有 sys 租户视图查看权限的账号。   - **密码** ：账号对应的密码。 输入账户和密码信息后，单击密码框后的 **测试连接** 按钮测试账户信息是否正确。   > **说明** >   - 自 ODC V2.3.0 之后版本，导入导出功能需在创建连接的高级配置中设置 root@sys 用户。 >   - 自 ODC V2.4.1 之后版本，导入导出功能查询视图信息时取消 root@sys 账号强依赖（如未配置 root@sys 账号，ODC 部分对象如存储过程和函数等不支持导出功能；如配置 root@sys 账号，通过访问 sys 租户下的视图信息得到最优的数据路由策略，可提升导出速度）。 >   - **sys 租户账号和密码** 为集群租户下用户的账号和密码 (账号请勿填入“@sys#集群”)。例如：账号为 root。 |
   | 启用 SSL | 选择是否启用 SSL 加密 SSL 链路，以保证客户端和服务器之间数据的安全传输。   > **说明**   >  >   - 通过非加密方式（require none）创建的用户（默认为 require none）可根据需求选择是否开启 SSL。如果勾选 **启用 SSL**，则会创建一个 SSL 连接；如不勾选，则创建的为普通连接。 >   - 通过 SSL 连接方式（require ssl）创建的用户勾选 **启用 SSL** 后，即可创建 SSL 连接；如不勾选，则会连接失败。   >     通过 require ssl 创建的用户可不上传证书但必须勾选 **启用 SSL**，否则连接失败。推荐上传证书以验证通信双方身份（非必须）：  >         - 上传 CA 证书，客户端会校验服务端的身份； >         - 上传客户端密钥和客户端证书，服务端会校验客户端的身份。 >   - 通过 x509 加密方式（require x509）创建的用户必须 **启用 SSL** 且上传 CA 证书以及客户端密钥和客户端证书，客户端和服务端会校验对方身份；不勾选 **启用 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)。 |
 3. 指定上述信息后，单击面板右下角的 **保存** 按钮，在的弹窗中输入连接名后，单击 **确定** 按钮，即可将当前的配置信息持久保存在 ODC 连接列表中。再次登录 ODC 时，可在连接配置列表中直接选择该连接，保存连接配置时不要求测试连接一定成功。

   ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/410/private%20connection/3.png)

   > **说明**
   >
   >  
   >
   > 保存前，可以单击 **测试连接** 进行数据库连接测试，如果数据库用户名和密码正确，则会提示 **连接成功**。
 4. 在页签下方，ODC 同时提供 **复制连接串** 按钮。单击该按钮，ODC 会将当前编辑的连接信息复制为连接串格式以方便获取当前配置的连接信息。
 5. 如无需保存当前的连接配置，可单击页签下方的 **取消** 按钮，ODC 会弹出弹窗以确认是否退出当前新建连接窗口。

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