As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Sintaxe de consulta
<a name="query-syntax"></a>

Na indexação de frotas, uma sintaxe de consulta é utilizada para especificar consultas.

## Recursos compatíveis
<a name="supported-query-syntax"></a>

A sintaxe de consulta dá suporte aos seguintes atributos:
+ Termos e frases
+ Pesquisar campos
+ Pesquisa de prefixo
+ Pesquisa de intervalo
+ Operadores boolianos `AND`, `OR`, `NOT` e `–`. O hífen é usado para excluir algo dos resultados de pesquisa (por exemplo, `thingName:(tv* AND -plasma)`).
+ Agrupamento
+ Agrupamento de campos
+ Escape de caracteres especiais (tal como *\$1*)
+ O principal uso de curingas é limitado a 1 termo por consulta. Por exemplo, não é possível procurar `thingName:*my` e `thingGroupNames:*echo` na mesma consulta. As consultas que incluem um caractere curinga inicial têm um comprimento máximo de consulta de cem caracteres.
**nota**  
 Contas com um limite de API de consulta do Fleet Indexing superior a 30 solicitações por segundo estão sujeitas à limitação ao usar os principais termos de consulta curinga. Esse requests-per-second limite de 30 se aplica no nível da conta em todas as consultas APIs de indexação de frotas. 

## Atributos não compatíveis
<a name="unsupported-query-syntax"></a>

A sintaxe de consulta é compatível com os seguintes atributos:
+ Expressões regulares
+ Aumento
+ Classificação
+ Pesquisas difusas
+ Pesquisa de proximidade
+ Classificação
+ Agregação
+ Caracteres especiais: ```, `@`, `#`, `%`, `\`, `/`, `'`, `;`, e `,`. Observe que `,` só tem suporte em consultas geográficas.

## Observações
<a name="query-syntax-limitations"></a>

Alguns comentários sobre a linguagem de consulta:
+ O operador padrão é AND. Uma consulta de `"thingName:abc thingType:xyz"` é equivalente a `"thingName:abc AND thingType:xyz"`.
+ Se um campo não for especificado, AWS IoT pesquisa o termo em todos os campos Registry, Device Shadow e Device Defender.
+ Todos os nomes de campos diferenciam maiúsculas de minúsculas.
+ A pesquisa não diferencia maiúsculas de minúsculas. As palavras são separadas por caracteres de espaço em branco, conforme definido pelo `Character.isWhitespace(int)` de Java.
+ A indexação de dados de sombra do dispositivo (sombras sem nome e sombras nomeadas) inclui as seções relatadas, desejadas, delta e metadados.
+ As versões da sombra do dispositivo e registro não são pesquisáveis, mas estão presentes na resposta.
+ O número máximo de termos em uma consulta é doze.
+ O caractere especial `,` só tem suporte em consultas geográficas.