Partilhar via

DAX convenções de nomenclatura de parâmetros

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

Nomes de parâmetros

Prazo Definição
expression Qualquer expressão DAX que retorna um único valor escalar, onde a expressão deve ser avaliada várias vezes (para cada linha/contexto).
value 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.
table Qualquer expressão DAX que retorna uma tabela de dados.
tableName O nome de uma tabela existente com a sintaxe padrão DAX. Não pode ser uma expressão.
columnName O nome de uma coluna existente utilizando a sintaxe padrão DAX, geralmente completamente 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 empate.
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

Prazo Definição
prefixing 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 LOOKUPVALUEfunção ().

Search_ColumnName - Refere-se a uma coluna existente usada para procurar um valor na LOOKUPVALUEfunção ().
omitting 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 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 acrescenta nada para 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 utilizador entenda que o parâmetro exige uma referência a uma coluna existente de Anos.
  • Last updated on