クエリー統計
ThingWorx Platform は、利用率サブシステムを介して、ランタイムでのクエリー関連操作の統計名前空間を提供します。すべてのクエリー関連統計のルート名前空間には twx.stats.query というプレフィックスが付きます。永続化プロバイダによって処理される、MIPSP (Model and Indexed Property Search Provider) 操作と呼ばれる特定のクエリー操作に関する統計が収集されます。永続化プロバイダが 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
|
|
結果の例
|
 |
|
詳細
|
|
|---|---|
|
説明
|
クエリー統計をリセットします。
|
|
パラメータ
|
該当なし
|
|
結果
|
成功した場合、結果は提供されません。
|
クエリー統計の解釈
Thing Template や Thing Shape の 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
|
サーチを最適化するためにデータベースを使用して、サーチパラメータと一致する Thing 名をサーチすることが指定されている操作の統計を提供します。
|
|
searchthingnames.buildquery
|
searchthingnames
|
twx.stats.query.mipsp.db.searchthingnames.buildquery
|
Thing 名のデータベースサーチを実行するために必要な SQL クエリーを構築するための統計を提供します。
この判定基準の最小、最大、平均の時間および数は、searchthingnames 操作の buildquery 機能に固有かつ一意の統計です。ただし、 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 と似ていますが、searchthingnames 操作ではなく、利用率サブシステム上の getpropertyvtqcount サービスの統計です。
ThingWorx Platform 内のフォンホーム機能では GetPropertyVTQCount サービスが使用されます。レポート期間ごとに、この API が呼び出されて、フォンホーム判定基準でレポートする統計が取得されます。フォンホーム期間が原因で twx.stats.query の判定基準がリセットされた後の時間内にホームをレポートする判定基準が収集された場合、リセットの後も 2 つ以上の数が表示されることがあります。
|
|
getpropertyvtqcount.buildFilters
|
getpropertyvtqcount
|
twx.stats.query.mipsp.db.getpropertyvtqcount.buildfilters
|
property_vtq 数データを取得する SQL クエリーを構築する内部コンストラクトへのフィルタとフィルタコレクションのクエリー入力を処理するために収集される統計。これらの最小時間と最大時間の値には、それぞれ、複雑なネストされたフィルタコレクションクエリーによる単純なクエリーフィルタの構築が含まれています。
|