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 feature 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.
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?
- How do I customize search results?
- What are the connector limitations
Microsoft Graph connectors and Microsoft Search APIs are now generally available. The first rollouts will be to customers configured for targeted release. If you want to use a Graph connector in your tenant, users and administrators must opt into Targeted release.
What data sources can be connected to Microsoft Search?
Microsoft provides 9 Graph connectors and our ecosystem partners have created over 100 more 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 and Microsoft SQL Server
- Enterprise websites
- File share
- Oracle SQL
- Salesforce (preview)
The Graph connectors gallery contains a brief description of each of these Graph connectors. If you're 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 description of each of the Graph connectors created by our partners, and a link to each partner's website. To learn more, contact each partner directly.
Build your own Graph connector
You can build your own Graph connector if you prefer. For more information on building Graph connectors, see the Overview of the Microsoft Search API in Microsoft Graph.
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
- Multiple connections in a vertical
How do I customize and configure search results?
There are many 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.
How do I customize search results?
The next step is to customize the search results as recommended in this article How do I customize and configure search results?. To learn more about customizing search results, see Customize the search results page.
What are the connector limitations?
When you publish a Microsoft-built connector, it can take a few minutes for the connection to be created. During that time, the connection will show its status as pending.
Ingestion throughput is throttled at approximately 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 connection limit. Each tenant can create up to 10 connections.
You cannot edit or change a connection after it has been created. If you need to change any details, you must delete and recreate the connection.