Keyword Query Language-Syntaxreferenz (KeyQL)

Erfahren Sie, wie Sie KeyQL Abfragen für die Suche in SharePoint erstellen. Diese Syntaxreferenz beschreibt KeyQL Abfrageelemente und die Verwendung von Eigenschaftseinschränkungen und Operatoren in KeyQL Abfragen.

Elemente einer KeyQL Abfrage

Eine KeyQL Abfrage besteht aus mindestens einem der folgenden Elemente:

• Freitext-Schlüsselwörter, -Wörter oder -Ausdrücke
• Eigenschaftseinschränkungen

Sie können KeyQL Abfrageelemente mit einem oder mehreren der verfügbaren Operatoren kombinieren.

Wenn die KeyQL Abfrage nur Operatoren enthält oder leer ist, ist sie ungültig. KeyQL Bei Abfragen wird die Groß-/Kleinschreibung nicht beachtet, bei den Operatoren wird jedoch die Groß-/Kleinschreibung (Großbuchstaben) beachtet.

Hinweis

Die Längenbeschränkung einer KeyQL Abfrage variiert je nach Art der Erstellung. Wenn Sie die KeyQL Abfrage mithilfe des standardmäßigen SharePoint-Such-Front-Ends erstellen, beträgt die Längenbeschränkung 2.048 Zeichen. KeyQL Abfragen, die Sie programmgesteuert mithilfe des Query-Objektmodells erstellen, haben jedoch eine Standardlänge von 4.096 Zeichen. Sie können diesen Grenzwert auf bis zu 20.480 Zeichen erhöhen, indem Sie die MaxKeywordQueryTextLength-Eigenschaft oder die DiscoveryMaxKeywordQueryTextLength-Eigenschaft (für eDiscovery) verwenden.

Erstellen von Freitextabfragen mit KeyQL

Wenn Sie Ihre KeyQL Abfrage mithilfe von Freitextausdrücken erstellen, sucht in SharePoint die Ergebnisse für die Begriffe, die Sie für die Abfrage ausgewählt haben, basierend auf Begriffen, die im Volltextindex gespeichert sind. Dies schließt verwaltete Eigenschaftswerte ein, bei denen FullTextQueriable auf true festgelegt ist.

Bei Freitext KeyQL Abfragen wird die Groß-/Kleinschreibung nicht beachtet, die Operatoren müssen jedoch in Großbuchstaben enthalten sein. Sie können KeyQL Abfragen erstellen, indem Sie einen oder mehrere der folgenden Freitextausdrücke verwenden:

• Ein word (enthält ein oder mehrere Zeichen ohne Leerzeichen oder Interpunktion)
• Ein phrase (enthält zwei oder mehrere Wörter, die durch Leerzeichen getrennt sind; die Wörter müssen jedoch in doppelte Anführungszeichen gesetzt werden)

Zum Erstellen komplexer Abfragen können Sie mehrere Freitextausdrücke mit KeyQL Abfrageoperatoren kombinieren. Wenn mehrere Freitext-Ausdrücke mit darin enthaltenen Operatoren vorhanden sind, verhält sich die Abfrage wie beim Verwenden des AND-Operators.

Verwenden von Wörtern in der Freitext-KeyQL Abfrage

Wenn Sie Wörter in einer Freitextabfrage KeyQL verwenden, gibt Search in SharePoint Ergebnisse basierend auf exakten Übereinstimmungen Ihrer Wörter mit den im Volltextindex gespeicherten Begriffen zurück. Sie können auch nur den ersten Teil eines Worts verwenden, indem Sie den Platzhalter-Operator (*) verwenden, um den Präfix-Abgleich zu aktivieren. Beim Präfixabgleich gleicht Search in SharePoint Ergebnisse mit Begriffen ab, die das Wort enthalten, gefolgt von null oder mehr Zeichen.

Die folgenden KeyQL Abfragen geben z. B. Inhaltselemente zurück, die die Begriffe "Verbund" und "Suche" enthalten:

federated search federat* search search fed*

KeyQL Abfragen unterstützen keinen Präfixabgleich mit dem Wildcard * als Präfix.

Verwenden von Ausdrücken in der Freitextabfrage KeyQL

Wenn Sie Ausdrücke in einer Freitextabfrage KeyQL verwenden, gibt die Suche in SharePoint nur die Elemente zurück, in denen sich die Wörter in Ihrem Ausdruck nebeneinander befinden. Um einen Ausdruck in einer KeyQL Abfrage anzugeben, müssen Sie doppelte Anführungszeichen verwenden.

