通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

serialize 运算符

  • 项目

适用于：✅✅Azure 数据资源管理器Azure Monitor✅ Sentinel

标记输入行集的顺序可安全用于开窗函数。

运算符具有声明性含义。 它将输入行集标记为已序列化（已排序），以便可以将开窗函数应用于它。

语法

serialize [Name1 Expr1 [= Name2 Expr2]...],=

详细了解语法约定。

参数

客户 类型​​ 必需 说明
Name string 要添加或更新的列的名称。 如果省略，则会自动生成输出列名称。
Expr string ✔️ 要对输入执行的计算。

示例

本节中的示例演示如何使用语法帮助你入门。

本文中的示例使用 帮助群集中的公开可用表，例如 示例 数据库中的 StormEvents 表。

本文中的示例使用公开可用的表，例如天气分析中的 StormEvents 表 示例数据。

按条件序列化行子集

此查询从 TraceLogs 表中检索具有特定 ClientRequestId 的所有日志条目，并在处理过程中保留这些条目的顺序。

TraceLogs
| where ClientRequestId == "5a848f70-9996-eb17-15ed-21b8eb94bf0e"
| serialize

输出

此表仅显示前 5 个查询结果。

时间戳 节点 元件 ClientRequestId 消息
2014-03-08T12：24：55.5464757Z Engine000000000757 INGESTOR_GATEWAY 5a848f70-9996-eb17-15ed-21b8eb94bf0e $$IngestionCommand table=fogEvents format=json
2014-03-08T12：24：56.0929514Z Engine000000000757 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e 正在下载文件路径：“”https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz"”
2014-03-08T12：25：40.3574831Z Engine000000000341 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 Engine000000000341 DOWNLOADER 5a848f70-9996-eb17-15ed-21b8eb94bf0e 正在下载文件路径：“”https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz"”
2014-03-08T12：26：25.1684905Z Engine000000000057 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 Engine000000000899 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 Engine000000000899 DOWNLOADER 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 Engine000000000584 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 Engine000000000584 DOWNLOADER 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 Engine000000000380 INGESTOR_EXECUTER 5a848f70-9996-eb17-15ed-21b8eb94bf0e IngestionCompletionEvent：完成引入文件路径：“”https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz"”
... ... ... ... ...

运算符的序列化行为

以下运算符的输出行集标记为已序列化。

以下运算符的输出行集会标记为非序列化。

所有其他运算符保留序列化属性。 如果输入行集已序列化，则输出行集也会序列化。