使用 Web 版 ODC

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

创建用户

示例：管理员在 ODC 中创建用户名 ODCUSER1，并为其授予 system_admin 角色权限。

1. 登录 Web 版 ODC 后，在项目协同窗口的左侧导航栏中，单击 用户权限 > 用户 页签中，单击 新建用户。

   

2. 在弹出的 新建用户 页面中，指定用户和角色信息。

   

   此角色选项为选填项，可以为用户赋予多个角色。单击文本框，弹出的下拉列表中会显示组织中已创建的角色，在列表中选择需为当前创建的所有用户赋予的角色。若无已创建的角色，请先至角色管理创建角色。

3. 单击 新建，提交新建用户信息。

创建数据源

新建 OceanBase 数据源

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

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

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

2. 在项目协同窗口的左侧导航栏中，单击 数据源 > 新建数据源 > OceanBase MySQL。

   ODC 支持的 OceanBase 数据库类型包括：

   • 独立部署/专有云（OceanBase MySQL/OceanBase Oracle）：用户在自己环境中搭建的数据库实例。

   • 公有云（OB Cloud MySQL/OB Cloud Oracle）：阿里云上的数据库实例。

   

3. 在弹出的 新建数据源 面板中填写或选择以下信息。

   说明

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

   

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

   说明

   更多数据源配置请参见 数据源管理。

4. 单击面板右下角的 确定 按钮，并在弹框中输入连接名，完成创建数据源。

   

新建 MySQL 数据源

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

1. 登录 Web 版 ODC 后，在项目协同窗口的左侧导航栏中，单击 数据源 > 新建数据源 > MySQL。

   

2. 在弹出的 新建数据源 面板中填写或选择以下信息。

   说明

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

   

   信息项	说明
   数据源类型	默认显示选择的数据源类型。
   智能解析	在文本框中粘贴连接串信息，ODC 会自动识别连接串并在窗口中填充各项连接信息。
   连接地址	主机 IP：连接的数据库所在服务器的 IP 信息。 端口：连接的数据库所在服务器的端口号信息。
   数据库账号	数据库用户名：MySQL 数据库用户名。 数据库密码：在 MySQL 数据库中创建的账号密码。单击数据库密码框后的 测试连接 按钮，测试是否能够连接到目标数据库。 说明 如配置信息有误，会出现异常提示，例如用户或密码不对、网络异常等。 保存前，可以单击 测试连接 进行数据库连接测试，如果数据库用户名和密码正确，则会显示 连接成功。ODC V4.0.0 及之后版本支持不填账号密码即可保存连接。
   环境	您可根据需求选择环境类型：开发/测试/生产等。
   项目	您可以将创建的数据源绑定到指定项目/不绑定项目。数据源绑定项目后，用户创建的数据库将自动移入项目。
   高级设置	连接初始化脚本：支持通过 SQL 语句配置连接会话。示例：set session ob_query_timeout=60000000 驱动属性：支持配置 驱动属性 连接到 OceanBase 数据库并实现指定功能。

3. 指定上述信息后，单击面板右下角的 确定 按钮。

4. 在弹窗中输入数据源名后，单击 确定 按钮，即可将当前的配置信息持久保存在 ODC 数据源列表中。

   

新建 Oracle 数据源

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

1. 登录 Web 版 ODC 后，在项目协同窗口的左侧导航栏中，单击 数据源 > 新建数据源 > Oracle。

   

2. 在弹出的 新建数据源 面板中填写或选择以下信息。

   

   信息项	说明
   数据源类型	默认显示选择的数据源类型。
   连接地址	主机 IP/域名：连接的数据库所在服务器的 IP 信息。 端口：连接的数据库所在服务器的端口号信息。 数据库：SID（实例名）/服务名（SERVICE_NAME）。
   数据库账号	角色：默认/SYSDBA/SYSOPER。 数据库用户名：Oracle 数据库用户名。 数据库密码：在 Oracle 数据库中创建的账号密码。单击数据库密码框后的 测试连接 按钮，测试是否能够连接到目标数据库。 说明 如配置信息有误，会出现异常提示，例如用户或密码不对、网络异常等。 保存前，可以单击 测试连接 进行数据库连接测试，如果数据库用户名和密码正确，则会显示 连接成功。ODC V4.0.0 及之后版本支持不填账号密码即可保存连接。
   环境	您可根据需求选择环境类型：开发/测试/生产等。
   项目	您可以将创建的数据源绑定到指定项目/不绑定项目。数据源绑定项目后，用户创建的数据库将自动移入项目。
   高级设置	连接初始化脚本：支持通过 SQL 语句配置连接会话。示例：set session ob_query_timeout=60000000 驱动属性：支持配置 驱动属性 连接到 OceanBase 数据库并实现指定功能。