KeyQL Abfragen unterstützen keine Präfixabgleiche mit dem Wildcard * als Präfix, sodass Sie den Wildcardoperator nicht vor einem Ausdruck in Freitextabfragen verwenden können. Sie können den Platzhalter-Operator jedoch nach einem Ausdruck verwenden.

Eigenschafteneinschränkungsabfragen in KeyQL

Mit KeyQL können Sie Abfragen erstellen, die Eigenschafteneinschränkungen verwenden, um den Fokus der Abfrage so einzuschränken, dass nur Ergebnisse basierend auf einer angegebenen Bedingung übereinstimmen.

Angeben von Eigenschaftseinschränkungen

Eine einfache Eigenschaftseinschränkung besteht aus folgenden Teilen:

<Property Name><Property Operator><Property Value>

In Tabelle 1 sind einige Beispiele für die Syntax gültiger Eigenschaftseinschränkungen in KeyQL Abfragen aufgeführt.

Tabelle 1. Gültige Syntax für Eigenschaftseinschränkung

Syntax	gibt zurück
author:"John Smith"	Gibt von John Smith verfasste Inhaltselemente zurück.
filetype:docx	Gibt Microsoft Word-Dokumente zurück.
filename:budget.xlsx	Gibt Inhaltselemente mit dem Dateinamen budget.xlsxzurück.

Die Eigenschaftseinschränkung darf kein Leerzeichen zwischen Eigenschaftsname, Eigenschaftsoperator und Eigenschaftswert enthalten, andernfalls wird die Eigenschaftseinschränkung als Freitext-Abfrage behandelt. Die Länge einer Eigenschaftseinschränkung ist auf 2.048 Zeichen begrenzt.

In den folgenden Beispielen bewirkt das Leerzeichen, dass die Abfrage Inhaltselemente zurückgibt, die die Begriffe „Autor" und „John Smith" enthalten, statt von John Smith verfasste Inhaltselemente zurückzugeben:

author: "John Smith" author :"John Smith" author : "John Smith"

Anders ausgedrückt, die vorherigen Eigenschaftseinschränkungen entsprechen folgendem Sachverhalt:

author "John Smith"

Angeben von Eigenschaftsnamen für Eigenschaftseinschränkungen

Sie müssen einen gültigen verwalteten Eigenschaftsnamen für die Eigenschaftseinschränkung angeben. Standardmäßig enthält Suche in SharePoint verschiedene verwaltete Eigenschaften für Dokumente.

Um eine Eigenschaftseinschränkung für einen durchforsteten Eigenschaftswert anzugeben, müssen Sie die durchforstete Eigenschaft zunächst der verwalteten Eigenschaft zuordnen. Weitere Informationen dazu finden Sie unter Verwaltete und durchforstete Eigenschaften unter Planen der Endbenutzer-Sucherfahrung.

Die verwaltete Eigenschaft muss abfragbar sein, damit Sie in einem Dokument nach dieser verwalteten Eigenschaft suchen können. Außerdem kann die verwaltete Eigenschaft Retrievable sein, damit sie abgerufen werden kann. Die verwaltete Eigenschaft muss jedoch nicht Retrievable sein, damit Eigenschaftssuchen ausgeführt werden können.

In Eigenschaftseinschränkungen unterstützte Eigenschaftsoperatoren

Suche in SharePoint unterstützt verschiedene Eigenschaftsoperatoren für Eigenschaftseinschränkungen, siehe Tabelle 2.

Tabelle 2. Gültige Eigenschaftsoperatoren für Eigenschaftseinschränkungen

Operator	Beschreibung	Unterstützter verwalteter Eigenschaftstyp
:	Gibt Ergebnisse zurück, in denen der in der Eigenschaftseinschränkung angegebene Wert dem in der Eigenschaftsspeicher-Datenbank gespeicherten Eigenschaftswert entspricht, oder mit einzelnen Begriffen des im Volltextindex gespeicherten Eigenschaftswerts übereinstimmt.	Text DateTime Integer Decimal Double YesNo
=	Gibt Suchergebnisse zurück, in denen der Eigenschaftswert gleich dem in der Eigenschaftseinschränkung angegeben Wert ist. Hinweis: Es wird nicht empfohlen, den =-Operator bei genauen Übereinstimmungen mit einem Sternchen (*) zu kombinieren.	Text DateTime Integer Decimal Double YesNo
<	Gibt Ergebnisse zurück, in denen der Eigenschaftswert geringer als der in der Eigenschaftseinschränkung angegebene Wert ist.	DateTime Integer Decimal Double
>	Gibt Suchergebnisse zurück, in denen der Eigenschaftswert größer als der in der Eigenschaftseinschränkung angegeben Wert ist.	DateTime Integer Decimal Double
<=	Gibt Suchergebnisse zurück, in denen der Eigenschaftswert kleiner gleich dem in der Eigenschaftseinschränkung angegebenen Wert ist.	DateTime Integer Decimal Double
>=	Gibt Suchergebnisse zurück, in denen der Eigenschaftswert größer gleich dem in der Eigenschaftseinschränkung angegebenen Wert ist.	DateTime Integer Decimal Double
<>	Gibt Suchergebnisse zurück, in denen der Eigenschaftswert nicht dem in der Eigenschaftseinschränkung angegebenen Wert entspricht.	DateTime Integer Decimal Text Double YesNo
..	Gibt Suchergebnisse zurück, in denen der Eigenschaftswert innerhalb des in der Eigenschaftseinschränkung angegebenen Bereichs liegt. Der Bereich A..B stellt beispielsweise eine Gruppe von Werten zwischen A und B, in der A und B enthalten sind. Bei Datumsbereichen liegt der Bereich dann zwischen Anfang Tag A und Ende Tag B.	DateTime Integer Decimal Double

