查詢統計資訊
透過使用率子系統，ThingWorx Platform 會在執行時間為查詢相關操作提供統計資訊命名空間。所有查詢相關統計資訊的根命名空間都以 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
|
|
範例結果
|
 |
|
詳細資訊
|
|
|---|---|
|
描述
|
重設查詢統計資訊。
|
|
參數
|
N/A
|
|
結果
|
如果成功，則不提供結果。
|
解讀查詢統計資訊
如果您執行搜尋操作，例如透過物範本或物形式的 QueryImplementingThingsOptimized 服務，則會執行 MIPSP 操作。作為該操作的一部份，會在名為 mipsp 的根查詢統計資訊命名空間的子節點下捕捉統計資訊。
任何加上 twx.stats.query.mipsp 前綴的統計資訊都指示 MIPSP 操作期間會收集指標。
MIPSP 查詢統計資訊提供了執行 QueryImplementingThingsOptimized 服務時，統計資訊的下列子節點。此「名稱鍵值子節點」所提供的每個統計資訊都提供最小、最大、平均計時及計數，其超過多次對已命名功能的引動，會解析為在這些欄中提供的值。發生額外的引動時，每個統計資訊的「名稱鍵值」都會更新，以反映出對 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 Platform 中的打電話回總部功能使用。針對每個報告期間，它都會呼叫此 API，以擷取在打電話回總部指標內報告的統計資訊。即使在打電話回總部期間已導致收集自 twx.stats.query 的指標重設之後的時間內向總部報告的指標，您仍可能會看到二或多個計數。
|
|
getpropertyvtqcount.buildFilters
|
getpropertyvtqcount
|
twx.stats.query.mipsp.db.getpropertyvtqcount.buildfilters
|
針對將篩選器的查詢輸入及篩選器集合處理到內部建構中以建構 SQL 查詢來擷取 property_vtq 計數資料所收集的統計資訊。這些最小與最大時間值包括分別透過複雜嵌套篩選器集合查詢建構簡單查詢篩選器。
|