SearchIndexClient.CreateOrUpdateIndexAsync 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.Aliases.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 System.Threading.Tasks.Task<Azure.Response<Azure.Search.Documents.Indexes.Models.SearchIndex>> CreateOrUpdateIndexAsync (Azure.Search.Documents.Indexes.Models.SearchIndex index, bool allowIndexDowntime = false, bool onlyIfUnchanged = false, System.Threading.CancellationToken cancellationToken = default);

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

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

Parameter

index: SearchIndex

Erforderlich. Der SearchIndex , der erstellt oder aktualisiert werden soll.

allowIndexDowntime: Boolean

Optionaler Wert, der angibt, ob Analysetools, Tokenisierer, 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“. Dadurch treten vorübergehend Indizierungs- und Abfragenfehler auf. 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 ein 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

Task<Response<SearchIndex>>

Der Response<T> vom Server mit dem, das SearchIndex erstellt oder aktualisiert wurde. Dies kann geringfügig von dem, was übergeben wurde, abweichen, da der Dienst Felder zurückgibt, die je nach Feldtyp und anderen Eigenschaften 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