SearchIndexClient.CreateOrUpdateIndex Methode

Referenz

Definition

Namespace:: Azure.Search.Documents.Indexes

Assembly:: Azure.Search.Documents.dll

Paket:: Azure.Search.Documents v11.5.1

Paket:: Azure.Search.Documents v11.6.0-beta.4

Quelle:: SearchIndexClient.cs

Quelle:: SearchIndexClient.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt einen neuen Suchindex oder aktualisiert einen vorhandenen Index.

public virtual Azure.Response<Azure.Search.Documents.Indexes.Models.SearchIndex> CreateOrUpdateIndex (Azure.Search.Documents.Indexes.Models.SearchIndex index, bool allowIndexDowntime = false, bool onlyIfUnchanged = false, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateOrUpdateIndex : Azure.Search.Documents.Indexes.Models.SearchIndex * bool * bool * System.Threading.CancellationToken -> Azure.Response<Azure.Search.Documents.Indexes.Models.SearchIndex>
override this.CreateOrUpdateIndex : Azure.Search.Documents.Indexes.Models.SearchIndex * bool * bool * System.Threading.CancellationToken -> Azure.Response<Azure.Search.Documents.Indexes.Models.SearchIndex>

Public Overridable Function CreateOrUpdateIndex (index As SearchIndex, Optional allowIndexDowntime As Boolean = false, Optional onlyIfUnchanged As Boolean = false, Optional cancellationToken As CancellationToken = Nothing) As Response(Of SearchIndex)

Parameter

index: SearchIndex

Erforderlich. Die SearchIndex zu erstellende oder zu aktualisierende.

allowIndexDowntime: Boolean

Optionaler Wert, der angibt, ob Analysetools, Tokenizer, Tokenfilter oder Zeichenfilter dem Index hinzugefügt werden sollen, indem der Index vorübergehend für einige Sekunden offline geschaltet wird. Die Standardeinstellung ist „false“. Dies führt vorübergehend dazu, dass die Indizierung und Abfragen fehlschlagen. Leistung und Schreibverfügbarkeit des Indexes können nach der Indexaktualisierung mehrere Minuten lang eingeschränkt sein, bei sehr großen Indizes auch länger.

onlyIfUnchanged: Boolean

True, um eine RequestFailedException auszulösen, wenn die ETag nicht mit der aktuellen Dienstversion übereinstimmt. Andernfalls wird die aktuelle Dienstversion überschrieben.

cancellationToken: CancellationToken

Optional CancellationToken zur Weitergabe von Benachrichtigungen, dass der Vorgang abgebrochen werden soll.

Gibt zurück

Response<SearchIndex>

Die Response<T> vom Server, die den enthält, der SearchIndex erstellt oder aktualisiert wurde. Dies kann sich geringfügig von dem unterscheiden, was übergeben wurde, da der Dienst je nach Feldtyp und anderen Eigenschaften möglicherweise Felder zurückgibt, die auf ihre Standardwerte festgelegt sind.

Ausnahmen

ArgumentNullException

Wird ausgelöst, wenn index NULL ist.

RequestFailedException

Wird ausgelöst, wenn ein Fehler vom Suchdienst zurückgegeben wird.

Gilt für:

Freigeben über