Sdílet prostřednictvím

Konvence pojmenování parametrů jazyka DAX

  • Článek

Názvy parametrů jsou standardizovány v referenčních informacích jazyka DAX, které usnadňují používání a porozumění funkcím.

Názvy parametrů

Pojem definice
výraz Libovolný výraz DAX, který vrací jednu skalární hodnotu, kde se má výraz vyhodnotit několikrát (pro každý řádek nebo kontext).
hodnotu Libovolný výraz DAX, který vrátí jednu skalární hodnotu, kde se má výraz vyhodnotit přesně jednou před všemi ostatními operacemi.
table Libovolný výraz DAX, který vrací tabulku dat.
tableName Název existující tabulky pomocí standardní syntaxe jazyka DAX. Nemůže to být výraz.
Columnname Název existujícího sloupce pomocí standardní syntaxe jazyka DAX, obvykle plně kvalifikovaný. Nemůže to být výraz.
Název Řetězcová konstanta, která se použije k zadání názvu nového objektu.
order Výčet použitý k určení pořadí řazení.
osti Výčet sloužící k určení zpracování hodnot vazby.
type Výčet použitý k určení datového typu Pro PathItem a PathItemReverse.

Předpona názvů parametrů nebo pouze použití předpony

Pojem definice
předpona Názvy parametrů mohou být dále kvalifikované s předponou, která popisuje způsob použití argumentu a vyhnout se nejednoznačnému čtení parametrů. Příklad:

Result_ColumnName – Odkazuje na existující sloupec, který slouží k získání výsledných hodnot ve funkci LOOKUPVALUE().

Search_ColumnName – Odkazuje na existující sloupec použitý k vyhledání hodnoty ve funkci LOOKUPVALUE().
Vynechání Názvy parametrů budou vynechány, pokud je předpona dostatečně jasná k popisu parametru.

Například místo toho, aby měl následující syntaxi DATUM (Year_Value, Month_Value, Day_Value), je jasnější, aby si uživatel přečetl datum (rok, měsíc, den); opakování třikrát hodnota přípony nepřidá nic k lepšímu porozumění funkce a zbytečně nepřehledná čtení.

Pokud je však předpona parametru Year_columnName název parametru a předpona zůstane, aby uživatel porozuměl tomu, že parametr vyžaduje odkaz na existující sloupec Years.