serialize 演算子
適用対象: ✅Microsoft Fabric✅Azure データ エクスプローラー✅Azure Monitor✅Microsoft Sentinel
入力行セットの順序を、ウィンドウ関数に対して安全に使用できるとしてマークします。
この演算子には宣言型の意味があります。 入力行セットがシリアル化 (順序付け) としてマークされるため、ウィンドウ関数をそれに適用できます。
構文
serialize [Name1=Expr1 [,Name2=Expr2]...
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 内容 |
|---|---|---|---|
| 名前 | string |
追加または更新する列の名前。 省略すると、出力列名が自動的に生成されます。 | |
| Expr | string |
✔️ | 入力に対して実行する計算。 |
例
このセクションの例では、構文を使用して作業を開始する方法を示します。
この記事の例では、Samples データベースの
StormEventsテーブルなど、ヘルプ クラスターので一般公開されているテーブルを使用します。
この記事の例では、Weather Analytics サンプル データの
StormEventsテーブルなど、一般公開されているテーブルを使用します。
条件によって行のサブセットをシリアル化する
このクエリは、特定の ClientRequestId を持つ TraceLogs テーブルからすべてのログ エントリを取得し、処理中にこれらのエントリの順序を保持します。
TraceLogs
| where ClientRequestId == "5a848f70-9996-eb17-15ed-21b8eb94bf0e"
| serialize
出力
この表には、上位 5 件のクエリ結果のみが表示されます。
| タイムスタンプ | ノード | コンポーネント | ClientRequestId | メッセージ |
|---|---|---|---|---|
| 2014-03-08T12:24:55.5464757Z | Engine00000000757 | INGESTOR_GATEWAY | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | $$IngestionCommand table=fogEvents format=json |
| 2014-03-08T12:24:56.0929514Z | Engine00000000757 | ダウンローダー | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | ファイル パスのダウンロード: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz"" |
| 2014-03-08T12:25:40.3574831Z | Engine00000000341 | INGESTOR_EXECUTER | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | IngestionCompletionEvent: 完了したインジェスト ファイル パス: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz"" |
| 2014-03-08T12:25:40.9039588Z | Engine00000000341 | ダウンローダー | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | ファイル パスのダウンロード: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz"" |
| 2014-03-08T12:26:25.1684905Z | Engine00000000057 | INGESTOR_EXECUTER | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | IngestionCompletionEvent: 完了したインジェスト ファイル パス: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz"" |
| ... | ... | ... | ... | ... |
シリアル化されたテーブルに行番号を追加する
シリアル化されたテーブルに行番号を追加するには、 row_number() 関数を使用します。
TraceLogs
| where ClientRequestId == "5a848f70-9996-eb17-15ed-21b8eb94bf0e"
| serialize rn = row_number()
出力
この表には、上位 5 件のクエリ結果のみが表示されます。
| タイムスタンプ | rn | ノード | コンポーネント | ClientRequestId | メッセージ |
|---|---|---|---|---|---|
| 2014-03-08T13:00:01.6638235Z | 1 | Engine00000000899 | INGESTOR_EXECUTER | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | IngestionCompletionEvent: 完了したインジェスト ファイル パス: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_46.json.gz"" |
| 2014-03-08T13:00:02.2102992Z | 2 | Engine00000000899 | ダウンローダー | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | ファイル パスのダウンロード: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz"" |
| 2014-03-08T13:00:46.4748309Z | 3 | Engine00000000584 | INGESTOR_EXECUTER | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | IngestionCompletionEvent: 完了したインジェスト ファイル パス: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz"" |
| 2014-03-08T13:00:47.0213066Z | 4 | Engine00000000584 | ダウンローダー | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | ファイル パスのダウンロード: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz"" |
| 2014-03-08T13:01:31.2858383Z | 5 | Engine00000000380 | INGESTOR_EXECUTER | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | IngestionCompletionEvent: 完了したインジェスト ファイル パス: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz"" |
| ... | ... | ... | ... | ... |
演算子のシリアル化動作
次の演算子の出力行セットは、シリアル化としてマークされます。
次の演算子の出力行セットは、非初期化としてマークされます。
- count
- distinct
- evaluate
- facet
- join
- make-series
- mv-expand
- reduce by
- sample
- sample-distinct
- summarize
- top-nested
他のすべての演算子は、シリアル化プロパティを保持します。 入力行セットがシリアル化されている場合、出力行セットもシリアル化されます。