Restore Element (XMLA)

Restores a Microsoft SQL Server Analysis Services database from a backup file.



Element Characteristics



Data type and length


Default value



0-n: Optional element that can occur more than once.

Element Relationships



Parent elements


Child elements

AllowOverwrite, DatabaseName, File, Locations, Password, Security, DbStorageLocation


The Restore command restores an Analysis Services database specified in the DatabaseName element from a backup file and optionally restores remote partitions from remote backup files.

Depending on the storage mode used by objects stored in the backup file, the Restore command restores information as listed in the following table.

Storage mode


Multidimensional OLAP (MOLAP)

Source data, aggregations, and metadata


Aggregations and metadata

Relational OLAP (ROLAP)


During a Restore command, an exclusive lock is placed on the Analysis Services database specified in the DatabaseName element. The lock is released after the Restore command has completed.

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

Security noteSecurity Note

For each backup file, the user who runs the restore command must have permission to read from the backup location specified for each file. To restore an Analysis Services database that is not installed on the server, the user must also be a member of the server role for that Analysis Services instance. To overwrite an Analysis Services database, the user must have one of the following roles: a member of the server role for the Analysis Services instance, or a member of a database role with Full Control (Administrator) permissions on the database to be restored.


After restoring an existing database, the user who restored the database might lose access to the restored database. This loss of access can occur if, at the time that the backup was performed, the user was not a member of the server role or was not a member of the database role with Full Control (Administrator) permissions.