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
<a name="query-syntax"></a>

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

## Funzionalità supportate
<a name="supported-query-syntax"></a>

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 *\$1*)
+ L'uso principale dei caratteri jolly è limitato a 1 termine di query per query. Ad esempio, non è possibile cercare «`thingName:*my`e» `thingGroupNames:*echo` nella stessa query. Le interrogazioni che includono un carattere jolly iniziale hanno una lunghezza massima di 100 caratteri.
**Nota**  
 Gli account con un limite API di query Fleet Indexing superiore a 30 richieste al secondo sono soggetti a limitazioni quando utilizzano i termini di query principali con wildcard. Questo requests-per-second limite di 30 si applica a livello di account per tutte le query di Fleet Indexing. APIs 

## Caratteristiche non supportate
<a name="unsupported-query-syntax"></a>

La sintassi di query non supporta le seguenti caratteristiche:
+ Espressioni regolari
+ Aumento priorità
+ Classificazione
+ Ricerche fuzzy
+ Ricerca per prossimità
+ Ordinamento
+ Aggregazione
+ Caratteri speciali: ```, `@`, `#`, `%`, `\`, `/`, `'`, `;` e `,`. Tieni presente che `,` è supportato solo nelle geoquery.

## Note
<a name="query-syntax-limitations"></a>

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.