你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
SearchIndexClient.CreateOrUpdateIndex 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
创建新的搜索索引或更新现有索引。
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)
参数
- index
- SearchIndex
必需。 SearchIndex要创建或更新的 。
- allowIndexDowntime
- Boolean
可选值,指示是否允许分析器、令牌化器、令牌筛选器或字符筛选器通过暂时使索引脱机几秒钟来添加到索引中。 默认值为 false。 这暂时导致索引编制和查询失败。 索引的性能和写入可用性可在更新索引后的几分钟内处于受损状态,对于非常大的索引,持续时间更长。
- onlyIfUnchanged
- Boolean
如果 与当前服务版本不匹配,则ETag为 True,则引发 RequestFailedException ;否则,将覆盖当前服务版本。
- cancellationToken
- CancellationToken
可选 CancellationToken ,用于传播应取消操作的通知。
返回
Response<T>包含SearchIndex已创建或更新的 的服务器的 。 这可能与传入的内容略有不同,因为服务可能会返回设置为其默认值的字段,具体取决于字段类型和其他属性。
例外
当 index
为 null 时引发。
当搜索服务返回故障时引发。