Angeben von Eigenschaftswerten

Sie müssen einen Eigenschaftswert angeben, der ein gültiger Datentyp für den verwalteten Eigenschaftstyp ist. In Tabelle 3 sind diese Typenzuordnungen aufgelistet.

Tabelle 3. Gültige Datentypzuordnungen für verwaltete Eigenschaftstypen

Verwalteter Typ	Datentyp
Text	String
Integer	Int64
Double	System.Double
Decimal	Decimal
DateTime()	DateTime
YesNo	Boolean

Texteigenschaftstypen

Bei Texteigenschaftswerten hängt das Übereinstimmungsverhalten davon ab, ob die Eigenschaft im Volltextindex oder im Suchindex gespeichert ist.

Eigenschaftswerte im Volltextindex

Eigenschaftswerte werden im Volltextindex gespeichert, wenn die FullTextQueriable-Eigenschaft für eine verwaltete Eigenschaft auf truewurde. Sie können diese Einstellung nur für Zeichenfolgeneigenschaften konfigurieren. In der Abfrage angegebene Eigenschaftswerte werden mit den einzelnen Begriffen abgeglichen, die im Volltextindex gespeichert sind. Verwenden Sie die NoWordBreaker -Eigenschaft, um anzugeben, ob sie mit dem gesamten Eigenschaftswert abgeglichen werden sollen.

Wenn Sie beispielsweise nach einem Inhaltselement suchen, das von Paul Shakespear erstellt wurde, gibt die folgende KeyQL Abfrage übereinstimmende Ergebnisse zurück:

author:Shakespear author:Paul

Der Präfix-Abgleich wird auch unterstützt. Sie können den Platzhalteroperator (*) verwenden, aber er ist nicht erforderlich, wenn Sie einzelne Wörter angeben. Wenn sie mit dem vorherigen Beispiel fortfahren, gibt die folgende KeyQL Abfrage Inhaltselemente zurück, die von Paul Shakespear erstellt wurden, als Übereinstimmungen:

author:Shakesp*

Wenn Sie für den Eigenschaftswert einen Ausdruck angeben, müssen übereinstimmende Ergebnisse den angegebenen Ausdruck im Eigenschaftswert enthalten, der im Volltextindex gespeichert ist. Das folgende Abfragebeispiel gibt Inhaltselemente mit dem Text "Erweiterte Suche" im Titel zurück, z. B. "Advanced Search XML", "Learning About the Advanced Search web part" usw.:

title:"Advanced Search"

Der Präfix-Abgleich wird auch für in den Eigenschaftswerten angegebene Ausdrücke unterstützt, dafür müssen Sie jedoch den Platzhalter-Operator (*) in der Abfrage verwenden. Außerdem wird er nur am Ende des Ausdrucks unterstützt, siehe folgendes Beispiel:

title:"Advanced Sear*"

Folgende Abfragen geben nicht das erwartete Ergebnis zurück:

title:"Advan* Search" title:"Advanced Sear"

Numerische Werte für Eigenschaften

Numerische Eigenschaftswerte, die die verwalteten Typen Integer, Double und Decimal enthalten, wird die Eigenschaftseinschränkung mit dem gesamten Eigenschaftswert abgeglichen.

Datums- oder Zeitwerte für Eigenschaften

KeyQL stellt den datetime-Datentyp für Datum und Uhrzeit bereit. Die folgenden ISO 8601-kompatiblen datetime-Formate werden in Abfragen unterstützt:

• JJJJ-MM-TT
• JJJJ-MM-TTThh:mm:ss
• YYYY-MM-DDThh:mm:ssZ
• YYYY-MM-DDThh:mm:ssfrZ

