View a markdown version of this page

Sintassi delle query - AWS IoT Core
Funzionalità supportateCaratteristiche non supportateNote

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Sintassi delle query

Nell'indicizzazione del parco istanze, si utilizza una sintassi di query per specificare le query.

Funzionalità supportate

La sintassi di query supporta le seguenti caratteristiche:

  • Termini e frasi

  • Ricerca nei campi

  • Ricerca di prefissi

  • Ricerca di intervalli

  • Operatori booleani AND, OR, NOT e –. Il trattino viene utilizzato per escludere qualcosa dai risultati di ricerca (ad esempio, thingName:(tv* AND -plasma)).

  • Raggruppamento

  • Raggruppamento di campi

  • Caratteri di escape speciali (come con \)

  • L'uso principale dei caratteri jolly è limitato a 1 termine di interrogazione per query. Ad esempio, non è possibile cercare thingName:*my e thingGroupNames:*echo nella stessa query. Le query che includono un carattere jolly iniziale hanno una lunghezza massima di 100 caratteri.

    Nota

    Gli account con un limite API di interrogazione Fleet Indexing superiore a 30 richieste al secondo sono soggetti a limitazioni quando si utilizzano termini di query con caratteri primari. Questo limite di 30 richieste al secondo si applica a livello di account per tutte le API di query di Fleet Indexing.

Caratteristiche non supportate

La sintassi di query non supporta le seguenti caratteristiche:

  • Espressioni regolari

  • Aumento priorità

  • Classificazione

  • Ricerche fuzzy

  • Ricerca per prossimità

  • Ordinamento

  • Aggregazione

  • Caratteri speciali: `, @, #, %, \, /, ', ; e ,. Nota che è supportato solo nelle geoquery. ,

Note

Alcune note relative al linguaggio di query:

  • L'operatore predefinito è AND. Una query per "thingName:abc thingType:xyz" equivale a "thingName:abc AND thingType:xyz".

  • Se un campo non è specificato, AWS IoT cerca il termine in tutti i campi del registro, Device Shadow e Device Defender.

  • Tutti i nomi di campo fanno distinzione tra maiuscole e minuscole.

  • La ricerca non fa distinzione tra maiuscole e minuscole. Le parole sono separate da spazi come definito dal metodo di Java Character.isWhitespace(int).

  • L'indicizzazione di dati Device Shadow (shadow senza nome e shadow con nome) include le sezioni reported, desired, delta e metadata.

  • Non è possibile eseguire ricerche nelle versioni Device Shadow e del registro dei dispositivi, ma queste sono presenti nella risposta.

  • Il numero massimo di termini in una query è 12.

  • Il carattere speciale , è supportato solo nelle geoquery.