StorageBoundInMB Element (DTA)

Article
03/03/2023

Applies to: SQL Server

Specifies the maximum space in megabytes that can be consumed by the Database Engine Tuning Advisor tuning recommendation (index and partitioning set).

Syntax

  
<DTAInput>  
...code removed...  
    <TuningOptions>  
      <StorageBoundInMB>...</ StorageBoundInMB >

Element Characteristics

Characteristic	Description
Data type and length	unsignedInt, unlimited length.
Default value	None.
Occurrence	Optional. Can only be used once for the TuningOptions element.

Element Relationships

Relationship	Elements
Parent element	TuningOptions Element (DTA)
Child elements	None

Remarks

When multiple databases are tuned, recommendations for all databases are considered for the space calculation. By default, Database Engine Tuning Advisor assumes the smaller of the following storage sizes:

Three times the current raw data size, which includes the total size of heaps and clustered indexes on tables.
The free space on all attached disk drives plus the raw data size.

The default storage size does not include nonclustered indexes and indexed views.

If the value specified for the StorageBoundInMB element exceeds the actual disk space, Database Engine Tuning Advisor returns an error, but continues tuning. After tuning is complete, you can add disk space if you decide to implement the recommendation.

Example

Description

The following code example shows how to set a limit of 1500 megabytes as the maximum disk space that a tuning recommendation can consume:

Code

<DTAInput>  
  <Server>...</Server>  
  <Workload>...</Workload>  
  <TuningOptions>  
    <StorageBoundInMB>1500</StorageBoundInMB>  
...code removed here...  
</DTAInput>