Funções DAX definidas pelo utilizador (pré-visualização)

As funções definidas pelo usuário (UDFs) DAX (Data Analysis Expressions) permitem empacotar lógica DAX parametrizada e reutilizável em seus modelos, tornando o código DAX mais fácil de escrever, manter e compartilhar. 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 onde o DAX é suportado. Para saber mais, consulte Funções definidas pelo usuário do DAX.

Porquê utilizar funções definidas pelo utilizador?

• Reutilização e consistência: defina um cálculo uma vez e reutilize-o em qualquer lugar.
• Manutenibilidade : 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 suportam código previsível e resistente a erros.
• Objetos de modelo de primeira classe: UDFs vivem no modelo e podem ser visualizados no Gerenciador de Modelos.

Introdução

Para testar UDFs no Desktop:

1. Vá para Opções de arquivo > e opções de configurações>.
2. Selecione Visualizar recursos 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 para uma UDF é:

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

Exemplo: Função fiscal simples

Aqui está um exemplo simples em DQV que adiciona imposto sobre o valor determinado. Você também pode avaliar UDFs em 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.