Sintassi delle query - AWS IoT Core

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 ANDORNOT 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 query per query. Ad esempio, non è possibile cercare «thingName:*mythingGroupNames:*echo nella stessa query. Le interrogazioni che includono un carattere jolly iniziale hanno una lunghezza massima di 100 caratteri.

    Nota

    Se hai concesso un aumento elevato del limite per l'indicizzazione della flotta APIs, potresti non essere in grado di utilizzare la funzione jolly principale per quelle specifiche APIs finché il limite non viene ridotto.

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 , è supportata 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 non viene specificato un campo, AWS IoT cerca il termine in tutti i campi del Registro di sistema, 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.