Overview of Microsoft Graph connectors
Microsoft Search indexes all your Microsoft 365 data to make it searchable for users. With Microsoft Graph connectors, your organization can index third-party data so it appears in Microsoft Search results. This expands the types of content sources that are searchable in your Microsoft 365 productivity apps and the broader Microsoft ecosystem. The third-party data can be hosted on-premises or in the public or private clouds.
The rest of this article is intended to help Microsoft 365 administrators locate the resources that are available to answer the following questions:
- What data sources can be connected to Microsoft Search?
- How do I manage my connections?
- What are the preview features?
- How do I customize and configure search results?
- How do I search my connector data from a custom application?
Microsoft Graph connectors and Microsoft Search APIs are now generally available. The first rollout is scheduled to last until February 2021. Until then, only tenants and users who have opted into Targeted release will be able to use Graph connectors. Upon rollout completion to all tenants, index quota utilization from connectors content will become subject to billing. See Licensing requirements and pricing for more information.
What data sources can be connected to Microsoft Search?
Microsoft provides ten Graph connectors and our ecosystem partners have created over 100 additional Graph connectors. You can also build your own Graph connector.
Graph connectors by Microsoft
You can connect to the following data sources using Graph connectors created by Microsoft:
- Azure Data Lake Storage Gen2
- Azure DevOps
- Azure SQL
- Enterprise websites
- Microsoft SQL Server
- File share
- Oracle (preview)
- Salesforce (preview)
The Graph connectors gallery contains a brief description of each of these Graph connectors. If you are ready to connect one of these data sources to your tenant, be sure to read the Setup overview and any other articles in the Setup connectors by Microsoft section that apply to your data source.
Graph connectors by our partners
The Microsoft Graph connectors gallery includes a brief descriptions of each of the Graph connectors created by our partners and a link to each partner's website. Contact each partner directly to learn more.
Build your own Graph connector
If you plan to build your own Graph connector, see the Overview of the Microsoft Search API in Microsoft Graph for more information.
How do I manage my connections?
You need a valid Microsoft 365 or Office 365 license and sufficient Graph Connectors quota for users in your organization to view data from connectors in their search results.
What are the preview features?
Although Microsoft Graph connectors and Microsoft Search APIs are now generally available, there are several features that are in preview.
The set of connectors and features in preview include:
- Azure DevOps connector
- Salesforce connector
- ServiceNow connector with search permissions that use source ACLs
- Manage result cluster
How do I customize and configure search results?
There are a number of ways to customize and configure search results. See the following articles to learn more:
- Manage verticals and result types
- Manage search result layouts
- Manage result cluster
- Manage custom filters
How do I search my connector data from a custom application?
After custom data is indexed, developers can query this data. You can view your data in any application. For more information, see the Overview of the Microsoft Search API in Microsoft Graph.
When you publish a Microsoft-built connector, it might take a few minutes for the connection to be created. During that time, the connection will show its status as pending.
The Microsoft 365 admin center doesn't support editing the search schema after a connection is published. To edit the search schema, delete your connection and then create a new one.
Ingestion throughput is throttled at about four items per second.
There is no support for schema updates. After you create a connection setup, there's no way to update the schema. You can only delete and re-create the connection.
There is a connections limit. Each tenant can create up to 10 connections.
Edit support for connection is not available. Once the connection has been created, you cannot edit or change it. If you need to change any details, you must delete and recreate the connection.