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

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

    Si ha concedido un aumento del límite máximo para las API de indexación de flota, es posible que no pueda utilizar la característica de carácter comodín al principio para esas API específicas hasta que se reduzca el límite.

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.