Sintaxe de consulta - AWS IoT Core
Recursos compatíveisAtributos não compatíveisObservações

Sintaxe de consulta

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

Recursos compatíveis

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

  • 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

    Se você tiver um aumento de limite alto concedido para APIs de indexação de frotas, talvez não consiga usar o principal recurso curinga para essas APIs específicas até que seu limite seja reduzido.

Atributos não compatíveis

A sintaxe de consulta é compatível com os seguintes atributos:

  • Expressões regulares

  • Aumento

  • Classificação

  • Pesquisas difusas

  • Pesquisa de proximidade

  • Como classificar

  • Agregação

  • Caracteres especiais: `, @, #, %, \, /, ', ;, e ,. Observe que , só tem suporte em consultas geográficas.

Observações

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, o AWS IoT pesquisa o termo em todos os campos de registro, sombra do dispositivo 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.