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.