Funções definidas pelo usuário do DAX (versão prévia)

As UDFs (funções definidas pelo usuário) da DaX (Expressões de Análise de Dados) permitem empacotar lógica DAX reutilizável e parametrizada em seus modelos, facilitando a gravação, a manutenção e o compartilhamento do código DAX. Em vez de repetir fórmulas entre medidas, colunas calculadas e visuais, as UDFs trazem flexibilidade de estilo de programação para seus modelos semânticos, permitindo que você defina funções uma vez e use-as em todos os lugares em que o DAX tenha suporte. Para saber mais, confira as funções definidas pelo usuário da DAX.

Por que usar funções definidas pelo usuário?

• Reutilização e consistência: defina um cálculo uma vez e reutilize-o em todos os lugares.
• Manutenção: atualize a lógica em um só lugar para corrigir ou evoluir regras.
• Criação mais segura: dicas de tipo opcionais e auxiliares de verificação de tipo dão suporte a códigos previsíveis e resistentes a erros.
• Objetos de modelo de primeira classe: as UDFs residem no modelo e podem ser exibidas no Gerenciador de Modelos.

Introdução

Para experimentar UDFs na área de trabalho:

1. Vá para Arquivo > Opções e Configurações > Opções.
2. Selecione recursos de visualização e verifique as funções definidas pelo usuário do DAX.
3. Selecione OK e reinicie o Power BI Desktop.

Definir uma função

Você pode definir uma função definida pelo usuário no Power BI Desktop usando o modo de exibição de consulta DAX (DQV) ou o modo de exibição TMDL.

Sintaxe geral

A sintaxe geral de uma UDF é:

/// Optional description above the function
FUNCTION <FunctionName> = ( <ParameterName>: <ParameterType>, ... ) => <FunctionBody>

Exemplo: Função fiscal simples

Aqui está um exemplo simples no DQV que adiciona impostos ao valor determinado. Você também pode avaliar UDFs no DQV.

DEFINE
    /// AddTax takes in amount and returns amount including tax
    FUNCTION AddTax = (
            amount : NUMERIC
        ) =>
        amount * 1.1

EVALUATE
{ AddTax ( 10 ) }
// Returns 11

Depois que um UDF é definido, você pode atualizar o modelo ou usar a lente de código para adicionar a função ao seu modelo.