DAX 参数命名约定

参数名称在 DAX 引用中进行了标准化,方便使用和理解函数。

参数名称

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

在参数名称前加前缀或仅使用前缀

术语 定义
prefixing 可以使用前缀对形参名称进行进一步限定,此前缀描述如何使用实参以及如何避免模糊地读取形参。 例如:

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

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

例如,与其采用以下语法 DATE (Year_Value, Month_Value, Day_Value),用户可以清晰地读取 DATE (Year, Month, Day);重复三次后缀值并不会有助于更好地理解函数,并且会不必要地搅乱读取体验。

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