DAX UDFの仕組みを解説：VALとEXPRの違い

By Mirko Peters · 2026-08-28

ポッドキャスト連動ブログへようこそ！最新のエピソードでは、DAX のユーザー定義関数（UDF）の奥深い世界を掘り下げました。もしあなたが…

Automatically translated with AI from the original post. Read the English original

ポッドキャスト連動ブログへようこそ！最新のエピソードでは、DAX ユーザー定義関数（UDF）の奥深い世界を掘り下げました。Power BI や Analysis Services で UDF を試したことがある方なら、UDF がコードの重複を減らし、ビジネスロジックを一元化するうえで非常に有用であることはご存じでしょう。しかし、パラメーターモードの違いを理解しないまま高度なモデリングに取り組むと、気づきにくい不具合、想定外の合計値、そして深刻なクエリのタイムアウトにつながりかねません。解説音声の全体像や実際の活用例を確認したい方は、関連エピソード「DAX UDF VAL vs EXPR: Prevent Timeouts and Wrong Totals」をぜひお聴きください。

本記事では、VAL と EXPR というパラメーターモードの核心的な違いについて詳しく解説します。読み終える頃には、静的な値を取り込むべき場面と、コンテキストに応じて動的に評価される式を使うべき場面を正確に判断できるようになり、セマンティックモデルを高速かつ正確に保てるようになるはずです。

DAX UDF の概要

DAX UDF とは何か？

DAX ユーザー定義関数（UDF）を使うと、データモデル全体で再利用できるカスタム計算を作成できます。同じ数式を何度も書く代わりに、一度関数として定義し、必要な場所で呼び出します。この方法により、作業を整理し、一貫性を保つことができます。

DAX UDF は、レポートを構成するビルディングブロックと考えてください。ロジックをカプセル化するため、同じ記述を繰り返す必要がありません。これにより時間が節約され、エラーも減ります。さらに、これらの関数をチームで共有できるため、共同作業もしやすくなります。

データ分析における他のユーザー定義関数と比べて、DAX UDF の特長を簡単に見ていきましょう。

DAX UDF の重要性

DAX ユーザー定義関数を使うと、レポート開発がさまざまな面で改善します。まず、モデルがすっきりして保守しやすくなります。関数を更新すれば、それを使うすべてのメジャーが自動的に更新されます。これによりミスの発生が減り、レポートの一貫性も保たれます。

DAX UDF は拡張性も高めます。レポートが複雑になっても、乱雑になったり遅くなったりしにくくなります。複雑な計算を段階的に構築し、その手順をモデルの別の部分で再利用できます。このモジュール化された設計により、作業効率が向上します。

DAX UDF を使うことで得られる主なメリットは次のとおりです。

• ロジックの重複が減り、エラーの削減と時間の節約につながります。
• ビジネスルールを一箇所で更新でき、その変更があらゆる場所に反映されます。
• 関数の共有ライブラリをチームに提供でき、共同作業が改善します。
• レポート開発を簡素化し、必要な時間を最大70～80％削減できます。

従来の DAX 数式と比べると、DAX UDF はパフォーマンスも大幅に向上させられます。たとえば、ある検証では、UDF によって計算時間が 6000 ミリ秒超から 160 ミリ秒強へと短縮されました。これは 97％の改善です。

DAX ユーザー定義関数を習得すると、データモデルをより適切に制御できるようになります。より高速で保守しやすく、信頼性の高いレポートを作成できます。このスキルにより、ビジネスニーズに応える高品質な分析を提供できるようになります。

DAX UDF の誤った使い方：よくある間違い

データ型の誤解

DAX UDF を扱う際、データ型で苦労する方は少なくありません。パラメーターに適切な型を使うことの重要性を見落としがちです。この誤解は想定外の結果につながることがあります。たとえば、数値を想定した関数にテキスト値を渡すと、計算が失敗したり誤った結果が返されたりする場合があります。

データ型に関連するよくある落とし穴は次のとおりです。

• ユーザーは数値形式とテキスト形式をよく混同します。
• DAX では日付が数値として扱われることに気づいていない場合があり、それが計算を複雑にすることがあります。
• データ型を誤って使用すると、モデルのパフォーマンスが低下し、レポートの表示が遅くなることがあります。

誤った構文の使用

