![]() |
以下是存储为字符串基本类型:DATETIM、THINGNAME、USERNAME、GROUPNAME、HYPERLINK、IMAGELINK、MASHUPNAME、MENUNAME、DASHBOARDNAME、TEXT、GUID、NOTIFICATIONCONTENTNAME、NOTIFICATIONDEFINITIONNAME、STYLETHEMENAME 和 THINGGROUPNAME。
|
![]() |
始终不应该为遥测数据建立索引。
|
属性名称
|
属性类型
|
是否支持索引查询?
|
---|---|---|
name
|
STRING
|
是
|
description
|
STRING
|
是
|
tags
|
TAGS
|
是
|
isSystemObject
|
BOOLEAN
|
否
|
homeMashup
|
STRING
|
否
|
avatar
|
IMAGE
|
否
|
projectName
|
STRING
|
否
|
thingTemplate
|
STRING
|
是
|
操作名称
|
注解
|
可能的优化状态 (在请求中提供且非空时)
|
||
---|---|---|---|---|
ResultDefinition
|
通过 API 调用上的 basicPropertyNames 和 propertyNames 参数指定。
• basicPropertyNames - 要返回的基本属性的列表。
• propertyNames - 内置和实现要返回的实体属性的列表。
|
• 如果请求的所有属性定义均已建立索引,QueryImplementingThingsOptimized 将运行索引查询以生成结果集。
• 如果请求的某些属性定义已建立索引且支持该操作,QueryImplementingThingsOptimized 将针对索引属性运行索引查询,然后使用该结果集查询内存缓存中的非索引属性。
• 如果请求的任何属性定义均未建立索引或参数为 NULL,QueryImplementingThingsOptimized 将查询内存缓存。
|
||
NameMask
|
与事物名称匹配的类似掩码的模式。
|
NameMask 对于 QueryImplementingThingsOptimized 是否使用索引查询没有任何影响。
|
||
NetworkName
|
给定实现事物必须属于的网络名称。可提供提示。例如,您可以提供网络最大深度和父网络名称,以帮助缩小搜索范围。
|
QueryImplementingThingsOptimized 将对内存缓存进行查询。
|
||
Tags
|
必须将实体标记为要包括在结果中的标记列表。
|
QueryImplementingThingsOptimized 将使用索引查询进行标记。
|
||
Offset
|
开始查询偏移,用于分页。例如,如果数据库中有 200 个结果,偏移量为 5,则会返回结果 5 至 200 (总计 195 个结果)。
|
偏移对于 QueryImplementingThingsOptimized 是否使用索引查询没有任何影响。
|
||
Sort
|
要应用于最终结果的排序。
|
• 如果在排序中定义的所有属性均已建立索引,QueryImplementingThingsOptimized 将运行索引查询以生成结果集。
• 如果排序中的某些属性未建立索引,QueryImplementingThingsOptimized 将对内存缓存进行查询。
|
||
Query
|
要应用于结果记录的筛选器。
|
• 如果请求的所有属性定义均已建立索引,QueryImplementingThingsOptimized 将运行索引查询以生成结果集。
• 如果请求的某些属性定义已建立索引且支持该操作,QueryImplementingThingsOptimized 将针对索引属性运行索引查询,然后使用该结果集查询内存缓存中的非索引属性。
• 如果请求的所有属性定义均未建立索引,QueryImplementingThingsOptimized 将查询内存缓存。
|
||
Limit
|
要包括在结果中的项的最大数量。
|
Limit 对于 QueryImplementingThingsOptimized 是否使用索引查询没有任何影响。
|
提示
|
是否必需?
|
默认
|
操作
|
---|---|---|---|
optimizationDisabled
|
否
|
不包括
|
• 如果未指定查询、查询中不包括提示或提示为 false,QueryImplementingThingsOptimized 将尝试按如上所述进行查询。
|
实体名称
|
实体类型
|
实现
|
属性名称
|
属性类型
|
属性已索引?
|
---|---|---|---|---|---|
TestThingTemplate1
|
ThingTemplate
|
GenericThing
|
p1
|
INTEGER
|
是
|
p2
|
STRING
|
是
|
|||
p3
|
INTEGER
|
否
|
|||
p4
|
STRING
|
否
|
|||
TestThing1
|
Thing
|
TestThingTemplate1
|
继承的
|
继承的
|
继承的
|
TestThing2
|
Thing
|
TestThingTemplate1
|
继承的
|
继承的
|
继承的
|
情景
|
示例
|
已使用索引查询?
|
备注
|
---|---|---|---|
支持所有操作,且完全支持筛选。
|
{"sorts":[{"fieldName":"p1"}],"filters":{"type":"And","filters":[{"type":"EQ","fieldName":"p2","value":"12"},
{"type":"EQ","fieldName":"p1","value":"13"}]}} |
是
|
仅查询索引属性,因此这将使用索引查询。
|
支持所有操作,且部分支持筛选。
|
{"sorts":[{"fieldName":"p1"}],
"filters":{"type":"And","filters":[{"type":"EQ","fieldName":"p4","value":"12"},{"type":"EQ","fieldName":"p1","value":"13"}]}} |
是
|
ThingWorx 将为属性 P1 运行索引查询,然后对该结果集上的 P4 进行缓存查询。
|
支持所有操作,但不支持筛选。
|
{"sorts":[{"fieldName":"p1"}],"filters":
{"type":"Or","filters":[{"type":"EQ","fieldName":"p4","value":"12"},{"type":"EQ","fieldName":"p1","value":"13"}]}} |
否
|
由于使用 OR 筛选器,ThingWorx 将完全执行缓存查询,因此索引查询无法提供任何优势。
|
支持所有操作,无过滤器。
|
{"sorts":[{"fieldName":"p1"}]}
|
否
|
没有要过滤的内容,因此不会执行查询。
|
支持某些操作,且完全支持筛选。
|
{"sorts":[{"fieldName":"p4"}],"filters":{"type":"And","filters":
[{"type":"EQ","fieldName":"p2","value":"12"},{"type":"EQ","fieldName":"p1","value":"13"}]}} |
是
|
将对所有筛选字段进行索引,因此,该查询将使用索引查询。
|
支持某些操作,且部分支持筛选。
|
{"sorts":[{"fieldName":"p4"}],"filters":{"type":"And","filters":
[{"type":"EQ","fieldName":"p4","value":"12"},{"type":"EQ","fieldName":"p1","value":"13"}]}} |
是
|
除了对非索引属性进行排序外,这与第 2 行中的示例相同。
|
支持某些操作,不支持筛选。
|
{"sorts":[{"fieldName":"p4"}],"filters":{"type":"Or","filters":[{"type":"EQ","fieldName":"p4","value":"12"},
{"type":"EQ","fieldName":"p1","value":"13"}]}} |
否
|
筛选器与第 3 行中的示例相同,因此,该查询不支持索引查询。
|
支持某些操作,未提供筛选器。
|
{"sorts":[{"fieldName":"p4"}]}
|
否
|
没有要筛选的内容,因此不支持此操作。
|
查询标记,但未提供筛选器。
|
是
|
标记查询支持索引查询。
|