Référence de requête

Liste complète des paramètres de requête, opérateurs et agrégations Discovery. Vous pouvez vous reporter à ces informations pour obtenir de l'aide lorsque vous écrivez des requêtes avec le langage de requête Discovery.

Dans l'interface utilisateur Discovery, vous pouvez écrire et tester des requêtes en langage naturel sur la page Améliorer et personnaliser.

Description des paramètres

Utilisez les paramètres de requête pour rechercher votre collection, identifier un ensemble de résultats et analyser les ensembles de résultats.

Rechercher des paramètres
Paramètre Descriptif Exemple
aggregation Requête de statistique portant sur l'ensemble de résultats aggregation=term(enriched_text.entities.type)
filter Recherche non classée de documents correspondants par l'intermédiaire d'un langage de requête filter=bees
natural_language_query Recherche classée de documents correspondants par l'intermédiaire d'un langage naturel natural_language_query="How do bees fly"
query Recherche classée de documents correspondants par l'intermédiaire d'un langage de requête query=bees
Paramètres de structure
Paramètre Descriptif Exemple
count Nombre de documents result à renvoyer. count=15
highlight Mettre en évidence les correspondances de requête highlight=true
offset Nombre de résultats à ignorer avant de renvoyer les documents result de l'ensemble de résultats offset=100
return Liste des zones à renvoyer return=title,url
sort Zone à partir de laquelle trier l'ensemble de résultats sort=enriched_text.sentiment.document.score
spelling suggestions Suggestions orthographiques renvoyées pour les requêtes en langage naturel. spelling_suggestions=true

Limitations des requêtes

Il n'est pas possible d'effectuer des requêtes sur des noms de champs qui contiennent les caractères suivants :

  • Nombres (0 - 9) dans le suffixe du nom de zone. Par exemple, extracted-content2.
  • Les caractères _, +, et - dans le préfixe du site field_name. Par exemple, +extracted-content.
  • Les caractères ., , et : dans field_name. Par exemple, new:extracted-content.

Opérateurs

Les opérateurs sont les séparateurs entre les différentes parties d'une requête. Le tableau suivant énumère les opérateurs disponibles.

opérateurs de requête
Opérateur Descriptif Exemple
. Délimiteur JSON enriched_text.concepts.text
: Inclut text:computer
:: Correspondance exacte title::"Query building"
:! N'inclut pas text:!computer
::! N'est pas une correspondance exacte text::!winter
\ Caractère d'échappement title::"Dorothy said: \"There's no place like home.\""
"" Requête de phrase enriched_text.concepts.text:"IBM Watson"
(), [] Groupes imbriqués filter-entities:(text:Turkey,type:Location)
| ou query-enriched.entities.text:Google|IBM
, et query-enriched.entities.text:Google,IBM
<=, >=, >, < Comparaisons numériques enriched_text.sentiment.document.score>0.679
^x Multiplicateur de score text:IBM^3
* Caractères génériques query-enriched_text.concepts.text:pre*
~n Variation de chaîne query-enriched_text.entities.text:cat~1
:* Existe title:*
!* N'existe pas title!*

Agrégations

Les agrégations renvoient un ensemble de valeurs de données. Le tableau suivant répertorie les agrégations disponibles.

Agrégations de requêtes
Agrégation Descriptif Exemple
average Valeur moyenne de la zone spécifiée dans l'ensemble de résultats average(product.price)
filter Filtrer les résultats en fonction du modèle spécifié filter(enriched_text.concepts.text:cloud computing)
histogram Distribution basée sur l'intervalle histogram(product.price,interval:1)
max Valeur maximale de la zone spécifiée dans l'ensemble de résultats max(product.price)
min Valeur minimale de la zone spécifiée dans l'ensemble de résultats min(product.price)
nested Restreindre l'agrégation nested(enriched_text.entities)
sum Somme de toutes les zones dans l'ensemble de résultats sum(product.price)
term Nombre de valeurs identiques term(enriched_text.concepts.text,count:10)
timeslice Distribution basée sur le temps timeslice(last_modified,2day,America/New York)
top_hits Documents de résultats les mieux classés pour l'agrégation en cours term(enriched_text.concepts.text).top_hits(10)
unique_count Nombre de valeurs uniques pour une zone dans une agrégation unique_count(enriched_text.entities.type)