首批通过分布式安全可靠测评,为关键业务系统打造
匿名块窗口
更新时间:2023-02-28 18:03:26
概述
进入 OceanBase 开发者中心(OceanBase Developer Center,ODC)的数据库管理页面后,单击顶部导航栏中的 工作台 标签,在弹出下拉菜单中选择 匿名块窗口 以新建窗口。
匿名块窗口中提供 PL 编辑区域、PL 运行结果和 DBMS 输出 页签以及 调试页面。

PL 编辑区域
在匿名块窗口的编辑区域,可体验到较多的细节功能,如当新建一个匿名块窗口时:
会自动生成引导代码方便编写脚本;
窗口中会对数据库的关键字进行不同颜色的标识;
支持格式化等功能以提升编辑 PL 语句的效率。
除编辑 PL 语句时可体验到上述细节功能外,编辑区域的工具栏中同时提供以下功能键:
功能 说明 运行 单击该按钮运行代码区中的语句。 终止 单击该按钮终止正在运行的语句。 调试 单击该按钮进入调试页面,并对代码区内的匿名块对象进行调试。 格式化 单击该按钮对选中的 SQL 语句或当前 SQL 窗口中的所有 SQL 语句进行统一的格式化(缩进、换行和高亮关键字等操作)。 查找/替换 在查找框内输入内容以对脚本进行检索,查找后可在替换框内输入内容以对查找内容进行替换。 撤销 将脚本回退到上一步操作执行的结果。 重做 执行 撤销 操作后,对脚本重新执行撤销前的操作。 大小写 提供 全部大写 、 全部小写 和 首字母大写 三种效果,将您在脚本中选中的语句转换为对应形式。 缩进 提供 添加缩进 和 删除缩进 两种效果,为您在脚本中选中的语句添加或删除包含的缩进。 注释 提供 添加注释 和 删除注释 两种效果,将您在脚本中选中的语句转换为注释或转换为 SQL 语句。 保存 单击该按钮保存当前窗口中的脚本。 保存后,再次进入工作台可直接打开已保存的脚本。
说明
- 每个用户只能查看自己保存的 SQL 脚本,且脚本名不允许重复。
- 打开已保存的脚本后,可继续对该脚本进行编辑。
PL 运行结果和 DBMS 输出页签
在匿名块编辑区域的工具栏单击运行图标
后,会运行编辑区域中的匿名块脚本,可在编辑区域下方查看 运行结果 和 DBMS 输出 页签:
运行结果 :展示脚本运行的结果,如运行无误则显示 运行成功 ,如运行有误则展示错误提示信息。
DBMS 输出 :如子程序中包含 PL 输出语句则展示其调用后的输出结果(例如
dbms_output.put_line)。
调试页面
在匿名块的编辑区域,单击 调试 按钮后可进入调试页面。
进入调试页面后可对当前窗口中的匿名块进行调试。 注意
推荐升级至 OBServer V2.2.77 及之后版本(因 OBServer 部分版本存在 PL 调试类已知问题,可能导致 OBServer 不稳定)。
ODC V3.2.2 之前版本,通过 OBProxy 连接至目标实例时无法使用调试功能,请在 ODC 中直连到目标实例。
自 ODC V3.2.2 及之后版本,ODC 支持通过 OBProxy 连接 OBServer 情况下进行 PL 调试。
在调试前请确保连接的数据库中已安装 DBMS_DEBUG 和 DBMS_OUTPUT 等调试包。

在调试模式下,编辑区的工具栏中提供以下功能键:
| 功能 | 说明 |
|---|---|
| 批量执行 | 批量运行至最近断点,如果无断点直接运行至结尾语句。 |
| 单步执行 | 单步执行,不会进入子程序。 |
| 跳入 | 单步执行,如当前行是调用已定义的存储过程或函数,则会进入被调用的子程序。 |
| 跳出 | 在子程序内,执行跳出操作后,返回到上层调用位置的下一行;主程序内运行跳出,效果与 自动调试 相同。 |
| 终止调试 | 继续运行直到结束,会跳过设置的断点。 |
| 重新调试 | 对当前调试对象发起新一轮的调试,与 调试 的区别在于:无需新建调试连接。 |
| 退出调试 | 关闭调试连接,并退出调试交互窗口。 |
在调试模式下,除编辑区外,同时提供以下页签:
参数 :参数页签展示该调试对象所有的参数定义信息(参数名、模式和类型)及对应的值,其中对应的值会根据调试过程作出相应的变化。
堆栈和变量 :展示当前栈上的变量与其对应的值。
DBMS 输出 :如子程序中包含 PL 输出语句则展示其调用后的输出结果(例如
dbms_output.put_line)。断点 :在编辑区单击行号设置断点(再次单击取消断点)。在断点页签可查看设置的所有断点,列表默认按照断点执行顺序进行排序,在列表中选中多个断点后可批量取消。每一行断点信息的操作栏中同时提供 取消 (取消该断点)和 查看 (在编辑区光标会跳转至该断点所处的位置)两个操作。
调试日志 :展示调试开始、调试结束、断点添加、断点取消等信息和错误日志。