Azure 认知搜索中的预览版功能
本文完整列出了公共预览版中的所有功能。 如果要检查功能状态，此列表非常有用。
预览功能根据补充使用条款提供，不附带服务级别协议，不建议用于生产工作负载。
此列表中未包括已转变为正式版的预览版功能。 如果某个功能未在下面列出，你可以认为该功能已正式发布。 有关正式版的公告，请查看服务更新或新增功能。
| Feature | 类别 | 说明 | 可用性 |
|---|---|---|---|
| Azure 文件存储索引器 | 索引器数据源 | 添加了 REST API 支持，用于为 Azure 文件存储创建索引器 | 公共预览版、搜索 REST API 2021-04-30 预览版。 发布日期：2021 年 11 月。 |
| 搜索 REST API 2021-04-30-Preview | 安全性 | 修改创建或更新数据源以支持 Microsoft Entra ID 下的托管标识，用于连接到外部数据源的索引器。 | 公共预览版、搜索 REST API 2021-04-30 预览版。 发布日期：2021 年 5 月。 |
| 管理 REST API 2021-04-01 预览版 | 安全性 | 修改创建或更新服务以支持新的 DataPlaneAuthOptions。 | 公共预览版、管理 REST API、API 版本 2021-04-01-Preview。 发布日期：2021 年 5 月。 |
| 重置文档 | 索引 | 重新处理了索引器工作负载中单独选择的搜索文档。 | 使用重置文档 REST API、API 版本的 2021-04-30 预览版或 2020-06-30 预览版。 |
| SharePoint 索引器 | 索引器数据源 | 用于 SharePoint 内容的基于索引器索引的新数据源。 | 你需要注册，然后我们才能在后端为你的订阅启用支持。 使用创建或更新数据源、API 版本的 2021-04-30 预览版或 2020-06-30 预览版或者 Azure 门户。 |
| MySQL 索引器数据源 | 索引器数据源 | 从 Auzre MySQL 数据源中索引内容和元数据。 | 你需要注册，然后我们才能在后端为你的订阅启用支持。 使用创建或更新数据源、API 版本的 2021-04-30 预览版或 2020-06-30 预览版、.NET SDK 11.2.1 或者 Azure 门户配置此数据源。 |
| Azure Cosmos DB 索引器：Azure Cosmos DB for MongoDB、Azure Cosmos DB for Apache Gremlin | 索引器数据源 | 对于 Azure Cosmos DB，SQL API 已正式发布，但 Azure Cosmos DB for MongoDB 和 Azure Cosmos DB for Apache Gremlin 目前为预览版。 | 对于 MongoDB 和 Gremlin，请先注册，这样我们才能在后端为你的订阅提供支持。 MongoDB 数据源可以在门户中配置。 使用创建或更新数据源配置此数据源，API 版本 2021-04-30-Preview 或 2020-06-30-Preview 。 |
| 本机 blob 软删除 | 索引器数据源 | Azure 认知搜索中的 Azure Blob 存储索引器会识别处于软删除状态的 blob，并在编制索引过程中删除相应的搜索文档。 | 使用创建或更新数据源配置此数据源，API 版本 2021-04-30-Preview 或 2020-06-30-Preview 。 |
| Normalizers | 查询 | Normalizers 提供简单的文本预处理：一致的大小写、删除重音和 ASCII 折叠，无需调用全文分析链。 | 使用搜索文档，API 版本 2021-04-30-Preview 或 2020-06-30-Preview。 |
| featuresMode 参数 | 相关性（评分） | 展开相关性分数以显示详细信息：单字段相似度得分、单字段术语频率，以及单字段匹配的唯一标记数。 你可以在自定义评分解决方案中使用这些数据点。 | 使用搜索文档添加此查询参数，API 版本 2021-04-30-Preview、2020-06-30-Preview 或 2019-05-06-Preview 。 |
| Azure 机器学习 (AML) 技能 | AI 扩充（技能） | 集成 Azure 机器学习推理终结点的新技能类型。 请先查看此教程。 | 使用搜索预览 REST API，API 版本 2021-04-30-Preview、2020-06-30-Preview 或 2019-05-06-Preview。 如果在同一订阅中部署了认知搜索和 Azure ML 服务，则门户的技能组设计中也会提供此技能。 |
| 增量扩充 | AI 扩充（技能） | 将缓存添加到扩充管道。如果有针对性的修改（例如更新技能集或另一对象）不会更改内容，则此功能可让你重复使用现有的输出。 缓存仅适用于技能集生成的扩充文档。 | 使用创建或更新索引器预览 REST API 添加此配置设置，API 版本 2021-04-30-Preview、2020-06-30-Preview 或 2019-05-06-Preview。 |
| moreLikeThis | 查询 | 查找与特定文档相关的文档。 早期预览版中已有此功能。 | 在搜索文档预览 REST API 调用中添加此查询参数，API 版本 2021-04-30-Preview、2020-06-30-Preview、2019-05-06-Preview、2016-09-01-Preview 或 2017-11-11-Preview。 |
如何调用预览版 REST API
Azure 认知搜索始终先通过 REST API，再通过 .NET SDK 的预发布版本来预发布实验功能。
预览功能可用于目的为针对功能设计和实现收集反馈的测试和试验。 为此，预览功能可能会随着时间的推移以破坏后向兼容性的方式进行更改。 这与 GA 版本中的功能形成鲜明对比，除了小型的后向兼容性修补程序和增强功能外，这些功能很稳定，不太可能发生变化。 此外，预览版功能并不是总会纳入 GA 版本。
虽然某些预览版功能在门户和 .NET SDK 中可能可用，但 REST API 始终具有预览版功能。
对于搜索操作，当前预览版版本为
2021-04-30-Preview。对于管理操作，当前预览版版本为
2021-04-01-Preview。
早期预览版仍然可用，但随着时间推移会变得过时。 如果代码调用 api-version=2019-05-06-Preview、api-version=2016-09-01-Preview 或 api-version=2017-11-11-Preview，这些调用仍然有效，但这些版本将不包含新功能，并且不保证 bug 修补程序。
以下示例语法说明了对预览 API 版本的调用。
POST https://[service name].search.azure.cn/indexes/hotels-idx/docs/search?api-version=2021-04-30-Preview
Content-Type: application/json
api-key: [admin key]
Azure 认知搜索服务在多个版本和客户端库内可用。 有关详细信息，请参阅 API 版本。
后续步骤
查看搜索 REST 预览版 API 参考文档。 如果遇到问题，请通过 StackOverflow 向我们寻求帮助，或联系支持人员。