Backup Element (XMLA)
Backs up a Analysis Services database to a backup file.
Syntax
<Command>
<Backup>
<Object>...</Object>
<File>...</File>
<Security>...</Security>
<ApplyCompression>...</ApplyCompression>
<AllowOverwrite>...</AllowOverwrite>
<Password>...</Password>
<BackupRemotePartitions>...</BackupRemotePartitions>
<Locations>...</Locations>
</Backup>
</Command>
Element characteristics
Characteristic | Description |
---|---|
Data type and length | None |
Default value | None |
Cardinality | 0-n: Optional element that can occur more than once. |
Element relationships
Relationship | Element |
---|---|
Parent elements | Command |
Child elements | AllowOverwrite, ApplyCompression, BackupRemotePartitions, File, Locations, Object, Password, Security |
Remarks
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 mode | Information 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.
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.