ERROR

適用対象:計算列計算テーブルメジャービジュアル計算

エラーを発生させ、エラー メッセージを生成します。

構文

ERROR(<text>)  

パラメーター

戻り値

なし

解説

• ERROR 関数は、DAX 式内でスカラー値が予想される任意の場所に指定できます。

• この関数は、計算列または行レベルのセキュリティ (RLS) ルールで使用される場合、DirectQuery モードでの使用はサポートされません。

例 1

次の 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]

失敗し、"red color encountered" (赤色が検出されました) というエラーメッセージを生成します。

例 2

次の 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]

次の表を返します。

マゼンタは製品の色の 1 つではないため、ERROR 関数は実行されません。