使用搜索

管理门户提供了一系列丰富的搜索选项，可用于搜索 物（物）、连接（连接）和 触发器（触发器）。顶部导航搜索工具允许您对物联网设备管理门户进行搜索，或根据类型对搜索进行过滤。

搜索功能让您能够找到与查询字符串匹配的特定物/连接/触发器或一组物/连接/触发器。输入与物/连接/触发器相关的完整文本，即可找到对应的物/连接/触发器，或使用通配符、逻辑运算符和高级搜索运算符优化搜索条件。  例如，您可以输入物的名称、连接的 ICCID 或键值，或者使用带有命名参数的逻辑运算符进行更复杂的查询，如 name:Thing OR key:thing OR msisdn:566* OR carrier:AT&T，此时将会用输入的参数执行搜索。

使用逻辑运算符创建更复杂的搜索表达式，优化搜索条件。下表列出了搜索查询中使用的多种搜索词和格式：

逻辑运算符 AND（和）、OR（或）和 NOT（非）必须显式指定，并且必须以大写字母表示。

物联网设备管理门户 使用索引加快搜索运算。在搜索运算过程中，服务器会使用索引Closed索引是服务器用于高效查找与查询字符串匹配的条目的一种机制。查找与搜索关键字匹配的条目。如果未配置索引，则服务器在查找潜在的搜索匹配项时必须检查服务器中的每个条目。为了提高搜索效率，每个物最多只能有 32 个属性、32 个告警和 32 个静态属性。如果超过了允许的上限，则该属性、告警或静态属性不会被编入索引且无法搜索。

 

对包含大整数值（2^63 和更大）的 64 位无符号整数字段进行物搜索，可能导致结果异常。

单击顶部导航中的搜索图标，启用过滤器并输入查询字符串。下表列出了一些查询字符串示例。

查询字符串 Result
name:thing 所有名称中包含“thing”这个完整词的物。例如，“My thing”会返回，但“mything”不会返回。
key:thing

所有键值为 thing 的物

要通过“Search”（搜索）功能查找静态属性键设置为特定值的所有物/连接，前提条件是该静态属性必须为“searchable”（可搜索）。
只有在静态属性设置为 searchable=true 之后更新的数据（带有新值的条目）才会被找到；而在静态属性为 searchable=true 之前更新的数据仍然无法找到。在这种情况下，需要采取变通方案。
name:*thing* 所有名称中包含 thing 的物。例如，“The thing”、“thethingdevice”、“thing1”都会返回。
name:thing* 所有名称开头为 thing 这个完整词的物。例如，“The thing”和“thing1”会返回，但“thething”不会返回。
name:thing? 所有名称开头为 thing，并且名称中还有正好一个字符的 Things（物），如：thinga、thing1、things 等。
(name:*thing*) OR (NOT name:*thing2*) 即支持常用的布尔运算符 AND（和）、OR（或）和 NOT（非）（也可以写作 &&、|| 和 !），但请注意，此处不遵循通常的优先规则，因此当同时使用多个运算符时，应使用括号。
key:???th_thing 所有名称结尾为 th_thing，并且键值开头还有正好三个字符的物，如：north_thing、south_thing、120th_thing 等。
lastSeen:>2018-04 所有上次在线时间在 2018 年 4 月之后的物
lastSeen:<2018-04 所有上次在线时间在 2018 年 4 月之前的物
connected:true 所有已连接的物
hasTunnels:true 所有拥有隧道的物。有关隧道的更多信息，请参见隧道。
alarms.connected.state:1 所有已连接告警，且其当前状态为 1 的物
properties.speed.value:14 所有具有属性 *speed*，且其当前数值为 14 的物
iccid:89015648812410425618 所有 ICCID 为“89015648812410425618”的连接
imei:*8901* 所有 IMEI 中包含 “8901”的连接
msisdn:566* 所有 MSISDN 开头为 “566”的连接
lastSync.session:>2019-04 所有自 2019 年 4 月以来同步过的连接
touchedOn:<2019-04 所有 2019 年 4 月之前接触/修改过的连接
<idField>:9999999999999999 以此为唯一 ID 的物。<idField> 可以更换为 id、esn、iccid、imei、imsi、meid 或 msisdn。例如：iccid:8711260741224338000、imei:358883046458854、msisdn:2487495423
<idField>:(9999999999999999 OR 9999999999999998 OR 0000000000000001) 匹配其中任何一个 ID 的物。逻辑运算符 OR（或）不可缺。<idField> 可以更换为 id、esn、iccid、imei、imsi、meid 或 msisdn。例如：iccid:(357043043327371, 358883046458854, 358883046458855)
field.key.value:"2019-06-06" 所有日期字符串数值为 2019-06-06 的物/连接/触发器。双引号不可缺，否则连字符会被视为单词定界符，在搜索中成为一个 OR（或）条件。
createdBy:"username@domainexample.com" 所有拥有相同 createdBy 帐号的物/连接/触发器。双引号不可缺，否则 @ (at) 符号会被视为单词定界符，在搜索中成为一个 OR（或）条件。同样适用于 updatedBy。
term1 AND term2 所有匹配 term1 AND（和） term2 的物/连接/触发器
term1 OR term2 所有匹配 term1 OR（或） term2 的物
lastSeen:>2019-03 AND lastSeen:<2019-04 所有上一次在线时间是在 2019 年 3 月当月的物
NOT attrs.attrkey.value:* 所有该静态属性的键值没有设置为数值的物/连接。例如：'NOT attrs.ip_address.value:*’ 不会列出 ip_address 静态属性设置为数值的物。
定界符
"term1-term2" 词内定界符，即所有非字母数字的字符（逗号、特殊字符、连字符、句号等）都是定界符。例如，“Wi-Fi” → “Wi”、“Fi” 
"Term1Term2" 大小写区分时的定界符。例如，“PowerShot” → “Power”、“Shot”
"term100" 字母-数字定界符。例如，“SD500” → “SD”、“500” 
"//term1—term2, term3" 词内定界符前后的定界符会被忽略。例如，“//hello---my, example” → “hello”、“my”、“example” 
"Term's" 每个单词后接的“s”会被忽略。例如，“O’Neil’s” → “O”、“Neil”

