Azure SQL Memory Grants Test

When a query is parsed and compiled initially, it will consume compile or optimizer memory. Once the query is compiled that memory is released and the resulting query plan must be stored in cache. For that, the plan will consume plan cache memory and will stay in the cache until the Microsoft Azure SQL database is restarted or memory pressure occurs. Once a plan is cached, the query is ready for execution. If the query happens to be performing any sort operations or hash match (join or aggregates), then it will first reserve and later be granted to use part, or all, of the reserved memory for sort results or hash buckets. These memory operations during the execution of a query are collectively termed as Memory Grants, QE Reservations, Execution Memory, Workspace memory and Memory Reservations.

When the Azure SQL database grants the requested memory to an executing query it is said that a memory grant has occurred. If any delays are noticed in granting the requested memory, then the execution time of the query too may increase considerably. To avoid such unnecessary delays and to proactively detect such delays, it is essential for the administrators to keep a constant vigil on the memory grants of the database. The Azure SQL Memory Grants test helps administrators in this regard!

This test helps administrators figure out the maximum wait time for which the query should wait for the requested memory and the maximum amount of memory consumed by a query for execution. Besides, this test also throws light on the count of queries that are still waiting for the requested memory for execution. The detailed diagnostics lists the queries that are taking longer than usual time for execution.

Target of the test : A Microsoft Azure SQL database

Agent deploying the test : A remote agent

Outputs of the test : One set of results for the Azure SQL database that is configured for monitoring.

Configurable parameters for the test
Parameters Description

Test Period

How often should the test be executed.


The host for which the test is to be configured.


The port at which the specified Host listens.

Database Name

Specify the name of the Azure SQL database that is to be monitored.

User Name and Password

Against the User Name and Password parameters, specify the credentials of the user who is vested with DBOWNER rights to the configured Database Name.

Confirm Password

Confirm the specified Password by retyping it here.


If the Azure SQL database service being monitored is SSL-enabled, then set the SSL flag to Yes. If not, then set the SSL flag to No.


By default, none is displayed in this text box. If the ‘SQL server and Windows’ authentication has been enabled for the Azure SQL database being monitored, then the Domain parameter can continue to be none. On the other hand, if ‘Windows only’ authentication has been enabled, then, in the Domain text box, specify the Windows domain in which the monitored database exists. Also, in such a case, the User Name and Password that you provide should be that of a 'domain user' with DBOWNER rights to the configured Database Name.


In some Windows networks, NTLM (NT LAN Manager) may be enabled. NTLM is a suite of Microsoft security protocols that provides authentication, integrity, and confidentiality to users. NTLM version 2 (“NTLMv2”) was concocted to address the security issues present in NTLM. By default, this flag is set to No, indicating that NTLMv2 is not enabled by default for the target Microsoft Azure SQL database. Set this flag to Yes if NTLMv2 is enabled for the target database.

Detailed Diagnosis

To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.

The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

  • The eG manager license should allow the detailed diagnosis capability

  • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.

Measurements made by the test
Measurement Description Measurement Unit Interpretation

Maximum memory consumed by query

Indicates the maximum amount of memory consumed by a query executing on this database.



Queries waiting for memory

Indicates the number of queries waiting for memory in this database.



Maximum query cost by memory

Indicates the maximum query cost based on memory of this database.


A high value for this measure is a cause of concern.

Maximum wait duration for memory

Indicates the maximum time for which the query had to wait for memory in this database.


A high value for this measure is a cause of concern as this may sometimes indicate that the database is inaccessible.