Udostępnij za pośrednictwem

Konwencje nazewnictwa parametrów języka DAX

  • Artykuł

Nazwy parametrów są ustandaryzowane w dokumentacji języka DAX w celu ułatwienia użycia i zrozumienia funkcji.

Nazwy parametrów

Okres Definicja
wyrażenie Dowolne wyrażenie języka DAX zwracające pojedynczą wartość skalarną, gdzie wyrażenie ma być obliczane wiele razy (dla każdego wiersza/kontekstu).
wartość Dowolne wyrażenie języka DAX zwracające pojedynczą wartość skalarną, w której wyrażenie ma być obliczane dokładnie raz przed wszystkimi innymi operacjami.
tabelę Dowolne wyrażenie języka DAX zwracające tabelę danych.
tableName Nazwa istniejącej tabeli przy użyciu standardowej składni języka DAX. Nie może to być wyrażenie.
Columnname Nazwa istniejącej kolumny używającej standardowej składni języka DAX, zwykle w pełni kwalifikowana. Nie może to być wyrażenie.
name Stała ciągu, która będzie używana do podania nazwy nowego obiektu.
order Wyliczenie używane do określania kolejności sortowania.
ties Wyliczenie używane do określania obsługi wartości wiązania.
type Wyliczenie używane do określania typu danych pathItem i PathItemReverse.

Prefiksowanie nazw parametrów lub używanie tylko prefiksu

Okres Definicja
prefiksowanie Nazwy parametrów mogą być dodatkowo kwalifikowane przy użyciu prefiksu opisowego sposobu użycia argumentu i uniknięcia niejednoznacznego odczytywania parametrów. Przykład:

Result_ColumnName — odwołuje się do istniejącej kolumny używanej do pobierania wartości wyników w funkcji LOOKUPVALUE().

Search_ColumnName — odwołuje się do istniejącej kolumny używanej do wyszukiwania wartości w funkcji LOOKUPVALUE().
Pominięcie Nazwy parametrów zostaną pominięte, jeśli prefiks jest wystarczająco jasny, aby opisać parametr .

Na przykład zamiast mieć następującą składnię DATE (Year_Value, Month_Value, Day_Value) jest jaśniejszy dla użytkownika odczytywanie daty (rok, miesiąc, dzień); powtarzanie trzy razy wartość sufiksu nie dodaje niczego do lepszego zrozumienia funkcji i niepotrzebnie zaśmieca czytanie.

Jeśli jednak prefiks parametru jest Year_columnName nazwa parametru i prefiks pozostaną, aby upewnić się, że użytkownik rozumie, że parametr wymaga odwołania do istniejącej kolumny Years.