--- title: "使用 Web 版 ODC - 开发者中心 ODC V4.2.3 | OceanBase 文档中心" description: 使用 Web 版 ODC 本文介绍使用 Web 版 ODC 的一些基础操作。 创建用户 示例：管理员在 ODC 中创建用户名 ODCUSER1，并为其授予 system_admin 角色权限。 登录 Web 版 ODC 后，在项目协同窗口的左侧导航栏中，单击 用户权限 > 用户 页签中，单击 新建用户 。 在弹出的 … --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lqS5SYzz_YEAAAAAAAAAAAAADiGDAQ/original) 开发者中心 ODCV 4.2.3 # 使用 Web 版 ODC 更新时间：2026-04-13 15:31:14 [编辑](https://github.com/oceanbase/odc-doc/edit/V4.2.3/zh-CN/300.quickstart/200.web-odc-quickstart/300.quickstart-using-web-odc.md) 本文介绍使用 Web 版 ODC 的一些基础操作。 ## 创建用户 示例：管理员在 ODC 中创建用户名 ODCUSER1，并为其授予 system_admin 角色权限。 1. 登录 Web 版 ODC 后，在项目协同窗口的左侧导航栏中，单击 **用户权限** > **用户** 页签中，单击 **新建用户**。 ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/using%20odc/1.png) 2. 在弹出的 **新建用户** 页面中，指定用户和角色信息。 ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/user/2.png) 此选项为选填项，可以为用户赋予多个角色。单击文本框，弹出的下拉列表中会显示组织中已创建的角色，在列表中选择需为当前创建的所有用户赋予的角色。若无已创建的角色，请先至角色管理创建角色。 3. 单击 **新建**，提交新建用户信息。 ## 创建数据源 ### 创建 OceanBase 数据源 示例：在 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. 在项目协同窗口的左侧导航栏中，单击 **数据源** > **新建数据源** > **OceanBase MySQL**。 ODC 支持的数据库类型包括： - 独立部署/专有云（OceanBase MySQL/OceanBase Oracle）：用户在自己环境中搭建的数据库实例。 - 公有云（OceanBase MySQL Cloud/OceanBase Oracle Cloud）：阿里云上的数据库实例。 - MySQL：MySQL 上的数据库实例。 ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/422/300.quickstart/200.web-odc-quickstart/300.quickstart-using-web-odc/create%20connection%201.png) 3. 在弹出的 **新建数据源** 面板中填写或选择以下信息。 #### 说明 如已拥有 MySQL 数据库连接串，则以下信息均可从连接串中直接获取或直接使用页签中提供的智能解析工具进行填充。 ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/422/300.quickstart/200.web-odc-quickstart/300.quickstart-using-web-odc/create%20connection%202.png) | 信息项 | 说明 | | --- | --- | | 数据源类型 | 默认显示选择的数据源类型。 | | 智能解析 | 在文本框中粘贴连接串信息，ODC 会自动识别连接串并在窗口中填充各项连接信息。 | | 连接地址 | - **主机 IP/域名**：连接的数据库所在服务器的 IP 信息。 - **端口** ：连接的数据库所在服务器的端口号信息。 - **集群名** ：连接的数据库所在集群的名称（逻辑库无需填写）。 - **租户名** ：连接的数据库所在租户的名称（逻辑库无需填写）。 #### 说明 如果在公有云或 OCP 上创建的租户，主机名和端口号可从连接的数据库所在租户信息页面获取。**默认端口号：8989。** | | 数据库账号 | - 数据库用户名：在租户中创建的账号（MySQL 模式下，该账户必须具有访问默认数据库的权限）。 - 数据库密码：在租户中创建的账号的密码。单击数据库密码框后的 **测试连接** 按钮，测试是否能够连接到目标数据库。 #### 说明 - 如配置信息有误，会出现异常提示，例如用户或密码不对、网络异常等。 - 用户只可连接本租户下的数据库，否则会报出测试失败的错误。 - 保存前，可以单击 **测试连接** 进行数据库连接测试，如果数据库用户名和密码正确，则会显示 **连接成功**。ODC V4.0.0 及之后版本支持不填账号密码即可保存连接。 | | 环境 | 用户根据需求选择环境类型：开发/测试/生产。 | #### 说明 更多数据源配置请参见 [数据源管理](https://www.oceanbase.com/docs/common-odc-1000000000468308)。 4. 单击面板右下角的 **确定** 按钮，并在弹框中输入连接名，完成创建数据源。 ![3.0](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/clientodc/using/3.png) ### 创建 MySQL 数据源 #### 说明 ODC V4.2.2 及之后的版本支持创建 MySQL 类型的数据源，以通过 ODC 即可管理 MySQL 数据库中的数据。MySQL 数据源功能限制请参见 [使用限制](https://www.oceanbase.com/docs/common-odc-1000000000468262)。 示例：在 ODC 中创建 MySQL 类型的数据源。 | 信息项 | 示例值 | | --- | --- | | 数据源名称 | mysql4.2.2 | | 主机 IP | xxx.x.x.x | | 端口 | 8080 | | 数据库用户名 | odc | | 数据库密码 | ****** | 1. 登录 Web 版 ODC 后，在项目协同窗口的左侧导航栏中，单击 **数据源** > **新建数据源** > **MySQL**。 ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/422/300.quickstart/200.web-odc-quickstart/300.quickstart-using-web-odc/create%20connection%201.png) 2. 在弹出的 **新建数据源** 面板中填写或选择以下信息。 #### 说明 如已拥有 OceanBase 数据库连接串，则以下信息均可从连接串中直接获取或直接使用页签中提供的智能解析工具进行填充。 ![5mysql](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/422/400.connection-management/100.create-a-personal-connection/5mysql.png) | 信息项 | 说明 | | --- | --- | | 数据源类型 | 默认显示选择的数据源类型。 | | 智能解析 | 在文本框中粘贴连接串信息，ODC 会自动识别连接串并在窗口中填充各项连接信息。 | | 连接地址 | - **主机 IP** ：连接的数据库所在服务器的 IP 信息。 - **端口** ：连接的数据库所在服务器的端口号信息。 | | 数据库账号 | - 数据库用户名：MySQL 数据库用户名。 - 数据库密码：在 MySQL 数据库中创建的账号密码。单击数据库密码框后的 **测试连接** 按钮，测试是否能够连接到目标数据库。 #### 说明 - 如配置信息有误，会出现异常提示，例如用户或密码不对、网络异常等。 - 保存前，可以单击 **测试连接** 进行数据库连接测试，如果数据库用户名和密码正确，则会显示 **连接成功**。ODC V4.0.0 及之后版本支持不填账号密码即可保存连接。 | | 环境 | 您可根据需求选择环境类型：开发/测试/生产。 | 3. 指定上述信息后，单击面板右下角的 **确定** 按钮。 4. 在弹窗中输入数据源名后，单击 **确定** 按钮，即可将当前的配置信息持久保存在 ODC 数据源列表中。 ![6mysql](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/422/400.connection-management/100.create-a-personal-connection/6mysql.png) ## 创建项目 1. ODC 系统管理员为用户配置创建项目权限。 ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/project/2.0.png) 2. 在 **项目** > **全部项目** 页面中单击 **新建项目**。 ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/project/3.0.png) 3. 在弹出的 **新建项目** 页签中填写或选择以下信息。 ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/423/300.quickstart/200.web-odc-quickstart/300.quickstart-using-web-odc/4.png) | 信息项 | 说明 | | --- | --- | | 项目名称 | 创建的项目名称。 | | 管理员 | 支持管理项目所有数据库和成员。 | | DBA | 支持管理项目所有数据库。 | | 普通成员（可选） | 支持访问项目所有数据库。 | | 安全管理员（可选） | 只允许管理项目的敏感列和参与审批。 | | 参与者（可选） | 只允许参与审批。 | | 描述（可选） | 非必填项。 | 4. 单击 **确定**，完成新建项目。 ## 项目中添加数据库 示例：在项目 odc_4.2.0 中新建数据库 odc_test。 | 信息项 | 示例值 | | --- | --- | | 项目名称 | odc_4.2.0 | | 所属数据源 | mysql410 | | 数据库名称 | odc_test | 1. 在 **项目** > **全部项目** 页面中单击项目名称 **odc_4.2.0**。 ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/add%20database/1.png) 2. 在 **数据库** 页签中单击 **添加数据库**。 ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/add%20database/2.png) 3. 在弹出的 **添加数据库** 弹窗中选择已创建的数据源 **mysql410** 和数据库 **odc_test** 后，单击 **确定**。 ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/add%20database/3.png) 4. 在 **数据库** 列表中查看添加的数据库 **odc_test**。 ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/add%20database/4.png) 5. 在 **数据库** 列表中单击数据库名称 **odc_test**/**登录数据库**/操作项下的 **登录数据库**。 ![5](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/add%20database/5.png) 6. 进入 SQL 开发窗口。 ![6](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/add%20database/6.png) ## SQL 编辑和执行 示例：在 SQL 窗口中，创建表到目标项目的数据库中。 | 信息项 | 示例值 | | --- | --- | | 项目名称 | odc_4.2.0 | | 所属数据源 | mysql410 | | 数据库名称 | odc_test | | 表名称 | employee | 1. 在项目 **odc_4.2.0** 中单击 **登录数据库**，进入 SQL 开发窗口。 ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/add%20database/5.png) 2. 在 SQL 窗口中，编辑 SQL 语句以创建表 `employee`。 ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/sql%20editing/4.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; ``` 如上图所示，单击 SQL 窗口中的 ![select a database](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/422/300.quickstart/200.web-odc-quickstart/300.quickstart-using-web-odc/sql%20editing%203.png) 支持切换数据库。 3. SQL 语句编辑完成后，在 SQL 窗口的工具栏中中单击 **运行 F8** 运行当前 SQL 窗口中所有的 SQL 语句。 | 功能 | 说明 | | --- | --- | | 运行 F8 | 运行当前 SQL 窗口中所有的 SQL 语句。 | | 运行当前语句 F9 | 运行当前选中的所有 SQL 语句或当前光标所在行的 SQL 语句。 | | 终止 | 终止正在运行的语句。 | ![6](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/sql%20editing/5.png) 4. 在结果页签中，可查看执行记录和执行日志。 ![7](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/sql%20editing/6.png) ## 新建数据库变更 示例：将数据库 odc_test 中表 employee 的 name 值 xiaoguo 修改为 xiaofeng。 ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/add%20database/1.png) 2. 在 **工单** 页签中单击 **数据库变更** > **新建数据库变更**。 ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/create%20database%20change/2.png) 3. 在 **新建数据库变更** 页面中，输入以下信息。 ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/create%20database%20change/3.png) 4. 单击 **新建**，完成新建数据库变更。 5. 任务生成后可以在 **工单** > **数据库变更** 列表中查看任务审批结果和任务信息。 ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/420/quickstart/webodc/create%20database%20change/4.png) ## 相关文档 - [用户权限管理](https://www.oceanbase.com/docs/common-odc-1000000000468346) - [数据源管理](https://www.oceanbase.com/docs/common-odc-1000000000468308) - [项目协同管理](https://www.oceanbase.com/docs/common-odc-1000000000468293) - [SQL 开发](https://www.oceanbase.com/docs/common-odc-1000000000468276) 上一篇 下一篇 ![有帮助](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) 咨询热线