使用注释

注释是程序代码中不执行的文本字符串（也称为注解）。注释可用于说明代码或暂时禁用正在进行诊断的部分 Transact-SQL 语句和批处理。使用注释对代码进行说明，可使程序代码更易于维护。注释通常用于记录程序名称、作者姓名和主要代码更改的日期。注释可用于描述复杂计算或解释编程方法。

Microsoft® SQL Server™ 支持两种类型的注释字符：

• --（双连字符）。这些注释字符可与要执行的代码处在同一行，也可另起一行。从双连字符开始到行尾均为注释。对于多行注释，必须在每个注释行的开始使用双连字符。有关使用注释字符的更多信息，请参见 --（注释）。
  
  
• /* ... */（正斜杠-星号对）。这些注释字符可与要执行的代码处在同一行，也可另起一行，甚至在可执行代码内。从开始注释对 (/*) 到结束注释对 (*/) 之间的全部内容均视为注释部分。对于多行注释，必须使用开始注释字符对 (/*) 开始注释，使用结束注释字符对 (*/) 结束注释。注释行上不应出现其它注释字符。有关使用 /* ...*/ 注释字符的更多信息，请参见 /* ...*/（注释）。

多行 /* */ 注释不能跨越批处理。整个注释必须包含在一个批处理内。例如，在 SQL 查询分析器和 osql 实用工具中，GO 命令标志批处理的结束。当实用工具在一行的前两个字节中读到字符 GO 时，则把从上一 GO 命令开始的所有代码作为一个批处理发送到服务器。如果 GO 出现在 /* 和 */ 分隔符之间的一行行首，则在每个批处理中都发送不匹配的注释分隔符，从而导致语法错误。例如，以下脚本包含语法错误：

USE Northwind
GO
SELECT * FROM Employees
/* The
GO in this comment causes it to be broken in half */
SELECT * FROM Products
GO

下面是一些有效注释：

USE Northwind
GO
-- First line of a multiple-line comment.
-- Second line of a multiple-line comment.
SELECT * FROM Employees
GO

/* First line of a multiple-line comment.
   Second line of a multipl-line comment. */
SELECT * FROM Products
GO

-- Using a comment in a Transact-SQL statement
-- during diagnosis.
SELECT EmployeeID, /* FirstName, */ LastName
FROM Employees

-- Using a comment after the code on a line.
USE Northwind
GO
UPDATE Products
SET UnitPrice = UnitPrice * .9 -- Try to build market share.
GO

下面是关于注释的一些基本信息：

• 所有字母数字字符或符号均可用于注释。SQL Server 忽略注释中的所有字符，而 SQL 查询分析器、osql 和 isql 将在多行注释中搜索前两个字符是 GO 的行。
  
  
• 批处理中的注释没有最大长度限制。一条注释可由一行或多行组成。