Convenções de nomenclatura de parâmetro DAX

  • Artigo

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

Nomes do parâmetro

Termo Definição
expressão 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).
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.
tabela Qualquer expressão DAX que retorna uma tabela de dados.
tableName O nome de uma tabela existente, usando a sintaxe DAX padrão. Não pode ser uma expressão.
columnName O nome de uma coluna existente usando a 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.
empates Uma enumeração usada para determinar a manipulação de valores de ligação.
tipo Uma enumeração usada para determinar o tipo de dados para PathItem e PathItemReverse.

Como prefixar nomes de parâmetro ou usar apenas o prefixo

Termo Definição
como prefixar Os nomes de parâmetro podem ser mais qualificados com um prefixo 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 pesquisar um valor de resultado na função LOOKUPVALUE().
como omitir Os nomes de parâmetro serão omitidos se o prefixo for claro o suficiente para descrever o parâmetro.

Por exemplo, em vez de ter a seguinte sintaxe DATE (Year_Value, Month_Value Day_Value), é mais claro para o usuário ler DATE (Year, Month, Day). Repetir três vezes o valor do sufixo não adiciona nada a uma compreensão melhor da função e complica 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.