ERROR

適用於:導出數據行計算數據表Measure視覺計算

使用 error 訊息引發 error。

語法

DAX
ERROR(<text>)

參數

術語 定義
text 包含 error 訊息的文字字串。

傳回 value

None

言論

  • ERROR 函式可以放在預期純量 value 的任何位置的 DAX 表達式中。

  • 在匯出數據行中使用 or 數據列層級安全性 (RLS) 規則時,支援此函式 not 用於 DirectQuery 模式。

範例 1

下列 DAX 查詢:

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]

失敗 and 引發包含「遇到紅色」的 anderror 訊息。

範例 2

下列 DAX 查詢:

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]

傳回下表:

DimProduct[Color] [Measure]
灰色 灰色
Silver\Black Silver\Black
黃色 黃色

由於Magenta是 not 其中一種 product 色彩,因此 ERROR 函式會 not 執行。