In diesen datetime-Formaten:

• YYYY gibt eine vierziffrige Jahreszahl an.

  Hinweis

  Es werden nur vierziffrige Jahresangaben unterstützt.

• MM gibt einen zweiziffrigen Monat an. Z. B. 01 = Januar.

• DD gibt einen zweiziffrigen Tag des Monats an (01-31).

• T gibt den Buchstaben „T" an.

• hh gibt eine zweistellige Stunde an (00 bis 23); Die A.M./P.M.-Angabe ist nicht zulässig.

• mm gibt eine zweiziffrige Minutenangabe an (00-59).

• ss gibt eine zweiziffrige Sekundenangabe an (00-59).

• fr gibt einen optionalen Sekundenbruchteil an, ss; zwischen 1 und 7 Ziffern, die auf folgt , nach den Sekunden. Beispiel: 2012-09-27T11:57:34.1234567.

Alle Datums-/Zeitwerte müssen gemäß der UTC (Coordinated Universal Time) angegeben werden, auch als GMT (Greenwich Mean Time) Zeitzone bekannt. Der UTC-Zeitzonenbezeichner (nachfolgendes "Z") ist optional.

Relevante Datumsintervalle, die von KeyQL unterstützt werden

mit KeyQL können Sie Suchabfragen erstellen, die eine relative Tagesbereichsabfrage mit reservierten Schlüsselwörtern unterstützen, wie in Tabelle 4 dargestellt. Verwenden Sie doppelte Anführungszeichen ("") für Datumsintervalle, zwischen denen sich Leerzeichen befinden.

Übereinstimmungen würden heute geänderte Elemente enthalten:

LastModifiedTime=today

Übereinstimmungen würden Elemente vom Anfang des aktuellen Jahres bis zum Ende des aktuellen Jahres enthalten:

LastModifiedTime="this year"

Übereinstimmungen enthalten Elemente vom 1. Januar 2019 bis zum 26. April 2019:

LastModifiedTime>=2019-01-01 AND LastModifiedTime<=2019-04-26

Tabelle 4. Reservierte Schlüsselwörter für Datumsintervall

Name des Datumsintervalls	Beschreibung
heute	Stellt den Zeitraum vom Anfang des aktuellen Tags bis zum Ende des aktuellen Tags dar.
yesterday	Stellt den Zeitraum vom Anfang des Tags bis zum Ende des Tags, der vor dem aktuellen Tag liegt, dar.
this week	Stellt den Zeitraum zwischen dem Anfang der aktuellen Woche und dem Ende der aktuellen Woche dar. Die Kultur, in der der Abfragetext formuliert wurde, wird dabei berücksichtigt, um den ersten Tag der Woche zu ermitteln.
this month	Stellt den Zeitraum vom Anfang des aktuellen Monats bis zum Ende des aktuellen Monats dar.
last month	Stellt den gesamten Monat dar, der vor dem aktuellen Monat liegt.
this year	Stellt den Zeitraum vom Anfang des aktuellen Jahres bis zum Ende des aktuellen Jahres dar.
last year	Stellt das gesamte Jahr dar, das vor dem aktuellen Jahr liegt.

Verwenden mehrerer Eigenschaftseinschränkungen innerhalb einer KeyQL Abfrage

Die Suche in SharePoint unterstützt die Verwendung mehrerer Eigenschaftseinschränkungen innerhalb derselben KeyQL Abfrage. Sie können entweder die gleiche Eigenschaft für mehrere Eigenschaftseinschränkungen verwenden oder für jede Eigenschaftseinschränkung eine andere Eigenschaft nutzen.

Wenn Sie mehrere Instanzen derselben Eigenschaftseinschränkung verwenden, basieren Übereinstimmungen auf der Vereinigung der Eigenschaftseinschränkungen in der KeyQL Abfrage. Die Übereinstimmungen enthalten von John Smith oder Jane Smith verfasste Inhaltselemente, siehe folgendes Beispiel:

author:"John Smith" author:"Jane Smith"

Diese Funktion entspricht der Verwendung des booleschen Operators OR, siehe folgendes Beispiel:

author:"John Smith" OR author:"Jane Smith"

Wenn Sie verschiedene Eigenschaftseinschränkungen verwenden, basieren Übereinstimmungen wie folgt auf einer Schnittmenge der Eigenschaftseinschränkungen in der KeyQL Abfrage:

author:"John Smith" filetype:docx

Übereinstimmungen würden von John Smith verfasste Microsoft Word-Dokumente enthalten. Diese Funktion entspricht der Verwendung des booleschen Operators AND, siehe folgendes Beispiel:

