Ler em inglês

Compartilhar via


ERRO

aplica-se a:coluna calculadatabela calculadamedidacá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.