SearchOptions Klasse

Definition

Parameter zum Filtern, Sortieren, Faceting, Paging und anderen Suchabfrageverhalten.

public class SearchOptions
type SearchOptions = class
Public Class SearchOptions
Vererbung
SearchOptions

Konstruktoren

SearchOptions()

Initialisiert eine neue instance von SearchOptions.

Eigenschaften

Debug

Aktiviert ein Debugtool, das verwendet werden kann, um Ihre semantischen Suchergebnisse weiter zu untersuchen.

Facets

Die Liste der Facettenausdrücke, die auf die Suchabfrage angewendet werden sollen. Jeder Facetausdruck enthält einen Feldnamen, optional gefolgt von einer durch Trennzeichen getrennten Liste von Name:Wert-Paaren.

Filter

Der OData-$filter Ausdruck, der auf die Suchabfrage angewendet werden soll. Sie können verwenden Create(FormattableString) , um den Filterausdruck zu erstellen.

HighlightFields

Die Liste der Feldnamen, die für Trefferhighlights verwendet werden sollen. Nur durchsuchbare Felder können für die Trefferherhebung verwendet werden.

HighlightPostTag

Ein Zeichenfolgentag, das an Trefferhighlights angefügt wird. Muss mit highlightPreTag festgelegt werden. Der Standardwert ist </em>.

HighlightPreTag

Ein Zeichenfolgentag, dem Trefferhighlights vorangestellt sind. Muss mit highlightPostTag festgelegt werden. Der Standardwert ist <em>.

IncludeTotalCount

Ein -Wert, der angibt, ob die Gesamtanzahl der Ergebnisse als TotalCount -Eigenschaft abgerufen werden soll. Der Standardwert ist „FALSE“. Das Festlegen dieses Werts auf true kann sich auf die Leistung auswirken. Beachten Sie, dass die zurückgegebene Anzahl ein Näherungswert ist.

MinimumCoverage

Eine Zahl zwischen 0 und 100, die den Prozentsatz des Indexes angibt, der von einer Suchabfrage abgedeckt werden muss, damit die Abfrage erfolgreich gemeldet wird. Dieser Parameter kann hilfreich sein, um die Suchverfügbarkeit auch für Dienste mit nur einem Replikat sicherzustellen. Der Standard ist 100.

OrderBy

Die Liste der OData-$orderby Ausdrücke, nach denen die Ergebnisse sortiert werden sollen. Jeder Ausdruck kann entweder ein Feldname oder ein Aufruf der Funktionen geo.distance() oder search.score() sein. Jedem Ausdruck kann asc folgen, um aufsteigend anzugeben, oder desc, um absteigend anzugeben. Standardmäßig wird in aufsteigender Reihenfolge sortiert. Verknüpfungen werden durch die Ergebnisstände von Dokumenten getrennt. Wenn kein $orderby angegeben ist, wird die Standardsortierreihenfolge nach Dokumentabgleichsbewertung absteigend ausgeführt. Es können maximal 32 $orderby-Klauseln vorhanden sein.

QueryAnswer

Ein -Wert, der angibt, ob Answers als Teil der Suchantwort zurückgegeben werden soll.

QueryAnswerCount

Ein -Wert, der die Anzahl von Answers angibt, die als Teil der Suchantwort zurückgegeben werden sollen.

QueryAnswerThreshold

Ein -Wert, der den Schwellenwert von angibt, der Answers als Teil der Suchantwort zurückgegeben werden soll.

QueryCaption

Ein -Wert, der angibt, ob Captions als Teil der Suchantwort zurückgegeben werden soll.

Standardwert: None.

QueryCaptionHighlightEnabled

Wenn QueryCaption auf Extractivefestgelegt ist, wird durch Festlegen von auf true die Hervorhebung der zurückgegebenen Beschriftungen aktiviert. Es füllt auf Highlights.

Standardwert: true.

QueryLanguage

Ein -Wert, der die Sprache der Suchabfrage angibt.

QuerySpeller

Ein -Wert, der den Typ der Rechtschreibprüfung angibt, die zur Rechtschreibkorrektur einzelner Suchabfragebegriffe verwendet werden soll.

QueryType

Ein -Wert, der die Syntax der Suchabfrage angibt. Der Standardwert ist "simple". Verwenden Sie "full", wenn Ihre Abfrage die Lucene-Abfragesyntax verwendet.

ScoringParameters