構文エラーも、DAX UDF を扱う際によくある問題です。わずかなミスでも、計算の実行が止まってしまうことがあります。構文エラーがあると、DAX は式エディターに黄色の警告記号を表示します。この記号は何かが誤っていることを示しますが、問題の正確な箇所までは必ずしも明確にしてくれません。

避けるべき代表的な構文の誤りは次のとおりです。

• 括弧や角かっこを閉じ忘れる。
• 関数名が誤っている、またはスペルを間違えている。
• 引数をコンマで区切り忘れる。

これらのエラーは、イライラや時間の浪費につながります。DAX 式を実行する前に、必ず構文を入念に確認してください。

エラー処理の無視

DAX UDF の信頼性を維持するには、効果的なエラー処理が欠かせません。多くのユーザーがこの点を軽視しており、その結果、計算が失敗することがあります。たとえば、関数が想定外の型の入力を受け取ると、有用な結果ではなくエラーを返すことがあります。

これらの問題を防ぐために、次の方法の導入を検討してください。

• IFERROR() 関数を使用して代替値を返します。これにより、エラーがビジュアルの表示を妨げることを防げます。
• ISBLANK() を利用して、真の空白値を確認し、ゼロや空の文字列と区別します。
• COALESCE() を実装すると、式のリストの中から最初の空白でない値を返せます。

入力の型を確認する関数を定義することもできます。たとえば、ISSTRING() を使用して入力が文字列かどうかを検証します。文字列でなければ BLANK() を返します。このアプローチにより、計算の堅牢性と信頼性が保たれます。

これらのよくある誤りを避けることで、DAX UDF を改善し、データモデル全体のパフォーマンスを高めることができます。VAL と EXPR を正しく使う方法を理解することが、DAX のユーザー定義関数の可能性を最大限に引き出す鍵であることを覚えておいてください。

DAX における VAL の理解

VAL の目的

DAX の VAL 関数は、明確な目的を持っています。それは、数値のテキスト表現を実際の数値に変換することです。この関数は、さまざまな形式のデータを扱う場合に欠かせません。たとえば、データソースから数値がテキストとして届く場合、VAL を使用して、利用可能な数値形式に変換できます。この変換により、計算を正確に実行できます。

次の場合に VAL を使用します。

• 計算が数値に対して確実に機能するようにする必要がある場合。
• 数値の代わりにテキストを使用することで生じるエラーを避けたい場合。
• 正しい形式ではないことがある、ユーザー入力を扱う場合。

VAL の構文

VAL 関数の構文は、次のとおりシンプルです。

VAL(<text>)

• <text>: 数値に変換するテキスト文字列を表すパラメーターです。直接入力したテキストでも、テキスト値を含む列への参照でも指定できます。

VAL 関数の使用例を、簡単に示します。

SalesAmount = VAL('Sales'[SalesText])

この例では、'SalesText' 列のテキストを数値に変換し、その値に対して計算を実行できるようにしています。

VAL の使用例

DAX における VAL 関数の実用的な例をいくつか見ていきましょう。

1. 基本的な変換: 'RevenueText' という名前の列に、売上高がテキストとして格納されているとします。これらの値を数値に変換するメジャーを作成できます。

   TotalRevenue = SUMX('Sales', VAL('Sales'[RevenueText]))

   このメジャーは、各テキストエントリーを数値に変換して、売上高の合計を計算します。

2. ユーザー入力の処理: ユーザーが数値をテキストとして入力するシナリオでは、VAL を使用して計算の正確性を確保できます。たとえば、ユーザーが売上目標をテキストで入力した場合、次のように変換できます。

   SalesTarget = VAL(UserInput[TargetText])

   これにより、売上目標に基づく計算が正しく行われるようになります。

3. エラーの防止: VAL を使用すると、レポートでのエラーを防げます。テキスト値を変換せずに計算を実行しようとすると、問題が発生することがあります。VAL を使用すると、こうしたエラーを防ぐことができます。

   AdjustedSales = IF(ISERROR(VAL('Sales'[SalesText])), 0, VAL('Sales'[SalesText]))

   この例では、変換に失敗した場合、エラーを発生させる代わりにメジャーは 0 を返します。

VAL 関数の目的と正しい使い方を理解することで、DAX のユーザー定義関数を強化できます。この知識により、データをより効果的に扱えるようになり、計算結果の正確性も確保できます。

