Backup Element (XMLA)

 

Applies To: SQL Server 2016 Preview

Backs up a Microsoft SQL Server Analysis Services database to a backup file.

  
<Command>  
   <Backup>  
      <Object>...</Object>  
      <File>...</File>  
      <Security>...</Security>  
      <ApplyCompression>...</ApplyCompression>  
      <AllowOverwrite>...</AllowOverwrite>  
      <Password>...</Password>  
      <BackupRemotePartitions>...</BackupRemotePartitions>  
      <Locations>...</Locations>  
   </Backup>  
</Command>  

CharacteristicDescription
Data type and lengthNone
Default valueNone
Cardinality0-n: Optional element that can occur more than once.
RelationshipElement
Parent elementsCommand
Child elementsAllowOverwrite, ApplyCompression, BackupRemotePartitions, File, Locations, Object, Password, Security

The Backup command backs up the Analysis Services database specified in the Object element to a backup file, and optionally backs up remote partitions to remote backup files. If the Object element refers to an object other than an Analysis Services database, an error occurs.

Which information the Backup command backs up depends on the storage mode used by objects in the database. The following table identifies the information that is backed up based upon the storage mode used.

Storage modeInformation that is backed up
Multidimensional OLAP (MOLAP)Source data, aggregations, and metadata
Hybrid OLAP (HOLAP)Aggregations and metadata
Relational OLAP (ROLAP)Metadata

During a Backup command, a shared lock is placed on the Analysis Services database specified in the Object element. The shared lock releases after the Backup command has completed.

Multiple Backup commands can be run in parallel, if the commands are included in the Parallel collection of a Batch command. The Parallel collection enables a database to be backed up into multiple backup files at the same time.

For more information about backing up and restoring databases, see Backing Up, Restoring, and Synchronizing Databases (XMLA).

System_CAPS_ICON_important.jpg Important


For each backup file, the user who runs the backup command must have permission to write to the backup location specified for each file. Also, the user must have one of the following roles: a member of a server role for the Analysis Services instance, or a member of a database role with Full Control (Administrator) permissions on the database to be backed up.

Restore Element (XMLA)
Synchronize Element (XMLA)
Commands (XMLA)

Community Additions

ADD
Show: