Use instrucciones similares a SQL para buscar dispositivos que cumplan criterios específicos, como los dispositivos en línea. También puede descargar una lista de los dispositivos coincidentes que incluye su ProductKey y su DeviceName.
Límites
Regiones compatibles: China (Shanghai), y Japan (Tokyo).
-
Límites de la función: La función Advanced Search no es compatible con la página en las instancias públicas.
Casos de uso
Puede usar la búsqueda avanzada en los siguientes escenarios dentro de la consola de IoT Platform:
View device information: En la pestaña Advanced Search de la página , busque y gestione dispositivos específicos.
También puede llamar a la operación de API QueryDeviceBySQL para ejecutar una búsqueda avanzada. Esta API no se limita a los escenarios de la consola mencionados.
Procedimiento
A continuación se muestran ejemplos sobre cómo usar la búsqueda avanzada en la consola de IoT Platform para agregar dispositivos a un grupo y buscarlos por modelo TSL.
Inicie sesión en la consola de IoT Platform.
En la página Overview, localice la instancia que desea gestionar y haga clic en su ID o nombre.
En el panel de navegación izquierdo, seleccione y luego haga clic en la pestaña Advanced Search.
-
En la pestaña Advanced Search, busque los dispositivos que cumplan sus criterios.
Sintaxis similar a SQL
Cuando usa la búsqueda avanzada en la consola, una instrucción similar a SQL consta de una cláusula WHERE y una cláusula ORDER BY opcional. Las cláusulas SELECT y LIMIT, así como la palabra clave WHERE en sí, se omiten. Las instrucciones tienen un límite de 400 caracteres.
Ejemplo:
product_key = "a1*****" order by active_timeCláusula WHERE
Formato:
[condition1] AND [condition2] Omita WHERE.
Puede especificar un máximo de cinco condiciones. No se admiten condiciones anidadas.
Se admiten los operadores lógicos AND y OR. Puede usar un máximo de cinco operadores lógicos por instrucción.
Cláusula ORDER BY (opcional)
Utilice la cláusula ORDER BY para ordenar los resultados. Puede ordenarlos por los campos gmt_create, gmt_modified y active_time.
Esta cláusula es opcional. Si la omite, los resultados se devuelven en un orden aleatorio.
Campos de búsqueda
|
Campo |
Tipo |
Descripción |
|
product_key |
text |
El ProductKey del producto al que pertenece el dispositivo. |
|
iot_id |
text |
El identificador del dispositivo. El campo iot_id se devuelve de forma predeterminada. |
|
name |
text |
El DeviceName del dispositivo. |
|
active_time |
date |
La hora en la que se activó el dispositivo. Se expresa en formato |
|
nickname |
text |
El alias del dispositivo. |
|
gmt_create |
date |
La hora en la que se creó el dispositivo. Se expresa en formato |
|
gmt_modified |
date |
La última vez que se actualizó el alias del dispositivo. Se expresa en formato |
|
status |
text |
El estado del dispositivo. Valores válidos:
|
|
group.group_id |
text |
El ID del grupo de dispositivos. |
|
tag.tag_name |
text |
La clave de la etiqueta. |
|
tag.tag_value |
text |
El valor de la etiqueta. |
|
ota_module.name |
text |
El nombre del módulo OTA. Use este campo junto con ota_module.version para especificar el módulo OTA que corresponde a la versión OTA actual del dispositivo. |
|
ota_module.version |
text |
La versión OTA actual del dispositivo. Use este campo junto con ota_module.name. |
Operadores
|
Operador |
Tipos de campo compatibles |
|
= |
number, date, text, keyword |
|
> |
number, date |
|
< |
number, date |
|
LIKE |
text |
El operador LIKE admite coincidencias de prefijo, pero no de sufijo ni comodines. El prefijo debe cumplir las siguientes condiciones:
El prefijo debe contener como mínimo cuatro caracteres y no puede incluir caracteres especiales, como barras invertidas (\), barras diagonales (/), signos et (&), signos más (+), guiones (-), signos de exclamación (!), paréntesis (), dos puntos (:), tildes (~), corchetes ([]), llaves ({}), asteriscos (*) ni signos de interrogación (?).
El prefijo debe terminar con
%.
Ejemplo:
product_key = "a1*********" and name LIKE "test%"API relacionada
QueryDeviceBySQL: busca dispositivos que cumplen condiciones específicas mediante instrucciones similares a SQL.