DAX 使用者定義函式 （預覽）

備註

DAX 使用者定義函式目前處於 預覽狀態。

資料分析運算式 （DAX） 使用者定義函數 （UDF） 可讓您將可重複使用的參數化 DAX 邏輯封裝到模型中，讓您的 DAX 程式碼更易於撰寫、維護和共用。 UDF 不會跨量值、計算資料行和視覺效果重複公式，而是為您的語意模型帶來程式設計樣式的彈性，讓您定義一次函式，並在支援 DAX 的任何地方使用它們。 若要深入瞭解，請參閱 DAX 使用者定義函式。

為什麼要使用使用者定義函數？

• 可重複使用性和一致性：定義一次計算，即可在任何地方重複使用。
• 可維護性：在一個地方更新邏輯以修復或演進規則。
• 更安全的編寫：選擇性類型提示和類型檢查協助程式支援可預測的防錯程式碼。
• 第一類模型物件：UDF 位於模型中，可在模型總管中檢視。

開始

若要在桌面中試用 UDF：

1. 前往 檔案 > 選項及設定 > 選項。
2. 選取 預覽功能， 然後檢查 DAX 使用者定義的函式。
3. 選取 [ 確定 ]， 然後重新啟動 Power BI Desktop。

定義函數

您可以使用 DAX 查詢檢視 （DQV） 或 TMDL 檢視，在 Power BI Desktop 中定義使用者定義函式。

一般語法

UDF 的一般語法為：

/// Optional description above the function
FUNCTION <FunctionName> = ( <ParameterName>: <ParameterType>, ... ) => <FunctionBody>

範例：簡單的稅務函數

這是 DQV 中的一個簡單範例，它對給定金額加稅。 您也可以在 DQV 中評估 UDF。

DEFINE
    /// AddTax takes in amount and returns amount including tax
    FUNCTION AddTax = (
            amount : NUMERIC
        ) =>
        amount * 1.1

EVALUATE
{ AddTax ( 10 ) }
// Returns 11

定義 UDF 之後，您可以更新模型，或使用程式碼透鏡將函數新增至模型。

- [DAX 使用者定義函數]（/dax/best-practices/dax-user-defined-functions）