Funções DAX - Estrutura de descrição

Se você tiver que usar uma função DAX em uma fórmula DAX, precisará entender a função em detalhes. Você deve saber a sintaxe da função, os tipos de parâmetro, o que a função retorna, etc.

Para permitir que você entenda como ler e interpretar as funções DAX, uma estrutura de descrição de função uniforme é usada neste tutorial.

• Os diferentes tipos de funções DAX são agrupados pelo nome do tipo das funções DAX como capítulos.

• Cada um desses capítulos fornece uma breve descrição da utilidade dos respectivos tipos de funções DAX.

• A breve descrição será seguida pela lista de funções DAX correspondentes a esse capítulo (Tipo / Categoria de funções DAX).

• Cada nome de função DAX é um hiperlink para detalhes da função DAX que têm a seguinte estrutura de descrição da função DAX -

  • Description
  • Syntax
  • Parameters
  • Valor de retorno
  • Remarks
  • Example

As seções a seguir explicam cada um desses títulos que aparecem em cada explicação da função DAX.

Descrição

Na seção Descrição, você aprenderá sobre o que é a função DAX e onde ela pode ser usada.

Se a função DAX for introduzida no Excel 2016, a mesma será mencionada aqui. (O restante das funções DAX existem no Excel 2013.)

Sintaxe

Na seção Sintaxe, você aprenderá o nome exato da função e os respectivos parâmetros.

• O nome da função DAX é fornecido em letras MAIÚSCULAS.

• O nome da função DAX é seguido por parênteses de abertura.

• Cada parâmetro segue a convenção de nomenclatura de parâmetro DAX padrão e está entre colchetes angulares.

• Se um parâmetro for opcional, ele será colocado entre colchetes.

• Os parâmetros são separados por vírgulas.

• As reticências… são usadas para mostrar um número opcional de repetições de parâmetros.

• A sintaxe da função termina com parênteses de fechamento.

Exemplo

Parâmetros

Na seção Parâmetros, cada um dos parâmetros da função DAX específica é listado em uma tabela com sua descrição. Por exemplo, os parâmetros da função DAX de exemplo acima, SELECTCOLUMNS, estão listados na tabela a seguir.

Sr. Não.	Parâmetro e Descrição
1	Table Tabela ou uma expressão DAX que retorna uma tabela.
2	Name O nome dado à coluna, entre aspas duplas.
3	scalar_expression Expressão DAX que retorna um valor escalar como uma referência de coluna, número inteiro ou valor de string.

Valor de retorno

Na seção Return Value, você aprenderá sobre qual valor a função DAX retornará e seu tipo de dados.

Observações

Na seção Comentários, você aprenderá sobre qualquer informação extra necessária sobre o uso da função DAX. Você também compreenderá os possíveis erros e os motivos.

Exemplo

Um exemplo do uso da função DAX é fornecido nesta seção.

Note - Ao escrever funções DAX com os valores de dados para os parâmetros, você seguirá as convenções de nomenclatura fornecidas abaixo -

• Um nome de tabela é especificado conforme aparece no modelo de dados. Por exemplo, vendas.

• Um nome de coluna é especificado conforme aparece no modelo de dados com colchetes envolvendo-o.

  Por exemplo, [Valor das vendas]

  • Recomenda-se o uso de nomes totalmente qualificados para colunas, ou seja, um nome de coluna é prefixado com o nome da tabela que o contém.

    Por exemplo, Vendas [Valor das Vendas]

  • Se o nome da tabela contiver espaços, ele deve ser colocado entre aspas simples.

    Por exemplo, 'Vendas Leste' [Valor das Vendas]

• Uma função DAX pode retornar uma coluna ou tabela de valores, nesse caso, ela precisa ser usada como um parâmetro de outra função DAX que requer uma coluna ou tabela.