云数据库OceanBase入门教程 OceanBase 匿名块窗口

2024-02-26 开发教程 云数据库OceanBase入门教程 匿名 0

进入 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)。
  • 断点:在编辑区单击行号设置断点(再次单击取消断点)。在断点页签可以查看到您设置的所有断点,列表默认按照断点执行顺序进行排序,在列表中选中多个断点后可批量取消。每一行断点信息的操作栏中也提供了 取消(取消该断点)和 查看(在编辑区光标会跳转至该断点所处的位置)两个操作。
  • 调试日志:展示调试开始、调试结束、断点添加、断点取消等信息和错误日志。