注释(MDX 语法)
注释是程序代码中不执行的文本字符串。 (注释又称为“备注”。) 可以使用注释说明代码,或者暂时禁用正在诊断的部分多维表达式 (MDX) 语句和脚本。 通过使用注释说明代码,可使程序代码在日后更易于维护。 通常使用注释记录程序名称、作者姓名和主要代码更改的日期。 也可以使用注释说明复杂的计算或解释编程方法。
MDX 中的注释遵循下列指导原则:
注释中可以使用所有字母数字字符或符号。 忽略批注中的所有字符。
语句或脚本中的注释没有最大长度限制。 一条注释可由一行或多行组成。
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]