使用 Microsoft 搜索 API 为数据编制索引Use the Microsoft Search API to index data

重要

/betaMicrosoft Graph 中的版本下的 api 可能会发生更改。APIs under the /beta version in Microsoft Graph are subject to change. 不支持在生产应用程序中使用这些 API。Use of these APIs in production applications is not supported. 若要确定 API 在 v1.0 中是否可用,请使用 版本 选择器。To determine whether an API is available in v1.0, use the Version selector.

可使用 Microsoft Graph 将自定义项添加到 Microsoft 搜索体验的搜索结果中。You can use Microsoft Graph to add custom items to search results in the Microsoft Search experience.

在无已登录用户的情况下,以应用程序的身份请求为数据编制索引,并使用包含应用程序权限的访问令牌进行标识。Requests to index data are performed on behalf of an application without the presence of a signed-in user, identified using an access token with application permission.

重要

Microsoft Graph 连接器当前处于公共预览状态。Microsoft Graph connectors and are currently in public preview status. 为了获取对连接器功能的访问权限,必须在租户中打开目标发布选项。To gain access to connectors functionality, you must turn on the Targeted release option in your tenant. 有关详细信息,请参阅连接器预览计划See more details on the connectors preview program.

常见用例Common use cases

此部分中的 API 用例涉及到构建 Microsoft Graph 连接器,其中包括以下主要步骤:The use cases for the APIs in this section involve building Microsoft Graph connectors, which involves the following primary steps:

  1. 与外部数据源建立连接Create a connection to an external data source.
  2. 创建并注册架构,以描述类型及外部数据的索引编制方式。Create and register a schema that describes the type and how to index the external data.
  3. 将数据作为外部项编制索引Index the data as an external item.
用例Use cases REST 资源REST resources 另请参阅See also
配置操作Configuration actions
建立、更新或删除连接Create, update, or delete a connection externalConnectionexternalConnection externalConnection 方法externalConnection methods
注册外部数据的架构Register a schema for the external data schemaschema schema 方法schema methods
为操作编制索引Indexing actions
在索引中添加、更新或删除自定义项Add, update or delete a custom item in the index externalItemexternalItem externalItem 方法externalItem methods

已知限制Known limitations

当前已知的限制如下:The following are current knownlimitations:

  • 组织最多可有 10 个连接。Organizations are limited to a maximum of 10 connections.
  • 仅支持 Azure Active Directory 标识。Only Azure Active Directory identities are supported.
  • 每秒只能创建 4 个 externalItem 资源项。You can create only four externalItem resources items per second.
  • 应用程序最多可对一个连接执行 4 个并行操作。An application is limited to four concurrent operations on a connection.
  • 连接的容量限制为 70 万个项,或约 70 GB 的数据。Connections have a capacity limit of 700,000 items or ~70 GB of data.
  • externalItem 实体的最大大小为 4 MB。Maximum size of an externalItem entity is 4 MB.
  • 不支持对结果进行排序。Sorting results is not supported.
  • 最多可以进行结果排名。Result ranking is best effort.

最近更新What's new

了解此 API 集的最新功能和更新Find out about the latest new features and updates for this API set.

后续步骤Next steps