author:"John Smith" AND filetype:docx

Gruppieren von Eigenschaftseinschränkungen innerhalb einer KeyQL Abfrage

Gilt für: Office 365 | SharePoint Online | SharePoint 2019

Sie können mit Klammern () mehrere Eigenschafteneinschränkungen gruppieren, die sich auf eine bestimmte Eigenschaft vom Typ Text mit dem folgenden Format beziehen:

<Property Name>:(<Expression>)

Komplexere Abfragen profitieren möglicherweise von der Verwendung der ()-Notation zum Erstellen von kompakteren und übersichtlicheren Abfrageausdrücken.

Die Abfrage:

author:"John Smith" AND author:"Jane Smith"

kann umgeschrieben werden als:

author:("John Smith" "Jane Smith")

Die Abfrage:

title:Advanced title:Search title:Query NOT title:"Advanced Search Query"

kann umgeschrieben werden als:

title:((Advanced OR Search OR Query) -"Advanced Search Query")

Die Abfrage:

title:Advanced XRANK(cb=1) title:Search XRANK(cb=1) title:Query

kann umgeschrieben werden als:

title:(Advanced XRANK(cb=1) Search XRANK(cb=1) Query)

Hinweis

Wenn Sie zum Gruppieren eines Ausdrucks in einer Eigenschaftsabfrage verwenden () , kann die Anzahl der Übereinstimmungen zunehmen, wenn einzelne Abfragewörter lemmatisiert werden, was sie andernfalls nicht sind. Ausdrücke in Anführungszeichen werden nicht lemmatisiert.

title:page gibt Übereinstimmungen mit der exakten Ausdrucksseite zurück, während title:(page) auch Übereinstimmungen für die Ausdrucksseiten zurückgegeben werden.

Filtern nach Elementen, bei denen eine Texteigenschaft leer ist oder einen Wert enthält

Gilt für: Office 365 | SharePoint Online

Für verwaltete Eigenschaften vom Typ Text im Suchschema, die auf Queryable festgelegt sind, können Sie den Platzhalteroperator (*) als Eigenschaftsausdruck verwenden, um nach Elementen zu filtern, die entweder einen Wert haben oder keinen Wert haben.

Syntax zum Zurückgeben von Elementen, bei denen eine Texteigenschaft einen Wert aufweist:

<Property Name>:*

Syntax zum Zurückgeben von Elementen, bei denen eine Texteigenschaft keinen Wert aufweist:

NOT <Property Name>:*

Im folgenden Beispiel werden Websites zurückgegeben, die einer Hubwebsite zugeordnet sind, mit Ausnahme der Hubwebsites selbst:

(DepartmentId:* OR RelatedHubSites:*) AND contentclass:sts_site NOT IsHubSite:true

KeyQL-Operatoren für komplexe Abfragen

KeyQL Syntax enthält mehrere Operatoren, mit denen Sie komplexe Abfragen erstellen können.

Boolesche Operatoren

Sie können boolesche Operatoren verwenden, um die Suche zu erweitern oder einzugrenzen. Sie können boolesche Operatoren mit Freitextausdrücken und Eigenschaftseinschränkungen in KeyQL Abfragen verwenden. In Tabelle 5 sind die unterstützten booleschen Operatoren aufgelistet.

Tabelle 5. Unterstützte boolesche Operatoren in KeyQL

Operator	Beschreibung
AND	Gibt Suchergebnisse zurück, die alle Freitext-Ausdrücke oder Eigenschaftseinschränkungen enthält, die mit dem Operator AND angegeben wurden. Sie müssen einen gültigen Freitextausdruck und/oder eine gültige Eigenschaftseinschränkung angeben, sowohl vor als auch nach dem AND-Operator . Diese Funktion entspricht der Verwendung des „+"-Zeichens.
NOT	Gibt Suchergebnisse zurück, in denen die angegebenen Freitext-Ausdrücke oder Eigenschaftseinschränkungen nicht enthalten sind. Sie müssen nach dem Operator NOT einen gültigen Freitext-Ausdruck und/oder eine gültige Eigenschaftseinschränkung angeben. Diese Funktion entspricht der Verwendung des „-"-Zeichens.
ODER	Gibt Suchergebnisse zurück, die eine oder mehrere der angegebenen Freitext-Ausdrücke oder Eigenschaftseinschränkungen enthält. Sie müssen einen gültigen Freitextausdruck und/oder eine gültige Eigenschaftseinschränkung angeben, sowohl vor als auch nach dem OR-Operator .

Näherungsoperatoren

