Azure 认知搜索中的预览版功能Preview features in Azure Cognitive Search

本文完整列出了公共预览版中的所有功能。This article is a comprehensive list of all features that are in public preview. 提供的预览版功能不附带服务级别协议,我们不建议将其用于生产工作负荷。Preview functionality is provided without a service level agreement, and is not recommended for production workloads.

此列表中未包括已转变为正式版的预览版功能。Preview features that transition to general availability are removed from this list. 如果某个功能未在下面列出,你可以认为该功能已正式发布。If a feature isn't listed below, you can assume it is generally available. 有关正式版的公告,请查看服务更新新增功能For announcements regarding general availability, see Service Updates or What's New.

功能                        Feature                         类别Category 说明Description 可用性Availability
featuresMode 参数featuresMode parameter 相关性(评分)Relevance (scoring) 展开相关性分数以显示详细信息:单字段相似度得分、单字段术语频率,以及单字段匹配的唯一标记数。Relevance score expansion to include details: per field similarity score, per field term frequency, and per field number of unique tokens matched. 你可以在自定义评分解决方案中使用这些数据点。You can consume these data points in custom scoring solutions. 使用 api-version 为 2020-06-30-Preview 或 2019-05-06-Preview 的搜索文档 (REST) 添加此查询参数。Add this query parameter using Search Documents (REST) with api-version=2020-06-30-Preview or 2019-05-06-Preview.
本机 blob 软删除Native blob soft delete 索引器、Azure blobIndexers, Azure blobs Azure 认知搜索中的 Azure Blob 存储索引器会识别处于软删除状态的 blob,并在编制索引过程中删除相应的搜索文档。The Azure Blob Storage indexer in Azure Cognitive Search will recognize blobs that are in a soft deleted state, and remove the corresponding search document during indexing. 使用 api-version=2020-06-30-Preview 或 api-version=2019-05-06-Preview 的创建索引器 (REST) 添加此配置设置。Add this configuration setting using Create Indexer (REST) with api-version=2020-06-30-Preview or api-version=2019-05-06-Preview.
自定义实体查找技能Custom Entity Lookup skill AI 扩充(技能组)AI enrichment (skillset) 可在用户自定义的单词和短语列表中查找文本的一项认知技能。A cognitive skill that looks for text from a custom, user-defined list of words and phrases. 它使用此列表为包含任何匹配实体的所有文档加上标签。Using this list, it labels all documents with any matching entities. 该技能还支持一定程度的模糊匹配,应用此匹配方法可以查找类似但不完全相同的匹配项。The skill also supports a degree of fuzzy matching that can be applied to find matches that are similar but not quite exact. 请使用门户中的技能组编辑器或使用 api-version=2020-06-30-Preview 或 api-version=2019-05-06-Preview 的创建技能组 (REST) 来引用此预览版技能。Reference this preview skill using the Skillset editor in the portal or Create Skillset (REST) with api-version=2020-06-30-Preview or api-version=2019-05-06-Preview.
PII 检测技能PII Detection skill AI 扩充(技能组)AI enrichment (skillset) 编制索引期间使用的一项认知技能,它可以从输入文本中提取个人身份信息,并可让你通过多种方式在该文本中屏蔽此类信息。A cognitive skill used during indexing that extracts personally identifiable information from an input text and gives you the option to mask it from that text in various ways. 请使用门户中的技能组编辑器或使用 api-version=2020-06-30-Preview 或 api-version=2019-05-06-Preview 的创建技能组 (REST) 来引用此预览版技能。Reference this preview skill using the Skillset editor in the portal or Create Skillset (REST) with api-version=2020-06-30-Preview or api-version=2019-05-06-Preview.
增量扩充Incremental enrichment 索引器配置Indexer configuration 将缓存添加到扩充管道。如果有针对性的修改(例如更新技能集或另一对象)不会更改内容,则此功能可让你重复使用现有的输出。Adds caching to an enrichment pipeline, allowing you to reuse existing output if a targeted modification, such as an update to a skillset or another object, does not change the content. 缓存仅适用于技能集生成的扩充文档。Caching applies only to enriched documents produced by a skillset. 使用 api-version=2020-06-30-Preview 或 api-version=2019-05-06-Preview 的创建索引器 (REST) 添加此配置设置。Add this configuration setting using Create Indexer (REST) with api-version=2020-06-30-Preview or api-version=2019-05-06-Preview.
Cosmos DB 索引器:MongoDB API、Gremlin API、Cassandra APICosmos DB indexer: MongoDB API, Gremlin API, Cassandra API 索引器数据源Indexer data source 对于 Cosmos DB,SQL API 已正式发布,但 MongoDB、Gremlin 和 Cassandra API 为预览版。For Cosmos DB, SQL API is generally available, but MongoDB, Gremlin, and Cassandra APIs are in preview. 先注册,以便我们可以在后端为你的订阅启用支持(仅适用于 Gremlin 和 Cassandra)。For Gremlin and Cassandra only, sign up first so that support can be enabled for your subscription on the backend. MongoDB 数据源可以在门户中配置。MongoDB data sources can be configured in the portal. 否则,使用 api-version=2020-06-30-Preview 或 api-version=2019-05-06-Preview 的创建数据源 (REST) 为所有三个 API 的数据源配置提供支持。Otherwise, data source configuration for all three APIs is supported using Create Data Source (REST) with api-version=2020-06-30-Preview or api-version=2019-05-06-Preview.
Azure Data Lake Storage Gen2 索引器Azure Data Lake Storage Gen2 indexer 索引器数据源Indexer data source 为 Data Lake Storage Gen2 中的内容和元数据编制索引。Index content and metadata from Data Lake Storage Gen2. 你需要注册,然后我们才能在后端为你的订阅启用支持。Sign up is required so that support can be enabled for your subscription on the backend. 使用 api-version=2020-06-30-Preview 或 api-version=2019-05-06-Preview 的创建数据源 (REST) 访问此数据源。Access this data source using Create Data Source (REST) with api-version=2020-06-30-Preview or api-version=2019-05-06-Preview.
moreLikeThismoreLikeThis 查询Query 查找与特定文档相关的文档。Finds documents that are relevant to a specific document. 早期预览版中已有此功能。This feature has been in earlier previews. 在 api-version 为 2020-06-30-Preview、2019-05-06-Preview、2016-09-01-Preview 或 2017-11-11-Preview 的搜索文档 (REST) 调用中添加此查询参数。Add this query parameter in Search Documents (REST) calls with api-version=2020-06-30-Preview, 2019-05-06-Preview, 2016-09-01-Preview, or 2017-11-11-Preview.

