Leggere in inglese

Condividi tramite


DAX convenzioni di denominazione dei parametri

I nomi dei parametri sono standardizzati in DAX riferimento per facilitare l'utilizzo e la comprensione delle funzioni.

Nomi dei parametri

Termine Definizione
expression Qualsiasi espressione DAX che restituisce un singolo valore scalare, in cui l'espressione deve essere valutata più volte (per ogni riga/contesto).
value Qualsiasi espressione DAX che restituisce un singolo valore scalare in cui l'espressione deve essere valutata esattamente una volta prima di tutte le altre operazioni.
table Qualsiasi espressione DAX che restituisce una tabella di dati.
tableName Nome di una tabella esistente che usa la sintassi DAX standard. Non può essere un'espressione.
columnName Nome di una colonna esistente che usa la sintassi standard DAX, di solito completamente qualificato. Non può essere un'espressione.
name Costante di tipo stringa che verrà usata per fornire il nome di un nuovo oggetto.
order Enumerazione usata per determinare l'ordinamento.
ties Enumerazione utilizzata per determinare la gestione dei valori di associazione.
type Enumerazione utilizzata per determinare il tipo di dati per PathItem e PathItemReverse.

Anteporre i nomi dei parametri o usare solo il prefisso

Termine Definizione
prefixing I nomi dei parametri possono essere ulteriormente qualificati con un prefisso descrittivo del modo in cui viene usato l'argomento e per evitare la lettura ambigua dei parametri. Ad esempio:

Result_ColumnName : fa riferimento a una colonna esistente usata per ottenere i valori dei risultati nella LOOKUPVALUEfunzione ().

Search_ColumnName : fa riferimento a una colonna esistente usata per cercare un valore nella LOOKUPVALUEfunzione ().
omitting I nomi dei parametri verranno omessi se il prefisso è sufficientemente chiaro da descrivere il parametro.

Ad esempio, invece di avere la sintassi DATE seguente (Year_Value, Month_Value, Day_Value) è più chiaro per l'utente leggere DATE (Anno, Mese, Giorno); ripetendo tre volte il valore del suffisso non aggiunge nulla a una migliore comprensione della funzione e commosse la lettura inutilmente.

Tuttavia, se il parametro con prefisso è Year_columnName, il nome del parametro e il prefisso rimarranno per assicurarsi che l'utente comprenda che il parametro richiede un riferimento a una colonna esistente di Years.