IoT Platform で指定された条件に基づいて、ProductKey と DeviceName を含むデバイスリストを検索およびダウンロードする必要がある場合は、詳細検索機能を使用できます。この機能を使用すると、SQL に似たステートメントを使用して、オンラインデバイスなどのデバイスを検索できます。この記事では、詳細検索の実行方法と SQL に似た構文について説明します。
制限事項
この機能は、中国 (上海) リージョンと日本 (東京) リージョンで使用できます。
機能の制限: パブリックインスタンスの ページでは、詳細検索はサポートされていません。
シナリオ
IoT Platform コンソール では、次のシナリオで詳細検索がサポートされています。
デバイス情報の表示: [高度な検索] ページの タブで、指定されたデバイスを検索します。
QueryDeviceBySQL オペレーションを呼び出して、詳細検索を実行することもできます。API オペレーションベースの詳細検索は、上記のシナリオに限定されません。
手順
この記事では、詳細検索機能を使用してデバイスをデバイスグループに追加し、TSL モデルに基づいてデバイスを検索する方法について説明します。
- IoT Platform コンソール にログオンします。
[概要] ページで、[すべての環境] をクリックします。[すべての環境] タブで、管理するインスタンスを見つけ、インスタンス ID またはインスタンス名をクリックします。
左側のナビゲーションウィンドウで、 を選択します。[詳細検索] タブをクリックします。
[詳細検索] タブで、詳細検索機能を使用してデバイスを検索します。
SQL に似た構文
SQL に似たステートメントは、WHERE 句と ORDER BY 句 (オプション) で構成されます。SELECT 句、LIMIT 句、および WHERE 句の WHERE キーワードは省略されます。各ステートメントの長さは 400 文字を超えることはできません。
例:
product_key = "a1*****" order by active_timeWHERE 句
構文:
[condition1] AND [condition2] WHERE キーワードは省略されます。
最大 5 つの条件を指定できます。ネストはサポートされていません。詳細については、以下の表の検索フィールドと演算子を参照してください。
AND 演算子と OR 演算子を使用できます。最大 5 つの演算子を使用できます。
ORDER BY 句 (オプション)
ORDER BY 句は、ソートに使用されます。ソートできるフィールドには、gmt_create、gmt_modified、active_time があります。
この句は指定しないでおくことができます。この場合、結果はランダムにソートされます。
検索フィールド
フィールド | 型 | 説明 |
product_key | text | デバイスが属するプロダクトの ProductKey。 |
iot_id | text | デバイスの ID。デフォルトでは、iot_id が返されます。 |
name | text | デバイスの DeviceName。 |
active_time | date | デバイスがアクティブ化された時刻。時刻は yyyy-MM-dd HH:mm:ss.SSS 形式で、ミリ秒単位まで正確です。 |
nickname | text | デバイスのエイリアス。 |
gmt_create | date | デバイスが作成された時刻。時刻は yyyy-MM-dd HH:mm:ss.SSS 形式で、ミリ秒単位まで正確です。 |
gmt_modified | date | デバイスのエイリアスが最後に更新された時刻。時刻は yyyy-MM-dd HH:mm:ss.SSS 形式で、ミリ秒単位まで正確です。 |
status | text | デバイスのステータス。有効な値:
|
group.group_id | text | デバイスグループの ID。 |
tag.tag_name | text | デバイスのタグキー。 |
tag.tag_value | text | デバイスタグの値。 |
ota_module.name | text | OTA モジュールの名前。 このフィールドは、ota_module.version と一緒に使用して、デバイスの現在の OTA バージョン番号に対応する OTA モジュールを指定することをお勧めします。 |
ota_module.version | text | デバイスの現在の OTA バージョン番号。 このフィールドは、ota_module.name と一緒に使用することをお勧めします。 |
演算子
演算子 | サポートされているデータ型 |
= | 数値、日付、テキスト、キーワード |
> | 数値と日付 |
< | 数値と日付 |
LIKE | text |
LIKE はプレフィックスマッチングをサポートしますが、サフィックスマッチングまたはワイルドカードマッチングはサポートしません。プレフィックスは次の要件を満たしている必要があります。
プレフィックスは 4 文字以上で、バックスラッシュ (\)、スラッシュ (/)、アンパサンド (&)、プラス記号 (+)、ハイフン (-)、感嘆符 (!)、括弧 ()、コロン (:)、チルダ (~)、角括弧 []、中括弧 {}、アスタリスク (*)、疑問符 (?) などの特殊文字を含めることはできません。
プレフィックスはパーセント記号 (
%) で終わる必要があります。
例:
product_key = "a1*********" and name LIKE "test%"