Sie können Näherungsoperatoren verwenden, um die Ergebnisse abzugleichen, bei denen die Suchbegriffe nah beieinander auftauchen. Näherungsoperatoren können nur mit Freitextausdrücken verwendet werden. sie werden nicht mit Eigenschaftseinschränkungen in KeyQL-Abfragen unterstützt. Es gibt zwei Näherungsoperatoren: NEAR und ONEAR.

NEAR-Operator

Der NEAR-Operator gleicht die Ergebnisse ab, bei denen die Suchbegriffe nah beieinander auftauchen, ohne dabei die Reihenfolge der Begriffe einhalten zu müssen. Die Syntax für NEAR lautet wie folgt:

<expression> NEAR(n=4) <expression>

Dabei ist n ein optionaler Parameter, der den maximalen Abstand zwischen den Begriffen angibt. Der Wert von n ist eine ganze Zahl >= 0 mit dem Standardwert 8.

Der Parameter n kann als n=v angegeben werden, wobei v den Wert darstellt oder auf nur v verkürzt wird, z NEAR(4) . B. wenn v 4 ist.

Zum Beispiel:

"acquisition" NEAR "debt"

Diese Abfrage gleicht Elemente ab, bei denen die Begriffe "Erwerb" und "Schuld" innerhalb desselben Elements vorkommen, wobei auf eine instance "Erwerb" bis zu acht weitere Begriffe folgen, und dann ein instance des Begriffs "Schulden" oder umgekehrt. Die Reihenfolge der Bedingungen ist für die Übereinstimmung nicht von Bedeutung.

Wenn ein geringerer Abstand zwischen den Begriffen liegen soll, können Sie ihn angeben. Die folgende Abfrage gleicht Elemente ab, bei denen die Begriffe "Erwerb" und "Schulden" innerhalb desselben Elements vorkommen, wobei der maximale Abstand zwischen den Begriffen 3 ist. Auch hier wirkt sich die Reihenfolge der Bedingungen nicht auf die Übereinstimmung aus.

"acquisition" NEAR(n=3) "debt"

Hinweis

In SharePoint behält der NEAR-Operator nicht mehr die Reihenfolge der Token bei. Darüber hinaus erhält der NEAR-Operator jetzt einen optionalen Parameter, der einen maximalen Tokenabstand angibt. Der Standardwert ist jedoch weiterhin 8. Wenn Sie das vorherige Verhalten verwenden müssen, verwenden Sie stattdessen ONEAR.

ONEAR-Operator

Der ONEAR-Operator gleicht die Ergebnisse ab, bei denen die angegebenen Suchbegriffe nah beieinander auftreten und behält die Reihenfolge der Begriffe bei. Die Syntax für ONEAR lautet wie folgt, wobei n ein optionaler Parameter ist, der den maximalen Abstand zwischen den Begriffen angibt. Der Wert von n ist eine ganze Zahl >= 0 mit dem Standardwert 8.

<expression> ONEAR(n=4) <expression>

Der Parameter n kann als n=v angegeben werden, wobei v den Wert darstellt oder auf nur v verkürzt wird, z ONEAR(4) . B. wenn v 4 ist.

Die folgende Abfrage gleicht beispielsweise Elemente ab, in denen die Begriffe „Akquirierung" und „Forderung" innerhalb des gleichen Elements auftauchen, dabei folgen auf eine Instanz „Akquirierung" bis zu acht weitere Begriffe und anschließend eine Instanz des Begriffs „Forderung". Die Reihenfolge der Begriffe muss übereinstimmen, damit ein Element zurückgegeben werden kann:

"acquisition" ONEAR "debt"

Wenn ein kleinerer Abstand zwischen den Begriffen liegen soll, können Sie ihn wie folgt angeben. Diese Abfrage gleicht Elemente ab, bei denen die Begriffe "Erwerb" und "Schulden" innerhalb desselben Elements vorkommen, wobei der maximale Abstand von 3 zwischen den Begriffen liegt. Die Reihenfolge der Begriffe muss übereinstimmen, damit ein Element zurückgegeben werden kann:

"acquisition" ONEAR(n=3) "debt"

Synonym-Operatoren

Sie können den Operator WORDS verwenden, um anzugeben, dass die Begriffe in der Abfrage Synonyme sind und zurückgegebene Ergebnisse mit einem der angegebenen Begriffe übereinstimmen sollten. Sie können den WORDS-Operator nur mit Freitextausdrücken verwenden. Sie wird bei Eigenschafteneinschränkungen in KeyQL Abfragen nicht unterstützt.

Die folgende Beispielabfrage gleicht Ergebnisse ab, die den Begriff „TV" oder den Begriff „Fernsehen" enthalten. Dieses Abgleichverhalten entspricht der Verwendung folgender Abfrage:

