ERROR

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Gera um erro com uma mensagem de erro.

Sintaxe

ERROR(<text>)

Parâmetros

Valor de retorno

Nenhum

Comentários

• A função ERROR pode ser colocada em uma expressão DAX em qualquer lugar onde um valor escalar é esperado.

• Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).

Exemplo 1

O seguinte DAX consulta:

DEFINE
MEASURE DimProduct[Measure] =
        IF(
            SELECTEDVALUE(DimProduct[Color]) = "Red",
            ERROR("red color encountered"),
            SELECTEDVALUE(DimProduct[Color])
        )
EVALUATE SUMMARIZECOLUMNS(DimProduct[Color], "Measure", [Measure])
ORDER BY [Color]

Falha e levanta e mensagem de erro contendo "cor vermelha encontrada".

Exemplo 2

O seguinte DAX consulta:

DEFINE
MEASURE DimProduct[Measure] =
        IF(
            SELECTEDVALUE(DimProduct[Color]) = "Magenta",
            ERROR("magenta color encountered"),
            SELECTEDVALUE(DimProduct[Color])
        )
EVALUATE SUMMARIZECOLUMNS(DimProduct[Color], "Measure", [Measure])
ORDER BY [Color]

Devolve a seguinte tabela:

Como Magenta não é uma das cores do produto, a função ERROR não é executada.