---
title: "使用桌面版 ODC - 开发者中心 ODC V4.4.2 | OceanBase 文档中心"
description: 使用桌面版 ODC 本文介绍使用桌面版 ODC 的一些基础操作。 创建数据源 示例：在 ODC 中创建 OceanBase MySQL 类型的数据源。 信息项 示例值 数据源名称 mysql4.2.0 主机 IP xxx.x.x.x 端口 8080 数据库用户名 odc 数据库密码 ****** sys 租户账号 t…
---
切换语言

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

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

# 使用桌面版 ODC

更新时间：2026-05-09 19:13:29

[编辑](https://github.com/oceanbase/odc-doc/edit/V4.4.2/zh-CN/300.quickstart/100.client-odc-quickstart/300.quickstart-using-client-odc.md)  

本文介绍使用桌面版 ODC 的一些基础操作。

## 创建数据源

示例：在 ODC 中创建 OceanBase MySQL 类型的数据源。

| 信息项 | 示例值 |
| --- | --- |
| 数据源名称 | mysql4.2.0 |
| 主机 IP | xxx.x.x.x |
| 端口 | 8080 |
| 数据库用户名 | odc |
| 数据库密码 | ****** |
| sys 租户账号 | test |
| sys 租户密码 | ****** |

1. 获取数据源实例的连接信息或连接串。连接串（mysql -h 主机名 -P 端口号 -u 数据库用户名@租户名 # 集群名 -D 默认数据库 -p ' 数据库密码 '）。
 2. 在左侧导航栏中，单击 **数据源** 右侧的 **+** > **新建数据源**。

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/433/300.quickstart/100.client-odc-quickstart/300.quickstart-using-client-odc.md/1.png)
 3. 在弹出的 **新建数据源** 面板中填写或选择以下信息。

   #### 说明

   如已拥有 OceanBase 数据库连接串，则以下信息均可从连接串中直接获取或直接使用页签中提供的智能解析工具进行填充。

   ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/422/300.quickstart/100.client-odc-quickstart/300.quickstart-using-client-odc/2.png)

   | 信息项 | 说明 |
   | --- | --- |
   | 数据源类型 | 默认选择 **OceanBase**。 |
   | 智能解析 | 在文本框中粘贴连接串信息，ODC 会自动识别连接串并在窗口中填充各项连接信息。 |
   | 连接地址 | - **主机 IP**：连接的数据库所在服务器的 IP 信息。   - **端口**：连接的数据库所在服务器的端口号信息。   - **集群名**：连接的数据库所在集群的名称（逻辑库无需填写）。   - **租户名**：连接的数据库所在租户的名称（逻辑库无需填写）。  #### 说明    如果在公有云或 OCP 上创建的租户，主机名和端口号可从连接的数据库所在租户信息页面获取。**默认端口号：8989。** |
   | 数据库账号 | - 数据库用户名：在租户中创建的账号（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** 或不上传证书均无法成功创建连接。 |

   #### 说明

   更多数据源配置请参见 [数据源管理](https://www.oceanbase.com/docs/common-odc-1000000005551389)。
 4. 单击面板右下角的 **确定** 按钮，并在弹框中输入连接名，完成创建数据源。

   ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/422/300.quickstart/100.client-odc-quickstart/300.quickstart-using-client-odc/3.png)

## SQL 编辑和执行

示例：在 SQL 窗口中，创建表到目标数据库中。

| 信息项 | 示例值 |
| --- | --- |
| 所属数据源 | mysql4.2.0 |
| 数据库名称 | odc_test |
| 表名称 | employee |

1. 在 SQL 窗口中，单击 **请选择数据库** 选择项目数据库。

   ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/clientodc/using/4.png)
 2. 在 **切换数据库** 弹窗中，选择所属项目的数据库。

   ![5](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/422/300.quickstart/100.client-odc-quickstart/300.quickstart-using-client-odc/5.png)
 3. 在 SQL 窗口中，编辑 SQL 语句以创建表 `employee`。

   ![6](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/clientodc/using/6.png)

   ```sql
   CREATE TABLE odc_test.employee (
   emp_no int(120) COMMENT '员工工号' NOT NULL,
   birthday date COMMENT '员工生日' NULL,
   name varchar(120) COMMENT '员工姓名' NULL,
   CONSTRAINT cons_employee_empno PRIMARY KEY (emp_no)) DEFAULT CHARSET = utf8mb4 COLLATE = utf8mb4_general_ci;

   ```
 4. SQL 语句编辑完成后，在 SQL 窗口的工具栏中中单击 **运行 F8** 运行当前 SQL 窗口中所有的 SQL 语句。

   | 功能 | 说明 |
   | --- | --- |
   | 运行 F8 | 运行当前 SQL 窗口中所有的 SQL 语句。 |
   | 运行当前语句 F9 | 运行当前选中的所有 SQL 语句或当前光标所在行的 SQL 语句。 |
   | 终止 | 终止正在运行的语句。 |

   ![7](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/clientodc/using/7.png)
 5. 在结果页签中，可查看执行记录和执行日志。

   ![8](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/clientodc/using/8.png)

## 相关文档

- [用户权限管理](https://www.oceanbase.com/docs/common-odc-1000000005551479)
 - [数据源管理](https://www.oceanbase.com/docs/common-odc-1000000005551389)
 - [项目协同管理](https://www.oceanbase.com/docs/common-odc-1000000005551481)
 - [SQL 开发](https://www.oceanbase.com/docs/common-odc-1000000005551375)

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