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