Convenções de nomenclatura de parâmetros DAX
O DAX tem nomes de parâmetros padrão para facilitar o uso e a compreensão das funções DAX. Além disso, você pode usar certos prefixos para os nomes dos parâmetros. Se o prefixo for claro o suficiente, você pode usar o próprio prefixo como o nome do parâmetro.
Para entender a sintaxe das funções DAX e usar os valores de dados de forma apropriada para os parâmetros de função DAX relevantes, você precisa entender as convenções de nomenclatura de parâmetros DAX.
Nomes de Parâmetros
A seguir estão os nomes dos parâmetros padrão DAX -
| Sr. Não. | Nome e descrição do parâmetro |
|---|---|
| 1 |
expression Qualquer expressão DAX que retorna um único valor escalar, em que a expressão deve ser avaliada várias vezes (para cada linha / contexto). |
| 2 |
value Qualquer expressão DAX que retorna um único valor escalar em que a expressão deve ser avaliada exatamente uma vez antes de todas as outras operações. |
| 3 |
table Qualquer expressão DAX que retorna uma tabela de dados. |
| 4 |
tableName O nome de uma tabela existente usando a sintaxe DAX padrão. Não pode ser uma expressão. |
| 5 |
columnName O nome de uma coluna existente usando a sintaxe DAX padrão, geralmente totalmente qualificada. Não pode ser uma expressão. |
| 6 |
name Uma constante de string que será usada para fornecer o nome de um novo objeto. |
| 7 |
order Uma enumeração usada para determinar a ordem de classificação. |
| 8 |
ties Uma enumeração usada para determinar o tratamento de valores de empate. |
| 9 |
type Uma enumeração usada para determinar o tipo de dados para PathItem e PathItemReverse. |
Prefixando nomes de parâmetros ou usando apenas o prefixo
Você pode qualificar um nome de parâmetro com um prefixo -
O prefixo deve ser descritivo de como o argumento é usado.
O prefixo deve ser de forma que a leitura ambígua do parâmetro seja evitada.
Por exemplo,
Result_ColumnName - Refere-se a uma coluna existente usada para obter os valores de resultado na função DAX LOOKUPVALUE ().
Search_ColumnName - Refere-se a uma coluna existente usada para pesquisar um valor na função DAX LOOKUPVALUE ().
Você pode omitir o nome do parâmetro e usar apenas o prefixo, se o prefixo for claro o suficiente para descrever o parâmetro. Omitir o nome do parâmetro e usar apenas o prefixo às vezes pode ajudar a evitar a confusão durante a leitura.
Por exemplo, considere DATE (Year_value, Month_value, Day_value). Você pode omitir o nome do parâmetro - valor, que é repetido três vezes e escrever como DATA (Ano, Mês, Dia). Como visto, usando apenas os prefixos, a função é mais legível. No entanto, às vezes o nome do parâmetro e o prefixo precisam estar presentes para maior clareza.
Por exemplo, considere Year_columnName. O nome do parâmetro é ColumnName e o prefixo é Year. Ambos são necessários para fazer o usuário entender que o parâmetro requer uma referência a uma coluna existente de anos.