Compartilhar via

DAX convenções de nomenclatura de parâmetros

  • 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 de parâmetro

Prazo Definição
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).
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.
table Qualquer expressão DAX que retorna uma tabela de dados.
tableName O nome de uma tabela existente usando a sintaxe padrão DAX. Não pode ser uma expressão.
columnName O nome de uma coluna que usa a sintaxe DAX padrão, geralmente totalmente qualificada. Não pode ser uma expressão.
name Uma constante de cadeia de caracteres que será usada para fornecer o nome de um novo objeto.
order Uma enumeração usada para determinar a ordem de classificação.
ties Uma enumeração usada para determinar a manipulação de valores de ligação.
type Uma enumeração usada para determinar o tipo de dados para PathItem e PathItemReverse.

Prefixando nomes de parâmetro ou usando apenas o prefixo

Prazo Definição
prefixing Os nomes de parâmetro podem ser ainda 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 na função LOOKUPVALUE().
omitting Os nomes de parâmetro serão omitidos se o prefixo estiver 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 (Ano, Mês, Dia); repetir três vezes o valor do sufixo não adiciona nada a uma melhor compreensão da função e desorganiza 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 Years.