用好设备查询，轻松管理上千台物联网设备

什么是设备查询？

设备查询是 ThingsCloud 内置的设备查询引擎，支持通过设备属性对设备进行动态查询。您可以使用 SQL 风格的查询语句来描述设备属性值的匹配条件，从而快速找到符合条件的设备。

就像这样：

temperature > 25 and alarm_state = true

以上查询语句表示查询温度属性 temperature 大于 25 摄氏度，且告警属性 alarm_state 为 ON 的设备。

设备查询是非常重要的设备管理工具，当您在项目中管理的设备不断增多，用好设备查询，可以大大提升设备管理效率。

如何使用设备查询

在设备列表中使用设备查询

在 ThingsCloud 控制台的设备列表中，打开设备查询对话框，如下图：

在查询条件中，可以输入 SQL 风格的条件语句，如下图：

在设备列表中，设备查询还可以和其它设备筛选条件组合使用，例如：设备在线状态、设备类型、设备组、设备活跃时间等。

保存设备查询

您可以将查询语句保存为设备查询，并管理多个设备查询，在使用的时候直接选择。

管理设备查询

进入控制台的 设备 > 设备查询，可以看到所有保存的设备查询，如下图：

点击一个设备查询，便可以进入查看当前符合查询条件的所有设备。

查询条件示例

可以说，要想熟练使用设备查询，关键在于能否写出正确的查询语句，好在这并不难，相信您很快就可以掌握。

这一部分我们通过一系列的示例，带您快速熟悉一些常用的查询语句写法。

• 查询温度大于 25 摄氏度的设备。

temperature > 25 

• 查询温度大于 25 摄氏度，并且湿度小于 45% 的设备。

temperature > 25 and humidity < 45

• 查询温度大于 25 摄氏度，或者湿度小于 45% 的设备。

temperature > 25 or humidity < 45

• 查询温度大于 25 摄氏度或者湿度小于 45%，同时土壤EC值小于 1.2 的设备。

(temperature > 25 or humidity < 45) and soil_ec < 1.2

• 查询温度大于或等于另一个属性 temp_max 值的设备。

temperature >= temp_max

• 查询温度大于 25 摄氏度，并且温度属性值在今天有更新。

temperature > 25 and temperature.ts > time("day")

• 查询温度大于 25 摄氏度，并且温度属性值在最近 24 小时内有更新。

temperature > 25 and temperature.ts > time() - duration(24, "h")

• 查询继电器闭合，且最后更新为属性下发，且最后更新时间在最近两天以内的设备。

relay = true and relay.type = "push" and relay.ts > time() - duration(2, "d")

查询条件语法参考

请浏览文档 设备查询语法参考，了解查询条件语句中的比较运算符、逻辑运算符、属性扩展信息、内置函数。

如果您打算将物联网设备接入 ThingsCloud ，请参考 设备接入指南。