未显式指定字段的情况下，可以搜索以下关键字：id、orgId、boundTo、name、key、sessionId、serverId、defId、defKey、defName、iccid、esn、meid、imsi、msisdn、secTags、tags、locWithin、lwm2m.endpoint、lwm2m.identity、lwm2m.bsIdentity、lwm2m.profileId、lwm2m.path 和 lwm2m.remoteAddr

例如，能够以 abc123 为关键字搜索物键值 ABC123，但不能以 abc123 为关键字搜索静态属性 myattr，而是必须使用 attr.myattry.value:abc123。

构造查询时可以使用以下字段。

  • alarms.alarmkey.state
  • alarms.alarmkey.ts
  • alarms.alarmkey.msg
  • alarms.alarmkey.state
  • alarms.alarmkey.ts
  • alarms.alarmkey.msg
  • apiCounts.daily
  • apiCounts.monthToDate
  • apiCounts.total
  • attrs.attributekey.ts
  • attrs.attributekey.value
  • billingPlanCode
  • boundTo
  • createdBy
  • createdOn
  • defId
  • defKey
  • defName
  • desc
  • esn
  • gateway.appVersion
  • gateway.dwPlatform
  • gateway.dwProduct
  • gateway.dwVersion
  • gateway.make
  • gateway.model
  • gateway.remShell
  • iccid
  • id
  • imei
  • imsi
  • key
  • lastSeen
  • loc.addr.city
  • loc.addr.country
  • loc.addr.state
  • loc.addr.street
  • loc.addr.streetNumber
  • loc.addr.zipCode
  • loc.altitude
  • loc.fixAcc
  • loc.fixType
  • loc.heading
  • loc.lat
  • loc.lng
  • loc.speed
  • locEnabled
  • locUpdated
  • locWithin
  • meid
  • module.fwVersion
  • module.iccid
  • module.imei
  • module.imsi
  • module.lastUpdated
  • module.make
  • module.mcc
  • module.mnc
  • module.model
  • module.network
  • module.packetService
  • module.remAt
  • module.rscp
  • module.rssi
  • name
  • orgId
  • properties.propertykey.ts
  • properties.propertykey.value
  • secTags
  • sessionId
  • tags
  • tunnelActualHost
  • tunnelLatencies.router01
  • tunnelVirtualHost
  • updatedBy
  • updatedOn
  • vasPackageCode

构造查询时可以使用以下字段。

  • carrier
  • createdOn
  • custom1
  • custom2
  • custom3
  • custom4
  • custom5
  • customer
  • dateActivated
  • dateAdded
  • dateModified
  • esn
  • hasDataUsage
  • hasSmsUsage
  • hasVoiceUsage
  • iccid
  • id
  • imei
  • imsi
  • inSession
  • ipAddress
  • lastSync.session
  • lastSync.dataUsage
  • lastSync.smsUsage
  • lastSync.voiceUsage
  • lastSessionEnd
  • meid
  • mdn
  • msisdn
  • ratePlan
  • ratePlanId
  • secTags
  • status
  • tags
  • terminalId
  • touchedOn
  • updatedBy
  • updatedOn

构造查询时可以使用以下字段。

  • name
  • eventType
  • lastSuccess（日期/时间）
  • lastFailure（日期/时间）
  • successCount（整数）
  • failureCount（整数）
  • dailySuccessCount（整数）
  • dailyFailureCount（整数）
  • started（布尔型）
  • updatedBy
  • updatedOn