mv-expand 演算子

[ バージョン ] ドロップダウン リストを使用してサービスを切り替えます。 ナビゲーションの詳細を確認します。
適用対象: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

複数の値の動的配列またはプロパティ バッグを複数のレコードに展開します。

mv-expand は、複数の値を 1 つの 動的に型指定された配列またはプロパティ バッグ ( summarize ... make-list() や make-seriesなど) にパックする集計演算子の反対として記述できます。 (スカラー) 配列またはプロパティ バッグ内の各要素により、演算子の出力に新しいレコードが生成されます。 展開されない入力のすべての列は、出力のすべてのレコードに複製されます。

Syntax

T|mv-expand [kind=(bag | array)] [with_itemindex=IndexColumnName] ColumnName [to typeof(Typename)] [,ColumnName ...] [limitRowlimit]

T|mv-expand [kind=(bag | array)] [Name=] ArrayExpression [to typeof(Typename)] [, [Name=] ArrayExpression [to typeof(Typename)] ...] [limitRowlimit]

構文規則について詳しく知る。

Parameters

Returns

入力の各レコードについて、演算子は、次の方法で決定されるように、出力で 0 個、1 個、または多数のレコードを返します。

1. 展開されない入力列は、元の値で出力に表示されます。 1 つの入力レコードが複数の出力レコードに展開された場合、その値はすべてのレコードに複製されます。

2. 展開される ColumnName または ArrayExpression ごとに、展開モードで説明されているように、各値に対して出力レコード の数が決定されます。 入力レコードごとに、出力レコードの最大数が計算されます。 すべての配列またはプロパティ バッグは "並行して" 展開され、欠損値 (存在する場合) は null 値に置き換えられます。 要素は、元の配列またはバッグに出現する順序で行に展開されます。

3. 動的な値が null の場合、その値 (null) に対して 1 つのレコードが生成されます。 動的な値が空の配列またはプロパティ バッグの場合、その値に対してレコードは生成されません。 それ以外の場合は、動的な値に含まれる要素と同数のレコードが生成されます。

展開された列は、dynamic 句を使用して明示的に型指定されている場合を除き、to typeof() 型です。

展開のモード

2 つのモードのプロパティ バッグの展開がサポートされています。

• kind=bag または bagexpansion=bag: プロパティ バッグは、単一エントリのプロパティ バッグに展開されます。 これは既定のモードです。
• kind=array または bagexpansion=array: プロパティ バッグは、2 要素の [key,value] 配列構造体に拡張され、キーと値に一様にアクセスできます。 このモードでは、たとえば、プロパティ名での個別のカウントの集計を実行することもできます。

Examples

このセクションの例では、構文を使用して作業を開始する方法を示します。

単一列 - 配列の展開

datatable (a: int, b: dynamic)
[
    1, dynamic([10, 20]),
    2, dynamic(['a', 'b'])
]
| mv-expand b

Output

単一列 - バッグの展開

1 つの列の単純な展開:

datatable (a: int, b: dynamic)
[
    1, dynamic({"prop1": "a1", "prop2": "b1"}),
    2, dynamic({"prop1": "a2", "prop2": "b2"})
]
| mv-expand b

Output

単一列 - キーと値のペアへのバッグの展開

キーと値のペアへの単純なバッグの展開:

datatable (a: int, b: dynamic)
[
    1, dynamic({"prop1": "a1", "prop2": "b1"}),
    2, dynamic({"prop1": "a2", "prop2": "b2"})
]
| mv-expand kind=array b 
| extend key = b[0], val=b[1]

Output

圧縮された 2 つの列

2 つの列を最初に展開して、該当する列を "zip" してから展開します。

datatable (a: int, b: dynamic, c: dynamic)[
    1, dynamic({"prop1": "a", "prop2": "b"}), dynamic([5, 4, 3])
]
| mv-expand b, c

Output

2 つの列のデカルト積

展開する 2 つの列のデカルト積を取得する場合は、一方を展開した後で他方を展開します。

datatable (a: int, b: dynamic, c: dynamic)
[
    1, dynamic({"prop1": "a", "prop2": "b"}), dynamic([5, 6])
]
| mv-expand b
| mv-expand c

Output

出力の変換

mv-expand の出力を特定の型に強制的に展開するには (既定値は dynamic)、to typeof を使用します。

datatable (a: string, b: dynamic, c: dynamic)[
    "Constant", dynamic([1, 2, 3, 4]), dynamic([6, 7, 8, 9])
]
| mv-expand b, c to typeof(int)
| getschema 

Output

列 b は dynamic として返されますが、c は int として返されることに注意してください。

with_itemindexの使用

with_itemindex による配列の展開:

range x from 1 to 4 step 1
| summarize x = make_list(x)
| mv-expand with_itemindex=Index x

Output