DAX 参数命名约定

参数名称在 DAX 参考中进行了标准化,以促进对函数的使用和理解。

参数名称

术语 Definition
expression 返回单个标量值的任何 DAX 表达式,其中表达式将多次计算(对于每行/上下文)。
value 返回单个标量值的任何 DAX 表达式,其中表达式将在所有其他操作之前完全计算一次。
table 返回数据表的任何 DAX 表达式。
tableName 使用标准 DAX 语法的现有表的名称。 它不能是表达式。
columnName 使用标准 DAX 语法的现有列的名称,通常完全限定。 它不能是表达式。
name 一个字符串常量,用于提供新对象的名称。
order 用于确定排序顺序的枚举。
ties 用于确定相等值处理方式的枚举。
type 用于确定 PathItem 和 PathItemReverse 的数据类型的枚举。

为参数名称添加前缀或仅使用前缀

术语 Definition
prefixing 参数名称可以进一步限定为前缀,该前缀描述参数的使用方式,并避免参数的不明确读取。 例如:

Result_ColumnName - 指用于获取 () 函数中结果值 LOOKUPVALUE的现有列。

Search_ColumnName - 指用于搜索 () 函数中的 LOOKUPVALUE值的现有列。
omitting 如果前缀足够清晰以描述参数,则将省略参数名称。

例如,与其使用以下语法 DATE(Year_Value、Month_Value、Day_Value),不如让用户阅读更清晰的 DATE(年、月、日);重复三次添加后缀的值并没有提高对函数的理解,反而会带来不必要的阅读混乱。

但是,如果前缀参数为Year_columnName,则参数名称和前缀将保留,以确保用户了解该参数需要对现有年份列的引用。