You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Azure搜索服务索引文档键不支持正斜杠,如何配置allowUnsafeKeys参数?

allowUnsafeKeys参数使用说明

allowUnsafeKeys不属于索引创建时的配置项,仅需要在调用文档写入类操作(新增/更新/删除文档)的REST API时,作为URL查询参数传递即可。

请求示例

常规的索引文档写入请求URL如下:
POST https://<your-search-service>.search.windows.net/indexes/<your-index-name>/docs/index?api-version=2020-06-30

添加参数后的请求URL:
POST https://<your-search-service>.search.windows.net/indexes/<your-index-name>/docs/index?api-version=2020-06-30&allowUnsafeKeys=true

注意事项

  • 开启allowUnsafeKeys=true后,除了你需要的正斜杠/之外,还支持其他原本被限制的特殊字符,包括反斜杠\、问号?、井号#、百分号%等
  • 键字段的长度限制仍然有效,最大不能超过1024个字符,不会因为开启该参数放宽
  • 如果你使用官方SDK进行操作,对应写入文档的方法中一般已经内置了allowUnsafeKeys的配置项,不需要手动拼接URL参数

内容的提问来源于stack exchange,提问作者Pratik Sharma

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.01 15:57:00