query-throttling.md

ms.date	title	ms.reviewer	ms.author	author	manager	recommendations	audience	f1.keywords	ms.topic	ms.service	ms.collection	ms.custom	ms.localizationpriority	search.appverid	ms.assetid	description
07/11/2018	Manage query client types		ruihu	maggierui	jtremper	true	Admin	NOCSH	article	sharepoint-online	M365-collaboration	admindeeplinkSPO	medium	SPS150 SPO160 MET150	0d335bc4-e7a0-46bc-ba40-da34e414174f	Learn how query client types decide in which order queries are performed.

Manage query client types

[!INCLUDEappliesto-2013-2016-2019-SUB-xxx-md]

Learn how query client types decide in which order queries are performed.

A query client type is how a client performing a query tells the system what type of client it is. For example, a client might tell us it is UI, or an automated query. Query throttling monitors the use of resources and protects the search system. Administrators can use client-type information for throttling, to make sure lower-priority clients like automated queries don't squeeze out higher-priority clients like UI. Query client types are also used for things like logging, reports, and determining relevance.

The client sets the client type as a label in the query. The administrator configures the valid client types (though some are default and mandatory), and the client chooses one for each query.

Note

You can't turn query throttling on or off.

Add a query client type

Note

You can change the name of a client type that has been created for your tenant only.

1. Go to More features in the SharePoint admin center, and sign in with an account that has admin permissions for your organization.

Note

If you have Office 365 operated by 21Vianet (China), sign in to the Microsoft 365 admin center, then browse to the SharePoint admin center and open the More features page.

2. Under Search, select Open.

3. On the search administration page, select Manage Query Client Types.

4. To add a client type, select New Client Type.

5. On the Edit a client type page, in the Query Client Type field, for the client type, enter a name.

6. From the Throttling Tier list, select either Top, Middle, or Bottom.

   [!NOTE] Lower priority queries are throttled first. The search system processes queries from top tier to bottom tier.

7. Select OK.

Prioritize a client query type

You can use throttling tiers to prioritize query processing. When the resource limit is reached, query throttling kicks in, and the search system processes queries, starting from the top tier, right through to the bottom tier.

1. Go to More features in the SharePoint admin center, and sign in with an account that has admin permissions for your organization.

Note

If you have Office 365 operated by 21Vianet (China), sign in to the Microsoft 365 admin center, then browse to the SharePoint admin center and open the More features page.

2. Under Search, select Open.

3. On the search administration page, select Manage Query Client Types.

4. Go to the Client Type section, and select the System Type that you want to change.

5. From the Throttling Tier list, select either Top, Middle, or Bottom.

   [!NOTE] Lower priority queries are throttled first. The search system processes queries from top tier to bottom tier.

6. Select OK.