MariaDB必知必会
上QQ阅读APP看书,第一时间看更新

4.8 注释

正如你所看到的,SQL语句是通过MariaDB处理的指令但是如果你需要包含一些不想处理或执行的文本该怎么做呢?为什么需要这样做?有以下原因:

·到目前为止,我们使用的SQL语句既短小又简单。但是,随着SQL语句的增长(长度和复杂度),你将会想要包含一些描述性的注释(以便将来参考或者接下来接手这个项目的人理解SQL语句)。注释需要嵌入到SQL脚本中,但显然它们不是用来让MariaDB处理的。(有一个例子,参考附录B中的create.sql和populate.sql文件。)

·同样的原因也适用于顶层的SQL文件,或许包含程序员交流信息、描述、和注意事项。(同样参考附录B的.sql文件)

·注释的另一个重要用途是临时阻止SQL代码执行。如果你正在使用一条很长的SQL语句,并且想要测试其中的一部分,注释掉其中的一部分代码以便MariaDB把它当作注释并且忽略掉。

MariaDB支持多种形式的注释语法。我们将以行内注释开始:

▼ 输入

▼ 分析

使用“--”(两个连字符)可以内嵌注释。“--”后面的任何内容都是注释文本,使之成为注释CREATE TABLE语句各列的良好选择。例如:

这里有行内注释的另一种形式:

▼ 输入

▼ 分析

以“#”开头让整行都成为注释。可以在create.sql和populate.sql脚本中看到这种格式的注释。

也可以创建多行注释,以及在脚本中任何地方开始和结束的注释:

▼ 输入

▼ 分析

“/*”开始一个注释,“*/”结束这个注释。在“/*”和“*/”之间的任何内容都是注释文本。这种类型的注释通常用来注释掉代码,就如上面这个例子。这里定义了两条SELECT语句,但是由于第一个被注释掉了,所以不会执行。