DAX-paraméterelnevezési konvenciók

  • Cikk

A paraméternevek a DAX-hivatkozásokban standardizáltak, hogy megkönnyítsék a függvények használatát és megértését.

Paraméternevek

Időszak Definíció
Kifejezés Bármely DAX-kifejezés, amely egyetlen skaláris értéket ad vissza, ahol a kifejezést többször kell kiértékelni (minden sorhoz/környezethez).
value Bármely DAX-kifejezés, amely egyetlen skaláris értéket ad vissza, ahol a kifejezést pontosan egyszer kell kiértékelni az összes többi művelet előtt.
table Bármely DAX-kifejezés, amely adattáblát ad vissza.
tableName Egy meglévő tábla neve szabványos DAX-szintaxissal. Nem lehet kifejezés.
columnName Egy meglévő oszlop neve szabványos DAX-szintaxissal, általában teljesen minősített. Nem lehet kifejezés.
név Egy sztringállandó, amely egy új objektum nevének megadására szolgál.
Rendelés A rendezési sorrend meghatározására szolgáló enumerálás.
ties A döntetlen értékek kezelésének meghatározására szolgáló enumerálás.
típus A PathItem és a PathItemReverse adattípusának meghatározására szolgáló enumerálás.

Paraméternevek előtagolása vagy csak az előtag használata

Időszak Definíció
előtagolás A paraméternevek tovább minősíthetők egy olyan előtaggal, amely az argumentum használatának módját leíró, és a paraméterek nem egyértelmű olvasásának elkerülése érdekében. Például:

Result_ColumnName – A LOOKUPVALUE() függvény eredményértékeinek lekéréséhez használt meglévő oszlopra hivatkozik.

Search_ColumnName – A LOOKUPVALUE() függvényben egy érték keresésére használt meglévő oszlopra hivatkozik.
Elhagyva A paraméternevek elhagyhatók, ha az előtag elég egyértelmű a paraméter leírásához.

Például a dátum (Year_Value, Month_Value, Day_Value) szintaxis helyett a felhasználó számára egyértelműbb a DÁTUM (Év, Hónap, Nap) olvasása; az utótagérték háromszoros ismétlése nem ad hozzá semmit a függvény jobb megértéséhez, és szükségtelenül zsúfolttá teszi az olvasást.

Ha azonban az előtagú paraméter Year_columnName, akkor a paraméter neve és az előtag megmarad, hogy a felhasználó megértse, hogy a paraméter egy meglévő Years oszlopra való hivatkozást igényel.