注释(MDX 语法)
注释是程序代码中不执行的文本字符串。(注释又称为“备注”)。可以使用注释说明代码,或者暂时禁用正在诊断的部分多维表达式 (MDX) 语句和脚本。通过使用注释说明代码,可使程序代码在日后更易于维护。通常使用注释记录程序名称、作者姓名和主要代码更改的日期。也可以使用注释说明复杂的计算或解释编程方法。
MDX 中的注释遵循下列指导原则:
注释中可以使用所有字母数字字符或符号。Microsoft SQL Server Analysis Services 将忽略注释中的所有字符。
语句或脚本中的注释没有最大长度限制。一条注释可由一行或多行组成。
MDX 支持三种类型的注释字符:
//(双正斜杠)
这些注释字符可与要运行的代码在同一行上,也可单独成一行。从双正斜杠开始到行尾均为注释部分。对于多行注释,每个注释行的开始都必须出现双正斜杠。有关详细信息,请参阅 //(注释)(MDX)。--(双连字符)
这些注释字符可与要运行的代码在同一行上,也可单独成一行。从双连字符开始到行尾均为注释部分。对于多行注释,每个注释行的开始都必须出现双连字符。有关详细信息,请参阅 --(注释)(MDX)。/* ... */(正斜杠-星号字符对)
这种注释字符可在要运行的代码行中使用,可以单独成行,也可以位于可执行代码中。开始注释字符对 (/*) 与结束注释字符对 (*/) 之间的所有内容均为注释。对于多行注释,必须使用开始注释字符对 (/*) 开始注释,使用结束注释字符对 (*/) 结束注释。注释的任何行中均不能出现其他注释字符。有关详细信息,请参阅 /*...*/(注释)。
示例
以下查询说明上述三种注释的示例:
//An example of a comment using the double-forward slash
--An example of a comment using the double-hypen
/*An example of a
multi-line
comment*/
SELECT
{[Measures].[Internet Sales Amount]}
ON Columns,
[Date].[Calendar].MEMBERS
ON Rows
FROM [Adventure Works]