式の構築
最終更新日時: 2026/10/27列の追加、列式の編集、変換ルールの作成、またはデータセットのフィルタリングを行う際には、式を使用して列の値を計算したり、条件を定義したりできます。
式ビルダーには、現在のタスクで利用可能な要素が一覧表示されます。移動タスクの参照には、SaaS マネージド ランディング、レイク ランディング、レプリケーション タスクが含まれます。ストレージ、変換、データマートの式は、データ プラットフォームまたはタスク エンジンに依存します。CDC ストレージおよびストリーミング変換関数については、「変換関数」を参照してください。エディターで利用可能な関数と構文を使用します。
式の作成または編集
-
設定している列、変換ルール、またはデータセット フィルターから、式ビルダーを開きます。
列の式の場合、列の
をクリックします。 -
要素を選択し、次に
をクリックして挿入します。式を入力することもできます。各ソース行から値を供給する列パラメーターを挿入します。その際、エディターで使用される構文を保持してください。
ツール バーから演算子を挿入するには、式内で演算子を挿入する場所をクリックしてから、演算子をクリックします。
-
関数引数のプレースホルダーを、列パラメーター、定数、またはネストされた式で置き換えます。
テキスト定数と日付定数は、
'Unknown'や'2026-10-08'のように、単一引用符で囲みます。埋め込み引用符は二重引用符で表します:'O''Brien'.引用符なしで数値を入力します。例:12または12.5。欠損値にはNULLを使用し、'NULL'というテキストは使用しないでください。 -
以下に説明されているとおりに式をテストし、その後、 [OK] をクリックして保存します。
式要素の使用
-
列: ソース データセットの列は、処理中の行から値を提供します。
ストリーミング変換タスクの場合、このリストには、
hdr__kafka_partitionおよびhdr__file_nameなどのランディング列もソース順で含まれます。これらは、移動タスク式におけるQ_H_ヘッダーとは別です。「ランディング テーブル」を参照してください。 -
関数: 値を計算または変換します。関数シグネチャに示されている順序で引数を指定してください。「式関数」を参照してください。
情報メモAzure Synapse Analytics の式では、$RTRIMおよび$LTRIMは、指定されたトリム文字に関係なく、スペースのみをトリムします。 -
演算子: 値を組み合わせる、比較する、または条件を定義します。評価順序を制御するには、括弧を使用します。「式演算子」を参照してください。
-
ヘッダー: SaaS マネージド ランディング、レイク ランディング、レプリケーション タスクで変更メタデータを使用します。ソース エンドポイントの適用可能性と処理フェーズの値については、「式ヘッダー」を参照してください。
例: 列の値を結合する
次の式は、first_file_name と first_file_title をコロンで結合します。
${first_file_name} || ':' || ${first_file_title}サンプル値 sales と Sales June 2022 の場合、結果は sales:Sales June 2022 です。
式を編集
式のテスト
保存する前に、サンプル パラメーター値を使用して計算結果を確認します。パラメーター抽出は式の入力を識別します。テストでは、指定した値で式を評価します。
$SOURCE_LOOKUP および $TARGET_LOOKUP 関数への呼び出しのテストはサポートされていません。-
[パラメーターの抽出] をクリックします。
-
各パラメーターについて、 [テストする値] を入力します。列のデータ型に適した値を使用してください。
-
[式をテスト] をクリックして、結果を確認します。
式が無効な場合は、構文や引数を修正し、パラメーターを再度抽出してから、再度テストを実行してください。該当する場合は欠損値を含め、代表値で繰り返します。サンプル テストが成功したとしても、すべてのソース行が確認されるわけではありません。