ERROR

Artigo
01/23/2025

aplica-se a:coluna calculada tabela calculada medida cálculo visual

Gera um erro com uma mensagem de erro.

Sintaxe

ERROR(<text>)

Parâmetros

Prazo	Definição
`text`	Uma cadeia de caracteres de texto que contém uma mensagem de erro.

Valor de retorno

Nenhum

Observações

A função ERROR pode ser colocada em uma expressão DAX em qualquer lugar em que um valor escalar seja esperado.
Essa função não tem suporte para uso no modo DirectQuery quando usada em colunas calculadas ou regras de RLS (segurança em nível de linha).

Exemplo 1

A seguinte consulta DAX:

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 gera e mensagem de erro que contém "cor vermelha encontrada".

Exemplo 2

A seguinte consulta DAX:

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]

Retorna a tabela a seguir:

DimProduct[Color]	[Medida]
Preto	Preto
Azul	Azul
Cinza	Cinza
Multi	Multi
NA	NA
Vermelho	Vermelho
Prata	Prata
Silver\Black	Silver\Black
Branco	Branco
Amarelo	Amarelo

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

Compartilhar via