Ler em inglês

Partilhar via


ERRO

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Gera um erro com uma mensagem de erro.

Sintaxe

ERROR(<text>)  

Parâmetros

Vigência Definição
text Uma cadeia de texto que contém uma mensagem de erro.

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

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 levanta e 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]

Devolve a seguinte tabela:

DimProduct[Cor] [Medida]
Preto Preto
Azul Azul
Cinzento Cinzento
Multi Multi
NA NA
Vermelho Vermelho
Prata Prata
Prata\Preto Prata\Preto
Branco Branco
Amarelo Amarelo

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