如何调用预览版 REST APIHow to call a preview REST API

Azure 认知搜索始终先通过 REST API 预发布实验功能,再通过 .NET SDK 的预发布版本进行发布。Azure Cognitive Search always pre-releases experimental features through the REST API first, then through prerelease versions of the .NET SDK.

预览功能可用于目的为针对功能设计和实现收集反馈的测试和试验。Preview features are available for testing and experimentation, with the goal of gathering feedback on feature design and implementation. 为此,预览功能可能会随着时间的推移以破坏后向兼容性的方式进行更改。For this reason, preview features can change over time, possibly in ways that break backwards compatibility. 这与 GA 版本中的功能形成鲜明对比,除了小型的后向兼容性修补程序和增强功能外,这些功能很稳定,不太可能发生变化。This is in contrast to features in a GA version, which are stable and unlikely to change with the exception of small backward-compatible fixes and enhancements. 此外,预览功能并不总是纳入 GA 版本。Also, preview features do not always make it into a GA release.

虽然某些预览版功能在门户和 .NET SDK 中可能可用,但 REST API 始终具有预览版功能。While some preview features might be available in the portal and .NET SDK, the REST API always has preview features.

早期预览版仍然可用,但随着时间推移会变得过时。Older previews are still operational but become stale over time. 如果代码调用 api-version=2019-05-06-Previewapi-version=2016-09-01-Previewapi-version=2017-11-11-Preview,则这些调用仍然有效。If your code calls api-version=2019-05-06-Preview or api-version=2016-09-01-Preview or api-version=2017-11-11-Preview, those calls are still valid. 但是,只有最新预览版会获得改进。However, only the newest preview version is refreshed with improvements.

以下示例语法说明了对预览 API 版本的调用。The following example syntax illustrates a call to the preview API version.

  POST https://[service name].search.azure.cn/indexes/hotels-idx/docs/search?api-version=2020-06-30-Preview
  Content-Type: application/json  
  api-key: [admin key]

Azure 认知搜索服务在多个版本内可用。Azure Cognitive Search service is available in multiple versions. 有关详细信息,请参阅 API 版本For more information, see API versions.

后续步骤Next steps

查看搜索 REST API 参考文档。Review the Search REST API reference documentation. 如果遇到问题,请通过 StackOverflow 向我们寻求帮助,或联系支持人员If you encounter problems, ask us for help on StackOverflow or contact support.