14.2.5　在SQL*Plus中为语句添加注释

注释是每一个数据库管理员经常使用的工具，如果在语句中没有注释，那么其他人就无法读懂你写的语句，甚至自己写的语句过了很长时间之后自己也不知道当初为什么这么写。在SQLPlus中写语句也是一样的，前面已经学习过把执行的语句保存起来，但是如果语句都没有说明，以后也很难再使用。SQLPlus也为数据库使用者提供了在语句中加入注释的方法。常用的方法有以下几种。

1.使用/……/方法

这种在语句中加入注释的方法在很多编程语言中都是经常使用的，在/和/之间的内容就是语句的注释内容。注释可以写在语句中的任何位置，在编译语句时是不会编译注释的。下面就以“/……/”这种注释方式为脚本文件test.sql添加注释，如图14.39所示。

图　14.39　添加注释

在执行添加注释后的脚本时执行效果是不会改变的，请读者自己尝试一下。

2.使用REMARK命令

使用REMARK命令进行注释。REMARK命令的作用就是告诉SQL*Plus接下来的文字不是命令而是注释。具体命令如下：

REMARK comment

这里，comment就是要添加的注释信息。

【示例21】添加注释

下面就利用REMARK命令在SQL*Plus中添加注释。仍然是写一个查询dba_users表中信息的语句，然后在语句前面加上“查询用户信息”的注释。具体操作如图14.40所示。

图　14.40　使用REMARK命令添加注释

在此，“查询用户信息”的注释就被加入到REMARKTEST.SQL文件。查看REMARKTEST.SQL文件的内容，如图14.41所示。

图　14.41　REMARKTEST.SQL文件内容

注意　如果要想把加注释的语句写入到文件中，一定要在SPOOL命令之后输入注释，因为在调用SPOOL之后，后面的语句才是向文件中写入的语句。但是在语句最后还要加上SPOOL OFF才算真正把语句写入文件中。