在 Power BI 中学会使用注释_在 Power BI 中学会使用注释

在计算机语言中,为了提升代码的可读性,一般都会有注释功能,注释是代码中的自然语言文本,但不会被执行,因而可以实现编写者的特定意图,比如对代码的含义进行解释,对相关的背景进行说明等。

 

在PowerBI中的两种语言,DAX和M也不例外,虽然他们是一种函数式语言,相对没有编程语言那么复杂,但在多重嵌套或者业务逻辑较为复杂的情况下,使用注释也很有必要。

 

以PowerBI中最核心也是难度最高的DAX为例,为了提升DAX的可读性和可理解性,之前曾介绍过DAX格式化的方法:

送你一份 DAX 格式指南

 

注释也可以认为是格式化的一部分,都是为了提升代码的可读性和可维护性。

 

下面以上一篇文章(如何使用Power BI进行回流客户分析?)为例,来看看DAX中的注释如何使用。

 

DAX的注释方式

 

在DAX中,有三种注释方式:

 

1,多行注释


以 /* 开头,以 */ 结尾。

 

比如交待度量值的业务背景,可以在前几行添加注释,

 

在 Power BI 中学会使用注释_在 Power BI 中学会使用注释_02

 

在DAX编辑框中,注释的文本自动以绿色显示。

 

2,单行注释

 

单行注释又有两种方式,分别以 // 或 -- 开头,

 

在 Power BI 中学会使用注释_在 Power BI 中学会使用注释_03

 

这两种方式效果一样,你可以选中喜欢的注释方式,不过尽量做到风格统一。

 

单行注释可以放在代码后面,也可以另起一行注释,

 

在 Power BI 中学会使用注释_在 Power BI 中学会使用注释_04

 

以上几种方式效果完全一样,只要是在 // 或者 -- 之后的本行字符都不会被执行。

 

DAX注释快捷键

 

除了手动输入注释字符,还可以用快捷键来快速注释。

 

快捷键有两种方式:

 

1, Ctrl+/

 

将光标移到需要注释的行,按住Ctrl+/,即可注释,再按一次,为取消注释。

 

在 Power BI 中学会使用注释_在 Power BI 中学会使用注释_05

 

还可以选中多行,按住Ctrl+/,同时对多行注释,

 

在 Power BI 中学会使用注释_在 Power BI 中学会使用注释_06

 

2, Ctrl+K+C 和 Ctrl+K+U

 

Ctrl+K+C 是添加注释,重复快捷键会继续套一层注释

 

在 Power BI 中学会使用注释_在 Power BI 中学会使用注释_07

 

Ctrl+K+U 是取消注释,重复快捷键会连续取消注释

 

在 Power BI 中学会使用注释_在 Power BI 中学会使用注释_08

 

平时使用时记住一种方式就行了,Ctrl+/ 简单实用。

 

M函数注释

 

以上关于 DAX 注释的方式和快捷键,在 Power Query 的高级编辑器中同样适用,比如按住 Ctrl+/,

 

在 Power BI 中学会使用注释_在 Power BI 中学会使用注释_09

效果完全一样,不再详细介绍。

 

以上就是PowerBI中的注释方式,注释可以让别人不读代码,就能大概了解这段表达式的含义。

 

但注释也不是越详细越好,太多的注释导致代码很臃肿,在复杂业务逻辑和晦涩难懂之处作适当提示,简明扼要就好。