Поделиться через

соглашения об именовании параметров DAX

  • Статья

Имена параметров стандартизированы в справочном документе DAX для облегчения использования и понимания функций.

Имена параметров

Срок Определение
expression Любое выражение DAX, возвращающее одно скалярное значение, где выражение вычисляется несколько раз (для каждой строки или контекста).
value Любое выражение DAX, возвращающее одно скалярное значение, в котором выражение должно оцениваться ровно один раз перед всеми остальными операциями.
table Любое выражение DAX, возвращающее таблицу данных.
tableName Имя существующей таблицы с использованием стандартного синтаксиса DAX. Это не может быть выражением.
columnName Имя существующего столбца с использованием стандартного синтаксиса DAX, обычно полностью квалифицированное. Это не может быть выражением.
name Строка константы, которая будет использоваться для предоставления имени нового объекта.
order Перечисление, используемое для определения порядка сортировки.
ties Перечисление, используемое для определения обработки равных значений.
type Перечисление, используемое для определения типа данных для PathItem и PathItemReverse.

Использование префиксов для имени параметров или только префикса.

Срок Определение
prefixing Имена параметров могут быть более квалифицированы с префиксом, который описывает использование аргумента и чтобы избежать неоднозначного чтения параметров. Например:

Result_ColumnName — ссылается на существующий столбец, используемый для получения значений результатов в функции LOOKUPVALUE().

Search_ColumnName — ссылается на существующий столбец, используемый для поиска значения в функции LOOKUPVALUE().
omitting Имена параметров будут опущены, если префикс достаточно ясен для описания параметра.

Например, вместо использования следующего синтаксиса DATE (Year_Value, Month_Value, Day_Value) пользователь может читать DATE (год, месяц, день); повторяющееся три раза значение суффикса не добавляет ничего в лучшее понимание функции, и она загромождает чтение ненужным образом.

Однако, если параметр содержит префикс Year_columnName, то имя параметра и префикс сохраняются, чтобы пользователь понял, что параметр требует ссылку на существующий столбец с годами.