dax-udf

UDF DAX

Uma UDF empacota lógica DAX com nome e parâmetros para reutilizar em medidas, colunas calculadas, cálculos visuais, formatos dinâmicos e outras UDFs. GA no Desktop e no Service desde junho/2026; exige nível de compatibilidade 1702 ou superior.

Antes de escrever uma função do zero, procure na Code Library UDF DAX (functionlibrary.officetuning.com.br/dax/udf/biblioteca): calendário, comparativo AV/AA/Δ (Delta.*), datas fiscais, feriados, texto, estatística.

Fluxo de trabalho

1. Escreva e teste na DAX Query View com DEFINE FUNCTION … EVALUATE.

Nada vai para o modelo até você aprovar.

1. Grave no modelo: CodeLens Update model: Add new function (uma) ou

Update model with changes (todas). Na TMDL view, botão Apply.

1. Use na medida e confira o resultado num visual.
2. Em .pbip, a função fica em definition/functions.tmdl e entra no Git

como qualquer medida (ver tmdl-pbir).

Anatomia (padrão da casa)

DEFINE
    /// Aplica imposto sobre um valor.
    /// @param {NUMERIC} valor - Valor antes do imposto
    /// @param {NUMERIC} [aliquota] - Alíquota opcional; padrão 0,1 (10%)
    /// @returns O valor com imposto
    FUNCTION Fiscal.ComImposto =
        ( valor : NUMERIC, aliquota : NUMERIC = 0.1 ) =>
            valor * ( 1 + aliquota )

EVALUATE
    ROW (
        "Padrão", Fiscal.ComImposto ( 100 ),
        "Alíquota 20%", Fiscal.ComImposto ( 100, 0.2 )
    )
-- 110 e 120

Tipos de parâmetro

Forma: nome : [tipo] [subtipo] [modo] [= padrão]. Sem nada, vale ANYVAL VAL.

Subtipos de SCALAR (declarar o subtipo já implica SCALAR): INT64, DECIMAL, DOUBLE, NUMERIC (qualquer dos três), STRING, DATETIME, BOOLEAN, VARIANT. Tipos de valor convertem implicitamente ("5" vira 5 num INT64); tipos de expressão não.

VAL × EXPR — a decisão que mais erra

• Use VAL para número, texto, data, tabela pronta.
• Use EXPR quando a função precisa mudar o contexto da expressão

(CALCULATE, ALL, iterar e recalcular por linha).

• Dentro de iterador, MEASUREREF faz transição de contexto sozinha;

SCALAR EXPR com SUM(...) não — envolva em CALCULATE ( valorExpr ).

Exemplos completos (TABLE VAL × EXPR, TOP N com MEASUREREF, checagem de tipo): references/padroes-udf.md.

UDF em formato dinâmico de medida

O caso que mais economiza: a mesma lógica de formato em várias medidas. Na medida: Formato → Dinâmico e, na expressão de formato:

Formato.Escala ( SELECTEDMEASURE () )

A medida continua numérica (gráficos funcionam), ao contrário de FORMAT() dentro da medida, que devolve texto. No visual, deixe Unidades de exibição = Nenhum, senão o visual reescala por cima. Código da Formato.Escala e variações: references/padroes-udf.md.

Onde usar e cuidados

Limitações (confira a data no Microsoft Learn)

• Sem recursão (nem mútua), sem sobrecarga, sem tipo de retorno declarado.
• Não dá para ocultar, colocar em pasta de exibição nem traduzir a função.
• Não funciona em modelo sem tabelas.
• Conexão dinâmica: medidas de relatório chamam a UDF, sem IntelliSense.

Modelo composto: medidas do modelo local não chamam UDF do modelo de origem.

• ⚠️ OLS não passa para a função. Não exponha objeto protegido em nome ou

descrição de função.

• Nome sem tabela ([Valor]) é lido como medida: dentro de UDF, sempre

qualifique colunas (Vendas[Valor]).

• Parâmetro EXPR não usado no corpo nunca é calculado.

Listar e auditar

EVALUATE INFO.USERDEFINEDFUNCTIONS ()   -- nome, expressão, estado, erro

Metadados completos podem exigir permissão de escrita ou de administrador do modelo, conforme o host. State = Error + ErrorMessage mostram função quebrada depois de renomear tabela ou coluna.

Fontes

• DAX user-defined functions
• FUNCTION (DAX)
• UDF no Power BI Desktop
• Dynamic format strings
• INFO.USERDEFINEDFUNCTIONS