WORDS(TV, Television) TV OR Television

Diese Abfragen unterscheiden sich in der Ergebnisrangfolge. Wenn Sie den Operator WORDS verwenden, werden die Begriffe „TV" und „Fernsehen" als Synonyme behandelt, statt als einzelne Begriffe. Deshalb ist die Rangfolge der Instanzen der Begriffe so, als wäre es derselbe Begriff. Ein Inhaltselement, das eine Instanz des Begriffs „Fernsehen“ und fünf Instanzen des Begriffs „TV“ enthält, erhält die gleiche Rangfolge, als wären sechs Instanzen des Begriffs „TV“ im Inhaltselement enthalten.

Platzhalterzeichen

Verwenden Sie das Platzhalterzeichen Sternchen (" * "), um die Präfix-Anpassung zu aktivieren. In Ihrer Anfrage können Sie einen Teil des Wortes angeben. Beginnen Sie mit dem Anfang des Wortes gefolgt vom Platzhalterzeichen. Bei dieser Abfrage wird nach Übereinstimmungen gesucht, die Ausdrücke enthalten, die mit "serv" beginnen, gefolgt von null oder mehr Zeichen, wie z. B. "serve", "server", "service" usw.

serv*

Ein- und Ausschluss-Operatoren

Sie können angeben, ob die zurückgegebenen Ergebnisse Inhalte enthalten oder ausschließen sollen, die mit dem im Freitext-Ausdruck oder in der Eigenschaftseinschränkung angegebenen Wert übereinstimmen, indem Sie Inklusions- oder Ausschluss-Operatoren verwenden, siehe Tabelle 6.

Tabelle 6. Operatoren zum Ein- und Ausschließen von Inhalt in Ergebnissen

Name	Operator	Verhalten
Inklusion	" + "	Schließt Inhalte mit Werten ein, die mit der Inklusion übereinstimmen. Wenn kein Zeichen angegeben wurde, verhält sich die Abfrage standardmäßig so. Diese Funktion entspricht der Verwendung des AND-Operators.
Ausschluss	" - "	Schließt Inhalte mit Werten ein, die mit der Exklusion übereinstimmen. Diese Funktion entspricht der Verwendung des Operators NOT.

Dynamischer Rangfolge-Operator

Sie können den Operator XRANK verwenden, um den dynamischen Rang der Elemente basierend auf bestimmten Vorkommnissen von Begriffen im match expression verstärken, ohne die Abfrage dahingehend zu verändern, welche Elemente mit der Abfrage übereinstimmen. Ein XRANK-Ausdruck enthält eine Komponente, die abgeglichen werden muss, den Übereinstimmungsausdruck und eine oder mehrere Komponenten, die nur zur dynamischen Rangfolge beitragen, den Rangausdruck. Es muss mindestens einer der Parameter angegeben werden, abgesehen von n, damit ein XRANK-Ausdruck gültig ist.

Hinweis

Die Abfragelatenz (und die Wahrscheinlichkeit einer Zeitüberschreitung) erhöht sich bei Verwendung komplexer Abfragen und insbesondere bei Verwendung von xrank-Operatoren. Die Erhöhung der Abfragelatenz hängt von der Anzahl der XRANK-Operatoren und der Anzahl der Treffer in den Komponenten für den übereinstimmenden Ausdruck und Rangausdruck in der Abfragestruktur ab.

Übereinstimmungsausdrücke können ein beliebiger gültiger KeyQL Ausdruck sein, einschließlich geschachtelter XRANK-Ausdrücke. Rangausdrücke können ein beliebiger gültiger KeyQL Ausdruck ohne XRANK-Ausdrücke sein. Wenn Ihre KeyQL Abfragen über mehrere XRANK-Operatoren verfügen, wird der endgültige dynamische Rangwert als Summe von Verstärkungen für alle XRANK-Operatoren berechnet.

Hinweis

Verwenden Sie Klammern, um die Berechnungsreihenfolge für KeyQL Abfragen mit mehr als einem XRANK-Operator auf derselben Ebene explizit anzugeben.

Sie können den XRANK-Operator in der folgenden Syntax verwenden:

<match expression> XRANK(cb=100, rb=0.4, pb=0.4, avgb=0.4, stdb=0.4, nb=0.4, n=200) <rank expression>

Die Berechnung der dynamischen Rangfolge des XRANK-Operators basiert auf dieser Formel:

In Tabelle 7 sind die verfügbaren Grundparameter für den XRANK-Operator aufgelistet.

Tabelle 7. Parameter des XRANK-Operators

