droponlymode-element-dta.md

title	DropOnlyMode Element (DTA)
description	In the dta utility, DropOnlyMode element specifies that Database Engine Tuning Advisor only considers dropping existing indexes, indexed views, or partitions.
author	rwestMSFT
ms.author	randolphwest
ms.date	03/01/2017
ms.service	sql
ms.subservice	tools-other
ms.topic	reference
ms.collection	data-tools
helpviewer_keywords	DropOnlyMode element
dev_langs	XML

DropOnlyMode Element (DTA)

[!INCLUDE SQL Server]

Specifies that Database Engine Tuning Advisor should only consider dropping existing indexes, indexed views, or partitions during the tuning session. No new physical design structures are considered when this tuning option is specified.

Syntax

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

Element Characteristics

Data type and length

Default value

Occurrence: Optional. Can be used only once for each TuningOptions element. Cannot be used if the following elements are specified in the TuningOptions element:

• FeatureSet Element (DTA)

• Partitioning Element (DTA)

• KeepExisting Element (DTA) is set to ALL

Element Relationships

Parent element: TuningOptions Element (DTA)

Child elements

Example

The following example shows the TuningOptions section of a Database Engine Tuning Advisor XML input file where the DropOnlyMode is specified. In this example the tuning time is limited to 24 hours (1440 minutes) and all existing clustered and nonclustered indexes will be considered for dropping:

<TuningOptions  
  <TuningTimeInMin>1440</Name>  
  <KeepExisting>ALIGNED</KeepExisting>  
  <DropOnlyMode />  
</TuningOptions>  

See Also

XML Input File Reference (Database Engine Tuning Advisor)