適用対象:
Azure Data Factory Azure Synapse Analytics
ヒント
企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータ サイエンス、リアルタイム分析、ビジネス インテリジェンス、レポートまで、あらゆるものをカバーしています。 無料で新しい試用版を開始する方法について説明します。
データ フローは、Azure Data Factory パイプラインと Azure Synapse Analytics パイプラインの両方で使用できます。 この記事は、マッピング データ フローに適用されます。 変換を初めて使用する場合は、入門記事「 マッピング データ フローを使用したデータの変換」を参照してください。
この記事では、マッピング データ フローで Azure Data Factory と Azure Synapse Analytics でサポートされるメタ関数について詳しく説明します。
メタ関数一覧
メタ関数は、主にデータ フロー内のメタデータに対して機能します。
| メタ関数 | タスク |
|---|---|
| byItem | 構造体または構造体の配列内のサブ項目を検索します。 複数の一致がある場合は、最初の一致が返されます。 一致がない場合は、 NULL 値が返されます。 戻り値は、型変換アクションのいずれか ( ? date や ? stringなど) によって型変換される必要があります。 デザイン時に名前によってのみ認識される列名をアドレス指定します。 計算された入力はサポートされていませんが、パラメーターの置換を使用できます |
| byOrigin | 元のストリームでの名前で列の値を選択します。 2 番目の引数は元のストリームの名前です。 複数の一致がある場合は、最初の一致が返されます。 一致がない場合は、 NULL 値が返されます。 戻り値は、型変換関数 ( TO_DATE や TO_STRINGなど) によって型変換される必要があります。 デザイン時に名前によってのみ認識される列名をアドレス指定します。 計算された入力はサポートされていませんが、パラメーターの置換を使用できます。 |
| byOrigins | ストリーム内の名前を指定して列の配列を選択します。 2 番目の引数は発生したストリームです。 複数の一致がある場合は、最初の一致が返されます。 一致がない場合は、 NULL 値が返されます。 戻り値は、型変換関数 ( TO_DATE や TO_STRINGなど) によって型変換される必要があります。 デザイン時に名前によってのみ認識される列名をアドレス指定します。 計算された入力はサポートされていませんが、パラメーターの置換を使用できます。 |
| byName | ストリームでの名前で列の値を選択します。 省略可能なストリーム名を 2 番目の引数として渡すことができます。 複数の一致がある場合は、最初の一致が返されます。 一致がない場合は、 NULL 値が返されます。 戻り値は、型変換関数 ( TO_DATE や TO_STRINGなど) によって型変換される必要があります。 デザイン時に名前によってのみ認識される列名をアドレス指定します。 計算された入力はサポートされていませんが、パラメーターの置換を使用できます。 |
| byNames | ストリーム内の名前を指定して列の配列を選択します。 省略可能なストリーム名を 2 番目の引数として渡すことができます。 複数の一致がある場合は、最初の一致が返されます。 列に一致する値がない場合、出力全体は NULL 値になります。 戻り値には、型変換関数 ( toDate や toStringなど) が必要です。 デザイン時に名前によってのみ認識される列名をアドレス指定します。 計算された入力はサポートされていませんが、パラメーターの置換を使用できます。 |
| byPath | ストリームでの名前で階層パスを見つけます。 省略可能なストリーム名を 2 番目の引数として渡すことができます。 このようなパスが見つからない場合は、 NULL 値を返します。 設計時に名前やドット表記パスとして認識される列名/パスに対応します。 計算された入力はサポートされていませんが、パラメーターの置換を使用できます。 |
| byPosition | ストリーム内の相対位置 (1 から始まる) で列の値を選択します。 位置が範囲外の場合は、 NULL 値を返します。 戻り値は、型変換関数 ( TO_DATE や TO_STRINGなど) によって型変換される必要があります。 計算された入力はサポートされていませんが、パラメーターの置換を使用できます。 |
| hasPath | ストリームでの名前で特定の階層パスが存在するかどうかを確認します。 省略可能なストリーム名を 2 番目の引数として渡すことができます。 設計時に名前またはドット表記パスとしてのみ認識される列名/パスに対処します。 計算された入力はサポートされていませんが、パラメーターの置換を使用できます。 |
| originColumns | 列が作成された元のストリームのすべての出力列を取得します。 別の関数内で囲む必要があります。 |
| hex | バイナリ値の 16 進文字列表現を返します。 |
| unhex | バイナリ値を 16 進数文字列表記から数値に変換します。
sha2とmd5と共に使用して、文字列からバイナリ表現に変換できます。 |