# 建置運算式

在新增欄位、編輯欄位運算式、建立轉換規則或篩選資料集時，使用運算式來計算欄位值或定義條件。

運算式建立器會列出目前工作可用的元素。移動任務參考資料涵蓋 SaaS 管理的登陸、湖登陸和複寫任務。儲存、轉換及資料市集運算式取決於資料平台或工作引擎。如需 CDC 儲存與串流轉換功能，請參閱 [轉換函數](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Lakehouse/transformation-functions.htm)。使用您的編輯器中提供的函式與語法。

## 建立或編輯運算式

1. 從您正在設定的資料欄、轉換規則或資料集篩選條件開啟運算式產生器。

   若為資料行運算式，請按一下資料行上的 the 編輯欄位運算式 icon。

2. 選取元素，然後按一下 the 插入選取的運算式元素 icon 即可插入。

   您也可以輸入運算式。插入資料行參數以提供來自每個來源資料列的值，並保留編輯器所使用的語法。

   若要從工具列插入運算子，請按一下運算式中要放置該運算子的位置，然後按一下該運算子。

3. 將函式引數預留位置取代為資料行參數、常數或巢狀運算式。

   請以單引號括住文字與日期常數，例如 `'Unknown'` 和 `'2026-10-08'`。使用兩個引號表示內嵌引號：`'O''Brien'`。輸入不含引號的數字，例如 `12` 或 `12.5`。請使用 `NULL` 表示遺漏值，而非文字 `'NULL'`。

4. 依下列說明測試運算式，然後按一下 確定 進行儲存。

## 使用運算式元素

* 資料行：來源資料集資料行會提供正在處理之資料列的值。

  對於 Streaming Transform 任務，此清單還會依來源順序包含諸如 `hdr__kafka_partition` 和 `hdr__file_name` 等登陸欄位。這些與移動任務運算式中的 `Q_H_` 標頭是分開的。請參閱 [登陸表格](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Lakehouse/lakehouse-datasets-architecture-streaming.htm#Landing)。

* 函式：計算或轉換值。請依函式簽章所示的順序提供引數。請參閱 [運算式函式](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Transformation/Expression-functions.htm)。

  資訊備註針對 Azure Synapse Analytics 運算式，無論指定的修剪字元為何，`$RTRIM` 和 `$LTRIM` 都僅會修剪空格。

* 運算子：結合值、比較值，或定義條件。使用括號來控制評估順序。請參閱 [運算式運算子](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Transformation/Expression-operators.htm)。

* 標頭：在 SaaS 管理的登陸、Lake 登陸和複寫任務中使用變更中繼資料。請參閱 [運算式標頭](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Transformation/Expression-headers.htm) 以了解來源端點適用性與處理階段值。

## 範例：合併資料行值

下列運算式使用冒號連接 `first_file_name` 與 `first_file_title`：

```
${first_file_name} || ':' || ${first_file_title}
```

對於範例值 `sales` 與 `Sales June 2022`，結果為 `sales:Sales June 2022`。

編輯運算式

編輯運算式

編輯運算式 ![以冒號結合兩個資料集資料行的運算式編輯器。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_qdi_expression_editor.png)

## 測試運算式

在儲存之前，使用範例參數值檢查計算結果。參數擷取會識別運算式輸入；測試則會使用您提供的值來評估運算式。

資訊備註不支援測試對 `$SOURCE_LOOKUP` 和 `$TARGET_LOOKUP` 函式的呼叫。

1. 按一下擷取參數。

2. 為每個參數輸入要測試的值，並使用適合該資料行資料類型的值。

3. 按一下測試運算式並檢查結果。

如果運算式無效，請修正其語法與引數，然後在重新測試前再次擷取參數。使用具代表性的值重複執行，並在相關情況下包含遺漏值。成功的取樣測試不會檢查每一筆來源資料列。