3. 指定上述信息后，单击面板右下角的 确定 按钮。

4. 在弹窗中输入数据源名后，单击 确定 按钮，即可将当前的配置信息持久保存在 ODC 数据源列表中。

   

创建项目

示例：在 ODC 中创建项目 odc_4.3.x。

1. ODC 系统管理员为用户配置创建项目权限。

   

2. 在 项目 > 全部项目 页面中单击 新建项目。

   

3. 在弹出的 新建项目 页签中填写或选择以下信息。

   

   信息项	说明
   项目名称	指定项目名称。
   管理员	拥有项目内的所有权限。
   DBA	拥有项目内除成员管理、消息配置和项目设置外的所有权限。
   开发者（可选）	允许登录所有数据库、执行 SQL、提交工单，通常是开发人员。
   安全管理员（可选）	在参与者的基础上，同时可以管理敏感列。
   参与者（可选）	允许查看项目基本信息，并自助申请库权限和提交工单。
   描述（可选）	非必填项。

4. 单击 确定，完成新建项目。

   说明

   如果用户无创建项目权限，可以通过 项目中的 加入项目 /工单 中的 申请项目权限 加入已创建的项目。具体操作请参见申请项目权限。

项目中添加数据库

示例：在项目 odc_4.3.x 中新建数据库 odc_test。

1. 在 项目 > 全部项目 页面中单击项目名称 odc_4.3.x。

   

2. 在 数据库 页签中单击 添加数据库。

   

3. 在弹出的 添加数据库 弹窗中选择已创建的数据源 mysql410 和数据库 odc_test 后，单击 确定。

   

4. 在 数据库 列表中查看添加的数据库 odc_test。

   单击备注里的编辑框，可以给数据库添加备注，方便在后续使用中进行查看。

   说明

   只有项目管理员与项目 DBA 才可以修改该项目内数据库备注。

   

5. 在 数据库 列表中单击数据库名称 odc_test/SQL 控制台/操作项下的 登录数据库。

   

6. 进入 SQL 开发窗口。

   

   说明

   • 如果用户无数据库权限，可以通过 项目 > 数据库/工单 中的 申请库权限 申请数据库权限。
   • ODC V4.3.2 及之后的版本支持将多个（或单个）物理库配置成一个逻辑库并配置逻辑表，以查询和管理复杂、庞大的分库与分表。

SQL 编辑和执行

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

1. 在项目 odc_4.2.0 中单击 登录数据库，进入 SQL 开发窗口。

   

2. 在 SQL 窗口中，编辑 SQL 语句以创建表 employee。

   

   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 窗口中的 支持切换数据库。

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

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

   

4. 在结果页签中，可查看执行记录和执行日志。

   

   说明

   如果用户无表权限，可以通过 工单 中的 申请表权限 查询/导出/变更表。
   

新建数据库变更

示例：将数据库 odc_test 中表 employee 的 name 值 xiaoguo 修改为 xiaofeng。

1. 在 项目 > 全部项目 页面中单击项目名称 odc_4.2.0。

   

2. 在 工单 页签中单击 数据库变更 > 新建数据库变更。

   

3. 在 新建数据库变更 页面中，输入以下信息。

   

4. 单击 新建，完成新建数据库变更。

5. 任务生成后可以在 工单 > 数据库变更 列表中查看任务审批结果和任务信息。

   

相关文档

• 用户权限管理

• 数据源管理

• 项目协同管理

• SQL 开发