Parameter	Wert	Beschreibung
n	<integer_value>	Gibt die Anzahl der Ergebnisse für die Berechnung von Statistiken an. Dieser Parameter hat keine Auswirkungen auf die Anzahl der Ergebnisse, die durch die dynamische Rangfolge hinzu kommen; es handelt sich dabei lediglich um eine Methode zum Ausschließen irrelevanter Elemente aus den Berechnungen der Statistik. Standardwert: 0. Ein Nullwert trägt die Semantik aller Dokumente .
nb	<float_value>	Der Parameter nb verweist auf die normale Verstärkung. Dieser Parameter gibt den Faktor an, der mit dem Produkt der Abweichung und der Durchschnittsbewertung der Rangwerte der Ergebnisgruppe multipliziert wird. f in der XRANK-Formel.

Normalerweise ist die normalisierte Verstärkung nb der einzige Parameter, der geändert wird. Dieser Parameter stellt das benötigte Steuerelement bereit, um ein bestimmtes Element höher oder niedriger zu stufen, ohne dabei die Standardabweichung zu berücksichtigen.

Außerdem sind folgende erweiterte Parameter verfügbar. In der Regel werden sie jedoch nicht verwendet.

Tabelle 8. Erweiterte Parameter für XRANK

Parameter	Wert	Beschreibung
cb	<float_value>	Der Parameter cb verweist auf die konstante Verstärkung. Standardwert: 0. a in der XRANK-Formel.
stdb	<float_value>	Der Parameter stdb verweist auf die Verstärkung der Standardabweichung. Standardwert: 0. e in der XRANK-Formel.
avgb	<float_value>	Der Parameter avgb verweist auf die durchschnittliche Verstärkung. Standardwert: 0. d in der XRANK-Formel.
rb	<float_value>	Der Parameter rb verweist auf die Bereichsverstärkung. Dieser Faktor wird mit dem Bereich der Rangfolgewerte in der Ergebnisgruppe multipliziert. Standardwert: 0. b in der XRANK-Formel.
pb	<float_value>	Der Parameter pb verweist auf die Prozentwertverstärkung. Dieser Faktor wird im Vergleich zum Mindestwert des Korpus mit der Rangfolge des Elements multipliziert. Standardwert: 0. c in der XRANK-Formel.

Beispiele

Beispiel 1. Der folgende Ausdruck gleicht Elemente ab, bei denen der Standard-Volltextindex den Begriff „Katze" oder „Hund" enthält. Der Ausdruck erhöht die dynamische Rangfolge der Elemente mit einer konstanten Verstärkung von 100 für Elemente, die zusätzlich den Begriff „Vollblutpferd" enthalten.

(cat OR dog) XRANK(cb=100) thoroughbred

Beispiel 2. Der folgende Ausdruck gleicht Elemente ab, bei denen der Standard-Volltextindex den Begriff „Katze" oder „Hund" enthält. Der Ausdruck erhöht die dynamische Rangfolge der Elemente mit einer normalen Verstärkung von 1,5 für Elemente, die zusätzlich den Begriff „Vollblutpferd" enthalten.

(cat OR dog) XRANK(nb=1.5) thoroughbred

Beispiel 3. Der folgende Ausdruck gleicht Elemente ab, bei denen der Standard-Volltextindex den Begriff „Katze" oder „Hund" enthält. Der Ausdruck erhöht die dynamische Rangfolge der Elemente mit einer konstanten Verstärkung von 100 und einer normalen Verstärkung von 1,5, für Elemente, die zusätzlich den Begriff „Vollblutpferd" enthalten.

(cat OR dog) XRANK(cb=100, nb=1.5) thoroughbred

Beispiel 4. Der folgende Ausdruck gleicht alle Elemente ab, die den Begriff „Tiere" enthalten und die dynamische Rangfolge wie folgt verstärken:

• Die dynamische Rangfolge von Elementen, die den Begriff „Hunde" enthalten, werden um 100 Punkte verstärkt.
• Die dynamische Rangfolge der Elemente, die den Begriff „Katzen" enthalten, werden um 200 Punkte verstärkt.
• Die dynamische Rangfolge der Elemente, die die Begriffe „Hunde" und „Katzen" enthalten, werden um 300 Punkte verstärkt.

(animals XRANK(cb=100) dogs) XRANK(cb=200) cats

Klammer

Sie können verschiedene Teile einer Stichwortabfrage kombinieren, indem Sie eine öffnende „ ( " und schließende Klammer „ ) " verwenden. Zu jeder öffnenden Klammer „ ( " muss eine schließende Klammer „ ) " vorhanden sein. Ein Leerzeichen vor und nach einer Klammer hat keine Auswirkungen auf die Abfrage.

Siehe auch

• Erstellen von Suchabfragen in SharePoint