# 式の構築

列の追加、列式の編集、変換ルールの作成、またはデータセットのフィルタリングを行う際には、式を使用して列の値を計算したり、条件を定義したりできます。

式ビルダーには、現在のタスクで利用可能な要素が一覧表示されます。移動タスクの参照には、SaaS マネージド ランディング、レイク ランディング、レプリケーション タスクが含まれます。ストレージ、変換、データマートの式は、データ プラットフォームまたはタスク エンジンに依存します。CDC ストレージおよびストリーミング変換関数については、「[変換関数](https://help.qlik.com/ja-JP/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. 以下に説明されているとおりに式をテストし、その後、 [OK] をクリックして保存します。

## 式要素の使用

* 列: ソース データセットの列は、処理中の行から値を提供します。

  ストリーミング変換タスクの場合、このリストには、`hdr__kafka_partition` および `hdr__file_name` などのランディング列もソース順で含まれます。これらは、移動タスク式における `Q_H_` ヘッダーとは別です。「[ランディング テーブル](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Lakehouse/lakehouse-datasets-architecture-streaming.htm#Landing)」を参照してください。

* 関数: 値を計算または変換します。関数シグネチャに示されている順序で引数を指定してください。「[式関数](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Transformation/Expression-functions.htm)」を参照してください。

  情報メモAzure Synapse Analytics の式では、`$RTRIM` および `$LTRIM` は、指定されたトリム文字に関係なく、スペースのみをトリムします。

* 演算子: 値を組み合わせる、比較する、または条件を定義します。評価順序を制御するには、括弧を使用します。「[式演算子](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Transformation/Expression-operators.htm)」を参照してください。

* ヘッダー: SaaS マネージド ランディング、レイク ランディング、レプリケーション タスクで変更メタデータを使用します。ソース エンドポイントの適用可能性と処理フェーズの値については、「[式ヘッダー](https://help.qlik.com/ja-JP/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` です。

式を編集

式を編集

式を編集 ![コロンで 2 つのデータセット列を結合する数式エディター。](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Resources/Images/ui_qdi_expression_editor.png)

## 式のテスト

保存する前に、サンプル パラメーター値を使用して計算結果を確認します。パラメーター抽出は式の入力を識別します。テストでは、指定した値で式を評価します。

情報メモ`$SOURCE_LOOKUP` および `$TARGET_LOOKUP` 関数への呼び出しのテストはサポートされていません。

1. [パラメーターの抽出] をクリックします。

2. 各パラメーターについて、 [テストする値] を入力します。列のデータ型に適した値を使用してください。

3. [式をテスト] をクリックして、結果を確認します。

式が無効な場合は、構文や引数を修正し、パラメーターを再度抽出してから、再度テストを実行してください。該当する場合は欠損値を含め、代表値で繰り返します。サンプル テストが成功したとしても、すべてのソース行が確認されるわけではありません。