Ler em inglês

Compartilhar via


ERROR

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Gera um erro com uma mensagem de erro.

Sintaxe

ERROR(<text>)  

Parâmetros

Termo Definição
texto Uma cadeia de texto que contém uma mensagem de erro.

Valor retornado

Nenhum

Comentários

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

  • Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.

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 uma mensagem de erro contendo: "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 seguinte tabela:

DimProduct[Color] [Measure]
Preto Preto
Azul Azul
Cinza Cinza
Multi Multi
NA NA
Vermelho Vermelho
Prata Prata
Prata\Preto Prata\Preto
Branca Branco
Amarelo Amarelo

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