在计算机语言中,为了提升代码的可读性,一般都会有注释功能,注释是代码中的自然语言文本,但不会被执行,因而可以实现编写者的特定意图,比如对代码的含义进行解释,对相关的背景进行说明等。
在PowerBI中的两种语言,DAX和M也不例外,虽然他们是一种函数式语言,相对没有编程语言那么复杂,但在多重嵌套或者业务逻辑较为复杂的情况下,使用注释也很有必要。
以PowerBI中最核心也是难度最高的DAX为例,为了提升DAX的可读性和可理解性,之前曾介绍过DAX格式化的方法:
注释也可以认为是格式化的一部分,都是为了提升代码的可读性和可维护性。
下面以上一篇文章(如何使用Power BI进行回流客户分析?)为例,来看看DAX中的注释如何使用。
DAX的注释方式
在DAX中,有三种注释方式:
1,多行注释
以 /* 开头,以 */ 结尾。
比如交待度量值的业务背景,可以在前几行添加注释,
在DAX编辑框中,注释的文本自动以绿色显示。
2,单行注释
单行注释又有两种方式,分别以 // 或 -- 开头,
这两种方式效果一样,你可以选中喜欢的注释方式,不过尽量做到风格统一。
单行注释可以放在代码后面,也可以另起一行注释,
以上几种方式效果完全一样,只要是在 // 或者 -- 之后的本行字符都不会被执行。
DAX注释快捷键
除了手动输入注释字符,还可以用快捷键来快速注释。
快捷键有两种方式:
1, Ctrl+/
将光标移到需要注释的行,按住Ctrl+/,即可注释,再按一次,为取消注释。
还可以选中多行,按住Ctrl+/,同时对多行注释,
2, Ctrl+K+C 和 Ctrl+K+U
Ctrl+K+C 是添加注释,重复快捷键会继续套一层注释
Ctrl+K+U 是取消注释,重复快捷键会连续取消注释
平时使用时记住一种方式就行了,Ctrl+/ 简单实用。
M函数注释
以上关于 DAX 注释的方式和快捷键,在 Power Query 的高级编辑器中同样适用,比如按住 Ctrl+/,
效果完全一样,不再详细介绍。
以上就是PowerBI中的注释方式,注释可以让别人不读代码,就能大概了解这段表达式的含义。
但注释也不是越详细越好,太多的注释导致代码很臃肿,在复杂业务逻辑和晦涩难懂之处作适当提示,简明扼要就好。