DAX における EXPR の理解

EXPR の目的

DAX の EXPR パラメーター モードは、データ モデルの変化にユーザー定義関数を動的に反応させたい場合に重要な役割を果たします。関数呼び出し時に固定値を取得する VAL とは異なり、EXPR では、関数の実行のたびに評価される式を渡せます。そのため、計算がフィルター コンテキストや行コンテキストの違いに自動的に適応できます。

関数がデータの状況変化に応じて動作する必要がある場合は、EXPR を使用してください。たとえば、現在のフィルターやスライサーの選択内容に依存するメジャーを計算したい場合、そのロジックを式として渡すことができます。この柔軟性により、ユーザー定義関数の能力が高まり、コンテキストをより的確に扱えるようになります。

ヒント: EXPR を使用すると、ユーザーの操作やデータのフィルターに応じて更新される動的な計算を作成できます。これにより、リアルタイムの状況を反映したレポートを構築しやすくなります。

EXPR の構文

DAX ユーザー定義関数で EXPR を使用する構文では、パラメーターを式として宣言する必要があります。一般的な形式は次のとおりです。

DEFINE FUNCTION MyFunction(EXPR paramName AS EXPRESSION)
RETURNS <return_type>
AS
BEGIN
    RETURN <calculation_using paramName>
END

• paramName: 式を受け取るパラメーターの名前です。
• EXPRESSION: パラメーターが固定値ではなく式を受け取ることを指定します。

関数を呼び出す際は、単純な値の代わりに DAX 式を渡します。関数は、現在のフィルター コンテキストまたは行コンテキストを考慮して、この式を実行のたびに評価します。

EXPR の使用例

EXPR が DAX ユーザー定義関数でどのように機能するのかを理解するために、いくつかの実用的な例を見ていきましょう。

1. 動的フィルターの例

フィルター式を動的に渡せるように、売上合計を計算する関数を作成したい場合を考えます。

DEFINE FUNCTION TotalSalesWithFilter(EXPR FilterExpression AS EXPRESSION)
RETURNS DECIMAL
AS
BEGIN
    RETURN CALCULATE(SUM(Sales[Amount]), FilterExpression)
END

この関数を呼び出す際は、さまざまなフィルター式を渡すことができます。

TotalSalesWithFilter(FILTER(Sales, Sales[Region] = "West"))

この呼び出しでは、西地域の売上だけが計算されます。関数はフィルター式を都度評価するため、指定されたコンテキストに適応します。

1. コンテキストに依存する計算

EXPR を使用して、現在の行またはフィルター コンテキストに依存するメジャーや計算を渡すこともできます。

DEFINE FUNCTION CalculateMargin(EXPR SalesExpr AS EXPRESSION, EXPR CostExpr AS EXPRESSION)
RETURNS DECIMAL
AS
BEGIN
    RETURN SalesExpr - CostExpr
END

SUM(Sales[Amount]) や SUM(Sales[Cost]) のような式を使ってこの関数を呼び出すと、現在のフィルターに基づいて利益率を動的に計算できます。

1. EXPR と CALCULATE の併用

コンテキスト遷移を確実に行いたい場合は、EXPR パラメーターを必ず CALCULATE で囲んでください。これにより、式が目的のフィルター コンテキストで正しく評価されます。

注: 固定値を渡したり、式を CALCULATE で囲まなかったりすると、EXPR を誤って使用することになり、予期しない結果を招く可能性があります。

DAX ユーザー定義関数での EXPR を習得すると、柔軟でコンテキストを意識した計算を記述できるようになります。このスキルにより、ユーザーの選択やデータの変化に正確に反応するレポートを構築できます。

DAX ユーザー定義関数のベスト プラクティス

効果的な使用のヒント

DAX ユーザー定義関数を最適化するには、次のベスト プラクティスに従ってください。

