Abfragereferenz

Vollständige Liste der Abfrageparameter, Operatoren und Aggregationen von Discovery. Diese Informationen enthalten hilfreiche Informationen zum Schreiben von Abfragen mit der Abfragesprache Discovery.

In der Benutzeroberfläche Discovery können Sie auf der Seite "Verbessern und anpassen" Abfragen in natürlicher Sprache schreiben und testen.

Parameterbeschreibungen

Verwenden Sie Abfrageparameter, um Ihre Objektgruppe zu durchsuchen, eine Ergebnismenge zu ermitteln und Ergebnismengen zu analysieren.

Suchparameter
Parameter Beschreibung Beispiel
aggregation Eine statistische Abfrage der Ergebnismenge. aggregation=term(enriched_text.entities.type)
filter Eine Suche in Abfragesprache ohne Einstufung nach übereinstimmenden Dokumenten. filter=bees
natural_language_query Eine Suche in natürlicher Sprache mit Einstufung nach übereinstimmenden Dokumenten. natural_language_query="How do bees fly"
query Eine Suche in Abfragesprache mit Einstufung nach übereinstimmenden Dokumenten. query=bees
Strukturparameter
Parameter Beschreibung Beispiel
count Die Anzahl der zurückzugebenden Dokumente im Ergebnis (result). count=15
highlight Hebt Übereinstimmungen mit der Abfrage hervor. highlight=true
offset Die Anzahl der Ergebnisse, die vor der Rückgabe von Dokumenten aus der Ergebnismenge in result ignoriert werden sollen. offset=100
return Die Liste der zurückzugebenden Felder. return=title,url
sort Das Feld, nach dem die Ergebnismenge sortiert werden soll. sort=enriched_text.sentiment.document.score
spelling suggestions Für Abfragen in natürliche Sprache zurückgegebene Rechtschreibvorschläge spelling_suggestions=true

Einschränkungen für Abfragen

Sie können keine Abfragen zu Feldnamen durchführen, die die folgenden Zeichen enthalten:

  • Zahlen (0 - 9) im Suffix des Feldnamens. Beispiel: extracted-content2.
  • Die Zeichen _, + und - im Präfix von field_name. Beispiel: +extracted-content.
  • Die Zeichen ., , und : in der field_name. Beispiel: new:extracted-content.

Operatoren

Operatoren trennen die einzelnen Bestandteile einer Abfrage voneinander. In der folgenden Tabelle sind die verfügbaren Operatoren aufgeführt.

Abfrageoperatoren
Operator Beschreibung Beispiel
. JSON-Begrenzer enriched_text.concepts.text
: Enthält text:computer
:: Exakte Übereinstimmung title::"Query building"
:! Enthält nicht text:!computer
::! Keine exakte Übereinstimmung text::!winter
\ Escapezeichen title::"Dorothy said: \"There's no place like home.\""
"" Ausdrucksabfrage enriched_text.concepts.text:"IBM Watson"
(), [] Verschachtelte Gruppen filter-entities:(text:Turkey,type:Location)
| oder query-enriched.entities.text:Google|IBM
, und query-enriched.entities.text:Google,IBM
<=, >=, >, < Numerische Vergleiche enriched_text.sentiment.document.score>0.679
^x Bewertungsmultiplikator text:IBM^3
* Platzhalterzeichen query-enriched_text.concepts.text:pre*
~n Zeichenfolgevariante query-enriched_text.entities.text:cat~1
:* Vorhanden title:*
!* Ist nicht vorhanden title!*

Aggregationen

Aggregationen geben eine Gruppe aus Datenwerten zurück. In der folgenden Tabelle sind die verfügbaren Aggregationen aufgeführt.

Abfrageaggregationen
Aggregation Beschreibung Beispiel
average Gibt den Mittelwert für das angegebene Feld in der Ergebnismenge an. average(product.price)
filter Ergebnisse auf der Basis des angegebenen Musters filtern filter(enriched_text.concepts.text:cloud computing)
histogram Intervallbasierte Verteilung histogram(product.price,interval:1)
max Gibt den Maximalwert für das angegebene Feld in der Ergebnismenge an. max(product.price)
min Gibt den Minimalwert für das angegebene Feld in der Ergebnismenge an. min(product.price)
nested Beschränkt die Aggregation. nested(enriched_text.entities)
sum Gibt die Summe aller Felder in der Ergebnismenge an. sum(product.price)
term Zählt identische Werte. term(enriched_text.concepts.text,count:10)
timeslice Zeitbasierte Verteilung timeslice(last_modified,2day,America/New York)
top_hits Ergebnisdokumente mit höchster Rangfolge für die aktuelle Aggregation term(enriched_text.concepts.text).top_hits(10)
unique_count Zählt die eindeutigen Werte für ein Feld in einer Aggregation. unique_count(enriched_text.entities.type)