マッピング データフローの配列関数

  • [アーティクル]

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータ サイエンス、リアルタイム分析、ビジネス インテリジェンス、レポートまで、あらゆるものをカバーしています。 無料で新しい試用版を開始する方法について説明します。

データ フローは、Azure Data Factory および Azure Synapse Pipelines の両方で使用できます。 この記事は、マッピング データ フローに適用されます。 変換を初めて使用する場合は、概要の記事「マッピング データ フローを使用してデータを変換する」を参照してください。

以下の記事では、マッピング データ フローで Azure Data Factory および Azure Synapse Analytics によってサポートされる配列関数に関する詳細情報を提供します。

配列関数の一覧

配列関数は、配列であるデータ構造体に対して変換を実行します。 これらには、配列の要素とインデックスをアドレス指定するための特殊なキーワードが含まれます。

  • #acc は、配列を縮小するときに 1 つの出力に含める値を表します。
  • #index は、配列のインデックス番号 #index2, #index3 ... と共に、現在の配列のインデックスを表します。
  • #item は、配列内の現在の要素の値を表します。
配列関数 タスク
array 項目の配列を作成します。 すべての項目は同じ型になっている必要があります。 項目が指定されていない場合、既定値は空の文字列配列です。 [] 作成演算子と同じです。
at 配列インデックスにある要素を検索します。 インデックスは 1 から始まっています。 境界外インデックスは、null 値の結果になります。 キーを指定してマップ内の値を検索します。 キーが見つからない場合は、null が返されます。
contains 指定された配列内のいずれかの要素が、指定された述語で true と評価される場合に true を返します。 contains は、述語関数の 1 つの要素への参照を #item として予期します。
distinct 配列から個別の項目セットを返します。
except 重複をドロップした 1 つの配列の差分セットを返します。
filter 指定された述語を満たさない要素を配列から除外します。 filter は、述語関数の 1 つの要素への参照を #item として予期します。
find 配列から条件に一致する最初の項目を検索します。 フィルター関数が使用されます。この関数では、配列内の項目を #item としてアドレス指定できます。 入れ子になった深いマップの場合は、#item_n (#item_1, #item_2...) 表記を使用して親マップを参照できます。
flatten 1 つまたは複数の配列を単一の配列にフラット化します。 アトミック項目の配列は、変更されずに返されます。 最後の引数は省略可能で、既定値は false です。1 レベルを超える深さは再帰的にフラット化されます。
in 項目が配列内にあるかどうかをチェックします。
intersect 2 つの配列からの、個別の項目の交差セットを返します。
map 指定された式を使用して、配列の各要素を新しい要素にマップします。 map は、式関数の 1 つの要素への参照を #item として予期します。
mapIf 配列を、同じ長さまたは短い長さの別の配列に条件付きでマップします。 値は、structTypes など、任意のデータ型とすることができます。 配列内のアイテムを #item として、現在のインデックスを #index としてアドレス指定できるマッピング関数を取ります。 深く入れ子になったマップの場合、#item_[n](#item_1, #index_1...) という表記を使用して親マップを参照できます。
mapIndex 指定された式を使用して、配列の各要素を新しい要素にマップします。 map は、式関数内の 1 つの要素への参照を #item として予期し、要素インデックスへの参照を #index として予期します。
mapLoop 1 から length までループさせてその長さの配列を作成します。 これは、配列内のインデックスを #index としてアドレス指定できるマッピング関数を取ります。 深く入れ子になったマップの場合、#index_n(#index_1, #index_2...) という表記を使用して親マップを参照できます。
reduce 配列内の要素を累積します。 reduce は、最初の式関数のアキュムレータと 1 つの要素への参照を #acc および #item として予期し、結果の値を 2 番目の式関数で使用される #result として予期します。
size 配列またはマップの種類のサイズを見つけます
slice ある位置から配列のサブセットを抽出します。 位置は 1 から始まります。 長さを省略すると、既定値は文字列の最後になります。
sort 指定された述語関数を使用して配列を並べ替えます。 sort は、式関数の 2 つの連続する要素への参照を #item1 および #item2 として予期します。
unfold 配列を一連の行に展開し、すべての行内の残りの列に値を繰り返します。
union 2 つの配列からの個別の項目の和集合を返します。

関連するコンテンツ