Sintaxis de la consulta - AWS IoT Core
Características admitidasCaracterísticas no admitidasNotas

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

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

Características admitidas

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 \)

  • 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

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

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.