

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

En la indexación de flotas, se utiliza una sintaxis de consulta para especificar las consultas.

## Características admitidas
<a name="supported-query-syntax"></a>

La sintaxis de consulta es compatible con las siguientes características.
+ Términos y frases
+ Búsqueda de campos
+ Búsqueda de prefijos
+ Búsqueda de intervalos
+ Operadores booleanos `AND`, `OR`, `NOT` y `–`. El guion se utiliza para excluir algo de los resultados de la búsqueda (por ejemplo, `thingName:(tv* AND -plasma)`).
+ Agrupación
+ Agrupación de campos
+ Utilizar secuencias de escape con caracteres especiales (por ejemplo, con *\$1*)
+ El uso de caracteres comodín al principio está limitado a un término de consulta por consulta. Por ejemplo, no puede buscar `thingName:*my` ni `thingGroupNames:*echo` en la misma consulta. Las consultas que incluyen un carácter comodín al principio tienen una longitud máxima de 100 caracteres.
**nota**  
 Las cuentas con un límite de consultas en la API de indexación de flotas superior a 30 solicitudes por segundo están sujetas a restricciones cuando se utilizan los primeros términos de consulta con caracteres comodín. Este requests-per-second límite de 30 se aplica a nivel de cuenta en todas las consultas de indexación de Fleet. APIs 

## Características no admitidas
<a name="unsupported-query-syntax"></a>

La sintaxis de consulta no es compatible con las siguientes características:
+ Expresiones regulares
+ Impulso
+ Clasificación
+ Búsquedas confusas
+ Búsqueda de proximidad
+ Ordenar
+ Agregación
+ Caracteres especiales: ```, `@`, `#`, `%`, `\`, `/`, `'`, `;` y `,`. Tenga en cuenta que `,` solo se admite en las geoconsultas.

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

Algunas cosas que tener en cuenta acerca del idioma de consulta:
+ El operador predeterminado es AND. La consulta `"thingName:abc thingType:xyz"` es igual que `"thingName:abc AND thingType:xyz"`.
+ Si no se especifica ningún campo, AWS IoT busca el término en todos los campos del registro, Device Shadow y Device Defender.
+ Todos los nombres de campo distinguen entre mayúsculas y minúsculas.
+ La búsqueda distingue entre mayúsculas y minúsculas. Las palabras están separadas por caracteres de espacio en blanco, tal como define la especificación `Character.isWhitespace(int)` de Java.
+ La indexación de los datos de Device Shadow (sombras sin nombre y sombras con nombre) incluye las secciones reported, desired, delta, y de metadatos.
+ Las versiones de Device Shadow y del registro no permiten búsquedas, pero están presentes en la respuesta.
+ El número máximo de términos en una consulta es 12.
+ El carácter especial `,` solo se admite en las geoconsultas.