Die Liste der Parameterwerte, die in Bewertungsfunktionen (z. B. referencePointParameter) mit dem Format name-values verwendet werden sollen. Wenn das Bewertungsprofil beispielsweise eine Funktion mit einem Parameter namens "mylocation" definiert, lautet die Parameterzeichenfolge "mylocation--122.2,44.8" (ohne die Anführungszeichen).

ScoringProfile

Der Name eines Bewertungsprofils zum Auswerten von Übereinstimmungsbewertungen für den Vergleich von Dokumenten, um die Ergebnisse zu sortieren.

ScoringStatistics

Ein -Wert, der angibt, ob Bewertungsstatistiken (z. B. Dokumenthäufigkeit) global für eine konsistentere Bewertung oder lokal für eine geringere Latenz berechnet werden sollen. Der Standardwert ist "local". Verwenden Sie "global", um Bewertungsstatistiken vor der Bewertung global zu aggregieren. Die Verwendung von globalen Bewertungsstatistiken kann die Latenz von Suchabfragen erhöhen.

SearchFields

Die Liste der Feldnamen, auf die die Volltextsuche ausgerichtet werden soll. Wenn Sie die feldierte Suche (fieldName:searchExpression) in einer vollständigen Lucene-Abfrage verwenden, haben die Feldnamen jedes feldierten Suchausdrucks Vorrang vor allen feldnamen, die in diesem Parameter aufgeführt sind.

SearchMode

Ein -Wert, der angibt, ob ein oder alle Suchbegriffe abgeglichen werden müssen, um das Dokument als Übereinstimmung zu zählen.

Select

Die Liste der abzurufenden Felder. Wenn nicht anders angegeben, werden alle im Schema als abrufbar gekennzeichnete Felder einbezogen.

SemanticConfigurationName

Der Name einer semantischen Konfiguration, die beim Verarbeiten von Dokumenten für Abfragen vom Typ Semantik verwendet wird.

SemanticErrorHandling

Ermöglicht dem Benutzer die Auswahl, ob ein semantischer Aufruf vollständig fehlschlagen oder Teilergebnisse (Standard) zurückgeben soll.

SemanticFields

Die Liste der Feldnamen, die für die semantische Suche verwendet werden.

SemanticMaxWaitInMilliseconds

Ermöglicht dem Benutzer, eine Obergrenze für den Zeitraum festzulegen, der benötigt wird, bis die Verarbeitung der semantischen Anreicherung abgeschlossen ist, bevor die Anforderung fehlschlägt.

SemanticQuery

Ermöglicht das Festlegen einer separaten Suchabfrage, die ausschließlich für semantische Reranking, semantische Beschriftungen und semantische Antworten verwendet wird. Eignet sich für Szenarien, in denen unterschiedliche Abfragen zwischen der Basisabruf- und Rangfolgephase und der semantischen L2-Phase verwendet werden müssen.

SessionId

Ein Wert, der zum Erstellen einer dauerhaften Sitzung verwendet werden soll, wodurch konsistentere Ergebnisse erzielt werden können. Solange dieselbe sessionId verwendet wird, wird versucht, denselben Replikatsatz als Ziel zu verwenden. Seien Sie vorsichtig, dass die wiederholte Wiederverwendung der gleichen sessionID-Werte den Lastenausgleich der Anforderungen über Replikate hinweg beeinträchtigen und die Leistung des Suchdiensts beeinträchtigen kann. Der als „sessionId“ verwendete Wert darf nicht mit dem Zeichen „_“ beginnen.

Size

Die Anzahl der abzurufenden Suchergebnisse. Kann mit Skip kombiniert werden, um clientseitiges Paging von Suchergebnissen zu implementieren. Wenn ergebnisse aufgrund von serverseitigem Paging abgeschnitten werden, enthält die Antwort ein Fortsetzungstoken, das verwendet werden kann, um eine weitere Suchanforderung für die nächste Ergebnisseite auszugeben.

Skip

Die Anzahl der zu überspringenden Suchergebnisse. Dieser Wert darf nicht größer als 100.000 sein. Wenn Sie Dokumente nacheinander scannen müssen, aber aufgrund dieser Einschränkung skip nicht verwenden können, sollten Sie orderby für einen vollständig sortierten Schlüssel verwenden und stattdessen mit einer Bereichsabfrage filtern.

VectorFilterMode

Bestimmt, ob Filter vor oder nach der Vektorsuche angewendet werden. Der Standardwert ist "preFilter".

VectorQueries

Die Abfrageparameter für Suchabfragen mit mehreren Vektoren.

Gilt für: