Skip to content

configure-the-min-memory-per-query-server-configuration-option.md

Latest commit

 

History

History
111 lines (77 loc) · 6.17 KB

configure-the-min-memory-per-query-server-configuration-option.md

File metadata and controls

111 lines (77 loc) · 6.17 KB
title Configure the min memory per query Server Configuration Option | Microsoft Docs
ms.custom
ms.date 11/24/2017
ms.prod sql-non-specified
ms.prod_service database-engine
ms.service
ms.component configure-windows
ms.reviewer
ms.suite sql
ms.technology
database-engine
ms.tgt_pltfrm
ms.topic article
helpviewer_keywords
memory [SQL Server], queries
minimum query memory
queries [SQL Server], memory
min memory per query option
ms.assetid ecd3fb79-b4a6-432f-9ef5-530e0d42d5a6
caps.latest.revision 28
author BYHAM
ms.author rickbyh
manager jhubbard
ms.workload Inactive

Configure the min memory per query Server Configuration Option

[!INCLUDEappliesto-ss-xxxx-xxxx-xxx-md]

This topic describes how to configure the min memory per query server configuration option in [!INCLUDEssNoVersion] by using [!INCLUDEssManStudioFull] or [!INCLUDEtsql]. The min memory per query option specifies the minimum amount of memory (in kilobytes) that will be allocated for the execution of a query. For example, if min memory per query is set to 2,048 KB, the query is guaranteed to get at least that much total memory. The default value is 1,024 KB. The minimum value 512 KB, and the maximum is 2,147,483,647 KB (2 GB).

In This Topic

Before You Begin

Limitations and Restrictions

  • The amount of min memory per query has precedence over the index create memory option. If you modify both options and the index create memory is less than min memory per query, you receive a warning message, but the value is set. During query execution you receive another similar warning.

Recommendations

  • This option is an advanced option and should be changed only by an experienced database administrator or certified [!INCLUDEssNoVersion] technician.

  • The [!INCLUDEssNoVersion] query processor tries to determine the optimal amount of memory to allocate to a query. The min memory per query option lets the administrator specify the minimum amount of memory any single query receives. Queries generally receive more memory than this if they have hash and sort operations on a large volume of data. Increasing the value of min memory per query may improve performance for some small to medium-sized queries, but doing so could lead to increased competition for memory resources. The min memory per query option includes memory allocated for sort operations.

  • Do not set the min memory per query server configuration option too high, especially on very busy systems, because the query has to wait until it can secure the minimum memory requested or until the value specified in the query wait server configuration option is exceeded. If more memory is available than the specified minimum value required to execute the query, the query is allowed to make use of the additional memory, provided that the memory can be used effectively by the query.

Security

Permissions

Execute permissions on sp_configure with no parameters or with only the first parameter are granted to all users by default. To execute sp_configure with both parameters to change a configuration option or to run the RECONFIGURE statement, a user must be granted the ALTER SETTINGS server-level permission. The ALTER SETTINGS permission is implicitly held by the sysadmin and serveradmin fixed server roles.

Using SQL Server Management Studio

To configure the min memory per query option

  1. In Object Explorer, right-click a server and select Properties.

  2. Click the Memory node.

  3. In the Minimum memory per query box, enter the minimum amount of memory (in kilobytes) that will be allocated for the execution of a query.

Using Transact-SQL

To configure the min memory per query option

  1. Connect to the [!INCLUDEssDE].

  2. From the Standard bar, click New Query.

  3. Copy and paste the following example into the query window and click Execute. This example shows how to use sp_configure to set the value of the min memory per query option to 3500 KB.

USE AdventureWorks2012 ;  
GO  
EXEC sp_configure 'show advanced options', 1;  
GO  
RECONFIGURE ;  
GO  
EXEC sp_configure 'min memory per query', 3500 ;  
GO  
RECONFIGURE;  
GO

Follow Up: After you configure the min memory per query option

The setting takes effect immediately without restarting the server.

See Also

RECONFIGURE (Transact-SQL)
Server Configuration Options (SQL Server)
sp_configure (Transact-SQL)
Configure the index create memory Server Configuration Option