Restore Element (XMLA)
Restores a Analysis Services database from a backup file.
<Command> <Restore> <DatabaseName>...</DatabaseName> <DatabaseID>...</DatabaseID> <File>...</File> <Security>...</Security> <AllowOverwrite>...</AllowOverwrite> <Password>...</Password> <Locations>...</Locations> <DbStorageLocation>...</DbStorageLocation> </Restore> </Command>
|Data type and length||None|
|Cardinality||0-n: Optional element that can occur more than once.|
|Child elements||AllowOverwrite, DatabaseName, DatabaseID, 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.
|Multidimensional OLAP (MOLAP)||Source data, aggregations, and metadata|
|Hybrid OLAP (HOLAP)||Aggregations and metadata|
|Relational OLAP (ROLAP)||Metadata|
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 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.