查询统计数据
通过使用子系统，ThingWorx 平台提供了用于在运行时查询相关操作的统计数据名称空间。所有查询相关统计数据的根名称空间均以 twx.stats.query 为前缀。将针对由持久化方案提供工具处理的特定查询操作 (称为“模型和索引属性搜索提供工具”(MIPSP) 操作) 收集统计数据。如果持久化方案提供工具提供 MIPSP 操作，则 ThingWorx 将尝试使用数据库与缓存筛选策略相结合的方式基于查询参数输入来优化搜索。Postgres、MSSQL 和 Azure SQL 持久化方案提供工具可提供此类型的搜索功能。
启用查询统计数据
在“效用”子系统中启用查询统计数据。有关详细信息，请参阅效用子系统。
管理查询统计数据
执行 QueryImplementingThingsOptimized 服务时，将使用“效用”子系统上的一组服务来管理查询指标集合。这些服务在 Composer 中可用，但目前未显示在 Extension Java SDK 中。
|
详细信息
|
|
|---|---|
|
说明
|
返回所有与查询操作相关的统计数据。结果将以 UtilizationStatistics 数据形状信息表的形式提供。提供用于选择查询操作统计数据子集的筛选功能。例如，要检索 MIPSP 查询操作统计数据，可以使用 GetStatistics 服务并指定 twx.stats.query.mipsp 命名空间。  |
|
参数
|
• maxItems
◦ 要返回的项的最大数量。
◦ NUMBER 基本类型
• sortColumnName
◦ 要排序的信息表结果列字段的名称
◦ STRING 基本类型
◦ 默认值为 count
• sortAscending
◦ 排序所依据的顺序：升序或降序
◦ BOOLEAN 基本类型
◦ 默认值为 false
|
|
示例结果
|
有关详细信息，请参阅下面的解释查询统计数据。  |
|
详细信息
|
|
|---|---|
|
说明
|
写入查询统计数据。
|
|
参数
|
• fileType
◦ 要报告为 CSV 的文件类型
◦ STRING 基本类型
◦ 默认值为 csv
◦ 可接受值为 csv
• maxItems
◦ 要返回的项的最大数量。
◦ NUMBER 基本类型
• sortColumnName
◦ 要排序的信息表结果列字段的名称
◦ STRING 基本类型
◦ 默认值为 count
• sortAscending
◦ 排序所依据的顺序
◦ BOOLEAN 基本类型
◦ 默认值为 false
|
|
示例结果
|
 |
|
详细信息
|
|
|---|---|
|
说明
|
重置查询统计数据。
|
|
参数
|
不适用
|
|
结果
|
如果成功，则不会提供任何结果。
|
解释查询统计数据
如果执行搜索操作 (例如通过事物模板或事物形态 QueryImplementingThingsOptimized 服务)，则会执行 MIPSP 操作。该操作包括在名为 mipsp 的根查询统计数据命名空间的子节点下捕获统计数据。
任何前缀为 twx.stats.query.mipsp 的统计数据均表示在 MIPSP 操作期间收集指标。
执行 QueryImplementingThingsOptimized 服务时，MIPSP 查询统计数据提供以下统计数据子节点。此 "name key sub-nodes" 提供的每个统计数据均提供最小、最大、平均计时以及计数，这将通过多次调用指定功能来解析各个列中提供的值。发生其他调用时，会更新每个统计数据的 "name key"，以反映 GetQueryStatistics 服务的请求的新值。
|
子节点
|
父节点
|
完整路径
|
详细信息
|
|---|---|---|---|
|
supportdetermination
|
mipsp
|
twx.stats.query.mipsp.supportdetermination
|
提供统计数据，用于确定如何根据所提供的参数优化和支持查询。
例如，如果将 namemask 参数作为输入参数提供给查询，则此 supportdetermination 功能将确定其是否支持 namemask 参数。Namemask 的 supportdetermination 结果将为平台提供输入，以确定如何优化所请求的查询。
统计数据将指示所花费的时间以及通过此功能针对查询参数输入的各种排列执行 supportdetermination 功能的次数。
|
|
interrogate
|
mipsp
|
twx.stats.query.mipsp.interrogate
|
提供了一些统计数据，用于询问持久化方案提供工具，其所提供的搜索功能类型。
例如，如果提供 namemask 参数，则持久化方案提供工具将询问其是否支持该搜索功能。
|
|
searchthingnames
|
db
|
twx.stats.query.mipsp.db.searchthingnames
|
为确定使用数据库的任何操作提供统计数据，以搜索符合搜索参数的事物名称，进而优化搜索。
|
|
searchthingnames.buildquery
|
searchthingnames
|
twx.stats.query.mipsp.db.searchthingnames.buildquery
|
提供用于构建 SQL 查询以执行事物名称数据库搜索所需的统计数据。
此指标的最小、最大、平均时间和计数是构建 searchthingnames 操作查询功能特定且唯一的统计数据。但是，twx.stats.query.mipsp.db.searchthingnames 提供的 searchthingnames 统计数据包括 buildquery 统计数据的统计，如下所示：
其中，A = "twx.stats.query.mipsp.db.searchthingnames"
且 B = "twx.stats.query.mipsp.db.searchthingnames.buildquery"。
则 A - B = C，其中 C 不包括 searchthingnames 的 buildquery 部分的计数/计时。C 包括执行数据库查询的计数和计时，但不包括用于构建在 searchthingnames 操作期间针对数据库执行的 SQL 查询的计数和计时。
|
|
getpropertyvtqcount
|
db
|
twx.stats.query.mipsp.db.getpropertyvtqcount
|
为 buildquery 和 buildfilter 参数的子统计数据提供统计指标、父项指标和聚合指标。统计计数和计时包括其任何子统计的计时和计数值。
|
|
getpropertyvtqcount.buildquery
|
getpropertyvtqcount
|
twx.stats.query.mipsp.db.getpropertyvtqcount.buildquery
|
此统计与 twx.stats.query.mipsp.db.searchthingnames 类似，但这是指 UtilizationSubsystem 上的 getpropertyvtqcount 服务，而不是 searchthingnames 操作。
GetPropertyVTQCount 服务用于 ThingWorx 平台中的“打电话回家”功能。在每次报告期间，它都会调用此 API 来检索欲在“打电话回家”指标内报告的统计数据。如果打电话回家期间导致一次指标收集来报告自 twx.stats.query 指标重置后这段时间内的打电话回家计数，则重置后，您甚至可能会看到两个或多个计数。
|
|
getpropertyvtqcount.buildFilters
|
getpropertyvtqcount
|
twx.stats.query.mipsp.db.getpropertyvtqcount.buildfilters
|
将用于处理筛选器和筛选器集合查询输入的统计数据收集到内部构造中，以构建检索 property_vtq 计数数据的 SQL 查询。这些最小和最大时间值包括通过复杂嵌套式筛选器集合查询分别构建简单查询筛选器。
|