Convenções de nomenclatura de parâmetros DAX

  • Artigo

Os nomes dos parâmetros são padronizados na referência DAX para facilitar o uso e a compreensão das funções.

Nomes de parâmetros

Termo Definição
expressão Qualquer expressão DAX que retorna um único valor escalar, onde a expressão deve ser avaliada várias vezes (para cada linha/contexto).
valor Qualquer expressão DAX que retorna um único valor escalar onde a expressão deve ser avaliada exatamente uma vez antes de todas as outras operações.
tabela Qualquer expressão DAX que retorna uma tabela de dados.
tableName O nome de uma tabela existente usando sintaxe DAX padrão. Não pode ser uma expressão.
columnName O nome de uma coluna existente usando sintaxe DAX padrão, geralmente totalmente qualificada. Não pode ser uma expressão.
nome Uma constante de cadeia de caracteres que será usada para fornecer o nome de um novo objeto.
ordem Uma enumeração usada para determinar a ordem de classificação.
Propriedades Uma enumeração usada para determinar a manipulação de valores de empate.
tipo Uma enumeração usada para determinar o tipo de dados para PathItem e PathItemReverse.

Prefigurando nomes de parâmetros ou usando apenas o prefixo

Termo Definição
prefixação Os nomes dos parâmetros podem ser qualificados com um prefixo que seja descritivo de como o argumento é usado e para evitar a leitura ambígua dos parâmetros. Por exemplo:

Result_ColumnName - Refere-se a uma coluna existente usada para obter os valores de resultado na função LOOKUPVALUE().

Search_ColumnName - Refere-se a uma coluna existente usada para procurar um valor na função LOOKUPVALUE().
omitindo Os nomes dos parâmetros serão omitidos se o prefixo for claro o suficiente para descrever o parâmetro.

Por exemplo, em vez de ter a seguinte sintaxe DATA (Year_Value, Month_Value, Day_Value) é mais claro para o usuário ler DATA (Ano, Mês, Dia); repetir três vezes o valor do sufixo não acrescenta nada a uma melhor compreensão da função e atrapalha a leitura desnecessariamente.

No entanto, se o parâmetro prefixado for Year_columnName o nome do parâmetro e o prefixo permanecerão para garantir que o usuário entenda que o parâmetro requer uma referência a uma coluna existente de Anos.