Utilisez des instructions de type SQL pour rechercher des appareils répondant à des critères spécifiques, tels que les appareils en ligne, et téléchargez la liste des appareils correspondants incluant leur ProductKey et leur DeviceName.
Limites
Régions prises en charge : Chine (Shanghai), , et Japon (Tokyo).
-
Limites de fonctionnalité : La fonctionnalité Advanced Search n'est pas prise en charge sur la page pour les instances publiques.
Cas d'utilisation
Vous pouvez utiliser la recherche avancée dans les scénarios suivants depuis la console IoT Platform :
Consulter les informations sur les appareils : Dans l'onglet Advanced Search de la page , recherchez et gérez des appareils spécifiques.
Vous pouvez également appeler l'opération API QueryDeviceBySQL pour effectuer une recherche avancée. Cette API n'est pas limitée aux scénarios de la console.
Procédure
Les exemples suivants illustrent l'utilisation de la recherche avancée dans la console IoT Platform pour ajouter des appareils à un groupe et rechercher des appareils par modèle TSL.
Connectez-vous à la console IoT Platform.
Sur la page Overview, localisez l'instance à gérer et cliquez sur son ID ou son nom.
Dans le volet de navigation de gauche, sélectionnez , puis cliquez sur l'onglet Advanced Search.
-
Dans l'onglet Advanced Search, recherchez les appareils correspondant à vos critères.
Syntaxe de type SQL
Lorsque vous utilisez la recherche avancée dans la console, une instruction de type SQL se compose d'une clause WHERE et d'une clause ORDER BY facultative. Les clauses SELECT et LIMIT, ainsi que le mot-clé WHERE lui-même, sont omis. Les instructions sont limitées à 400 caractères.
Exemple :
product_key = "a1*****" order by active_timeClause WHERE
Format :
[condition1] AND [condition2] Omettez le mot-clé WHERE.
Vous pouvez spécifier un maximum de cinq conditions. Les conditions imbriquées ne sont pas prises en charge.
Les opérateurs logiques AND et OR sont pris en charge. Vous pouvez utiliser un maximum de cinq opérateurs logiques par instruction.
Clause ORDER BY (facultative)
Utilisez la clause ORDER BY pour trier les résultats. Vous pouvez effectuer le tri selon les champs gmt_create, gmt_modified et active_time.
Cette clause est facultative. Si elle est omise, les résultats sont renvoyés dans un ordre aléatoire.
Champs recherchables
|
Champ |
Type |
Description |
|
product_key |
text |
Le ProductKey du produit auquel l'appareil appartient. |
|
iot_id |
text |
L'identifiant de l'appareil. Le champ iot_id est renvoyé par défaut. |
|
name |
text |
Le DeviceName de l'appareil. |
|
active_time |
date |
L'heure d'activation de l'appareil. L'heure est au format |
|
nickname |
text |
L'alias de l'appareil. |
|
gmt_create |
date |
L'heure de création de l'appareil. L'heure est au format |
|
gmt_modified |
date |
L'heure de la dernière mise à jour du surnom de l'appareil. L'heure est au format |
|
status |
text |
L'état de l'appareil. Valeurs possibles :
|
|
group.group_id |
text |
L'ID du groupe d'appareils. |
|
tag.tag_name |
text |
La clé du tag. |
|
tag.tag_value |
text |
La valeur du tag. |
|
ota_module.name |
text |
Le nom du module OTA. Utilisez ce champ avec ota_module.version pour spécifier le module OTA correspondant à la version OTA actuelle de l'appareil. |
|
ota_module.version |
text |
La version OTA actuelle de l'appareil. Utilisez ce champ avec ota_module.name. |
Opérateurs
|
Opérateur |
Types de champs pris en charge |
|
= |
number, date, text, keyword |
|
> |
number, date |
|
< |
number, date |
|
LIKE |
text |
L'opérateur LIKE prend en charge la correspondance de préfixe mais ne prend pas en charge la correspondance de suffixe ou les caractères génériques. Le préfixe doit respecter les conditions suivantes :
Le préfixe doit contenir au moins quatre caractères et ne doit comporter aucun caractère spécial, tel que les barres obliques inverses (\), les barres obliques (/), les esperluettes (&), les signes plus (+), les traits d'union (-), les points d'exclamation (!), les parenthèses (), les deux-points (:), les tildes (~), les crochets ([]), les accolades ({}), les astérisques (*) et les points d'interrogation (?).
Le préfixe doit se terminer par
%.
Exemple :
product_key = "a1*********" and name LIKE "test%"API connexe
QueryDeviceBySQL : recherche des appareils répondant à des conditions spécifiées à l'aide d'instructions de type SQL.