• EXPR パラメーターを使用する際は、コンテキスト遷移の問題に注意してください。コンテキスト遷移は、適切に管理されていないと予期しない結果を招く可能性があります。
• 複雑なシナリオでは CALCULATE を活用してください。この関数はテーブル コンテキストを効果的に管理し、計算が意図したロジックを反映するように役立ちます。
• モジュール化された開発を重視してください。複雑なロジックは管理しやすい単位に分割します。このアプローチによりメンテナンスが簡単になり、パフォーマンスも向上します。
• チーム間でビジネス ロジックを標準化してください。関数の定義と使用方法を統一することで、コラボレーションが促進され、重複を減らせます。
• 計算は一か所にまとめて最適化してください。この方法を取れば、広範囲な検索を行わなくてもロジックを更新でき、パフォーマンスと保守性を高められます。

よくあるシナリオと解決策

VAL と EXPR をどのような場合に使い分けるかを理解すると、DAX UDF の活用効果が大きく高まります。よくあるシナリオは次のとおりです。

• パラメーターの値が固定されている場合や、行コンテキストに依存しない場合は、VAL パラメーターを使用します。たとえば、固定のしきい値が必要な場合は、VAL が適切な選択です。
• パラメーターを異なる行コンテキストで評価する必要がある場合は、EXPR パラメーターを選択します。この柔軟性により、テーブルの反復処理や計算済みの指標に基づくフィルターなど、動的な計算が可能になります。

これらの要点を説明する具体的な例を以下に示します。

1. BestCustomers 関数では、EXPR パラメーターを使用することで、各顧客ごとにメトリックを評価でき、正確な結果が得られます。
2. VAL パラメーターを使用すると、関数はメジャーを一度だけ評価します。コンテキストが変わると、誤った結果や空の結果になる可能性があります。
3. コンテキスト遷移は非常に重要です。EXPR パラメーターは、CALCULATE で明示的に管理することで、正しく評価させることができます。

これらのベストプラクティスを適用することで、DAX のユーザー定義関数の保守を簡素化し、パフォーマンスを向上させることができます。このアプローチは計算を強化するだけでなく、データモデルの長期的な効率化にも役立ちます。

このブログでは、DAX のユーザー定義関数における VAL と EXPR の重要性について学びました。これらの概念を理解することで、よくある間違いを避け、データモデルを強化できます。

• VAL は固定値を取り込み、EXPR は動的な計算を可能にします。
• これらの関数を適切に使用することで、精度とパフォーマンスが向上します。

この知識を活用して、より効果的な DAX UDF を作成できます。今日からこれらの方法を実践して、データ分析のスキルを一段と高めましょう! 🚀 完全な音声解説と議論については、関連するエピソードもぜひご覧ください: DAX UDF VAL vs EXPR: Prevent Timeouts and Wrong Totals。

よくある質問

DAX における VAL と EXPR の違いは何ですか?

VAL は、関数の呼び出し時点の固定値を取り込みます。EXPR は式を動的に評価し、フィルター コンテキストや行コンテキストの変化に応じて結果が変わります。

VAL はいつ使うべきですか?

定数の数値が必要な場合に VAL を使用します。しきい値のように、コンテキストに応じて入力値が変わらないシナリオに最適です。

EXPR がより良い選択になるのはいつですか?

計算がデータの状態の変化に応じて反応する必要がある場合に EXPR を選択します。ユーザーの操作やフィルターに基づいて動的に評価できます。

同じ関数内で VAL と EXPR を組み合わせることはできますか?

はい、関数内で VAL と EXPR を組み合わせることができます。固定値が必要か動的な式が必要かに応じて、適切に使い分けてください。

DAX UDF のパフォーマンスを改善するにはどうすればよいですか?

パフォーマンスを高めるには、関数内の複雑な計算を最小限にしてください。静的な値には VAL を使用し、EXPR の評価は CALCULATE でラップしてコンテキスト遷移を効果的に管理します。

DAX UDF で避けるべきよくある間違いは何ですか?

データ型の誤用、不正な構文、エラー処理の見落としを避けてください。これらの間違いは、不正確な結果を招き、データモデルのパフォーマンスを低下させる原因になります。

DAX UDF をテストする方法はありますか?

はい、サンプルレポートを作成するか DAX Studio を使用して DAX UDF をテストできます。これにより、パフォーマンスを評価し、計算の正確性を確認できます。

DAX UDF に関するその他の資料はどこで見つけられますか?

DAX UDF に関する追加の資料は、Microsoft の公式ドキュメント、オンライン コース、コミュニティ フォーラムで見つけられます。これらのプラットフォームには、有用な知見や例が豊富にあります。