全部产品

创建连接

登录 OceanBase 开发者中心(OceanBase Developer Center,ODC)进入 ODC 首页后,您可以在 连接管理 页签的右上角单击 新建连接 按钮进行连接配置操作,之后当您再次进入 ODC 时,您可以在连接列表中查看已保存的数据库连接。

Image 203

注意

  • ODC V2.3.0 版本后,导入导出功能需要在创建连接的高级配置中设置 root@sys 用户,否则会提示无法使用导入导出功能,因为是从该版本开始,导入导出功能查询视图信息时依赖 root@sys 账号。

  • 分区信息查看也依赖 root@sys 账号,所以您也需要在创建连接的高级配置中设置 root@sys 用户。

  • Oracle 连接为共享 Session 设计,当您主动触发提交或回滚操作,或通过产品功能创建、修改、删除数据库对象和执行 DDL 语句被动触发提交操作时,事务的提交或回滚会在所有窗口生效。第一次进入 Oracle 连接时,您将看到相关提示。

  • 事务手动提交模式下,需要设置 ob_trx_idle_timeout 大于等于设置的 SQL 查询超时时间,否则一个事务内两个 SQL 之间的执行间隔超过 ob_trx_idle_timeout 设置的时间,连接会终止。同时需要注意 ob_trx_idle_timeout 设置过大会导致该会话占用内存无法及时释放,需谨慎设置。

操作步骤:

  1. 进入 ODC 后,单击页面中的 创建连接 按钮。

  2. 在创建连接页签需要填写或选择以下信息,如果您拥有 OceanBase 数据库连接串,那么以下信息均可从连接串中直接获得(mysql -h 主机名 -P 端口号 -u 数据库用户名@租户名#集群名 -D 默认数据库 -p '数据库密码')或直接使用页签中提供的智能解析工具进行填充:

    信息项

    说明

    所属区域

    选择连接示例所在的区域 公有云(阿里云上的数据库实例) 或 独立部署/专有云(在自己环境中搭建的数据库实例)。

    连接模式

    选择 MySQLOracle

    连接名称

    指定该连接的名称。

    设置标签

    单击 连接名称 文本框后的 设置标签 按钮为当前连接指定标签,在弹出的下拉列表中可进行设置标签和管理标签的操作:

    • 设置标签:在下拉列表中选择目标标签完成设置。若列表为空请先新建标签。

    • 管理标签:单击列表最下方的 新建标签 按钮或者单击列表上方的设置图标以弹出 标签管理 窗口。在标签管理窗口可对创建好的标签进行编辑和删除操作。也可单击上方的 新建标签 按钮指定新标签的名称和图标颜色。

    连接地址

    • 主机名:在租户信息页面中获得主机名信息。

    • 端口号:在租户信息页面中获得端口号信息。

    • 集群:要连接的数据库所在集群的名称。

    • 租户:要连接的数据库所在租户的名称。

    默认数据库

    连接 MySQL 租户中的数据库时,需填写该连接要使用的默认数据库,连接 Oracle 租户中的数据库时则无需填写该项。

    数据库用户名

    在租户中创建的账号(MySQL 模式下该账户必须有访问默认数据库的权限)。

    数据库密码

    在租户中创建的账号的密码。

    单击数据库密码框后的 测试连接 按钮,测试是否能够连接到目标数据库。如果配置信息有误,会有异常提示,例如用户或密码不对、网络异常等。用户只能够连接本租户下的数据库,否则会报出测试失败的错误。

    智能解析

    在文本框中粘贴连接串信息,ODC 会自动识别连接串并在窗口中填充各项连接信息。

    SQL 查询超时时间

    单击页面下方 高级配置 标签弹出该项。支持自定义 SQL 超时时间,默认 60 s,超过指定的时间时查询自动终止。

    查询 sys 租户视图

    单击页面下方 高级配置 标签弹出该项,当 连接地址 中已指定 租户 为 sys 时,该项被自动填充。

    • 账户:拥有 sys 租户视图查看权限的账号。

    • 密码:账号对应的密码。

    输入账户和密码信息后,单击密码框后的 测试连接 按钮测试账户信息是否正确。ODC V2.3.0 后使用数据导入导出和查看分区信息功能时需要在此项配置 root@sys 账号。

    功能

    选择对应连接中支持使用的功能,默认为全勾选。取消勾选后,进入连接对应功能将不可用。

    当前版本中只支持选择 模拟数据 功能是否可用。

  3. 单击页面下方的 保存 按钮,即可将当前的配置信息持久保存在 ODC 连接列表中。再次登录 ODC 时您可以在连接配置列表中直接选择该连接,保存连接配置时不要求测试连接一定成功。

  4. 在页签下方,ODC 还提供了 复制连接串 按钮。单击该按钮,ODC 会将您当前编辑的连接信息复制为连接串格式以方便您获得当前配置的连接信息。

  5. 当您不需要保存当前的连接配置时,可单击页签下方的 取消 按钮,ODC 会弹出弹窗跟您确认是否退出当前新建连接窗口。