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

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

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

# 使用桌面版 ODC

更新时间：2026-04-13 14:20:55

[编辑](https://github.com/oceanbase/odc-doc/edit/V4.2.0/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_cluster |
| 租户名 | mysql_tenant |
| 数据库用户名 | odc |
| 数据库密码 | ****** |
| sys 租户账号 | test |
| sys 租户密码 | ****** |

1. 获取数据源实例的连接信息或连接串。连接串（mysql -h 主机名 -P 端口号 -u 数据库用户名@租户名 # 集群名 -D 默认数据库 -p ' 数据库密码 '）。连接串示例：

```shell
-hxxx.x.x.x -P8080 -uodc@mysql_tenant#odc_cluster -Dodc -p'******'

```

2. 在左侧导航栏中，单击 **数据源** 右侧的 **+** > **新建数据源**。

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

   #### 说明

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

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

   | 信息项 | 说明 |
   | --- | --- |
   | 数据源类型 | 默认选择 **OceanBase**。 |
   | 智能解析 | 在文本框中粘贴连接串信息，ODC 会自动识别连接串并在窗口中填充各项连接信息。 |
   | 类型 | 选择连接的数据库类型。ODC 支持的数据库类型包括：    - 独立部署/专有云（OceanBase MySQL/OceanBase Oracle）：用户在自己环境中搭建的数据库实例。   - 公有云（OceanBase MySQL Cloud/OceanBase Oracle Cloud）：阿里云上的数据库实例。   - 逻辑库（OceanBase MySQL Sharding）：逻辑库仅支持 MySQL 模式。 |
   | 连接地址 | - **主机 IP** ：连接的数据库所在服务器的 IP 信息。   - **端口** ：连接的数据库所在服务器的端口号信息。   - **集群名** ：连接的数据库所在集群的名称（逻辑库无需填写）。   - **租户名** ：连接的数据库所在租户的名称（逻辑库无需填写）。  > **说明**   >  主机名和端口号可从连接的数据库所在租户信息页面获取，如在公有云或 OCP 上创建的租户。 |
   | 数据库账号 | - 数据库用户名：在租户中创建的账号（MySQL 模式下，该账户必须具有访问默认数据库的权限）。   - 数据库密码：在租户中创建的账号的密码。单击数据库密码框后的 **测试连接** 按钮，测试是否能够连接到目标数据库。  > **说明** >   - 如配置信息有误，会出现异常提示，例如用户或密码不对、网络异常等。 >   - 用户只可连接本租户下的数据库，否则会报出测试失败的错误。 >   - 保存前，可以单击 **测试连接** 进行数据库连接测试，如果数据库用户名和密码正确，则会显示 [连接成功]()。ODC V4.0.0 及之后版本支持不填账号密码即可保存连接。 |
   | 环境 | 用户根据需求选择环境类型：开发/测试/生产。 |

   #### 说明

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

   ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/clientodc/using/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/420/quickstart/clientodc/using/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-1000000000091059)
 - [数据源管理](https://www.oceanbase.com/docs/common-odc-1000000000091012)
 - [项目协同管理](https://www.oceanbase.com/docs/common-odc-1000000000090997)
 - [SQL 开发](https://www.oceanbase.com/docs/common-odc-1000000000090982)

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