什么是预期的 Azure Time-Series-Insights Gen2 API - 获取参数用于 GetEvents 和 GetSeries 端点的行为?

What is the expected Azure Time-Series-Insights Gen2 API-behavior incase of take-parameter is used for GetEvents and GetSeries endpoints?

我目前正在试验 Azure TSI Gen2 ApiVersion = "2020-07-31",我想知道 GetSeriesGetEvents 端点 Take 参数的效果。

如果我查询 TSI 数据以获得包含比我在 Take 参数上定义的事件更多的宽 searchSpan,会发生什么?数据是否按某种顺序返回?响应数据的预期形式是什么?

Take

的文档定义

take - integer - Maximum number of property values in the whole response set, not the maximum number of property values per page. Defaults to 10,000 when not set. Maximum value of take can be 250,000.

如此处记录:https://docs.microsoft.com/en-us/azure/time-series-insights/concepts-query-overview#time-series-query-tsq-apis

获取事件获取系列 API支持分页以检索所选输入的完整响应数据集。

take 参数指定查询返回的事件数(跨页面)。因此,如果您的搜索跨度包含的事件多于您“获取”的事件,TSI 会随机选择或 'takes',从存储中选择该组记录。例如。如果您的搜索范围内有 20k 个事件,并且拍摄了 10k 个事件,那么您将从该时间范围内的 20k 个事件中随机获得 10k 个事件。

在 TSI 资源管理器中,当您“探索事件”以查看原始数据时,资源管理器会调用 GetEvents。 TSI 资源管理器将始终尝试显示最大 (250k) 个事件,如果搜索跨度超过 250k,则会通知您。

A​​PI 不按任何顺序返回数据。添加排序功能是我们路线图上的内容。这是一个 feedback item,您也可以在其中对添加此功能的请求投赞成票。

这里有一些 examples 显示 request/response 的 GetEvents 和其他 API。