Comando Restore (TMSL)

Se aplica a: SQL Server 2016 y versiones posteriores Analysis Services Azure Analysis Services Power BI Premium

Restaura una base de datos tabular a partir de un archivo de copia de seguridad.

Solicitud

    {  
"restore": {  
            "description": "Parameters of Restore command of Analysis Services JSON API",  
            "properties": {  
            "database": {  
                "type": "string"  
            },  
            "file": {  
                "type": "string"  
            },  
            "password": {  
                "type": "string"  
            },  
            "dbStorageLocation": {  
                "type": "string"  
            },  
            "allowOverwrite": {  
                "type":boolean  
            },  
            "readWriteMode": {  
                "enum": [  
                "readWrite",  
                "readOnly",  
                "readOnlyExclusive"  
                ]  
. . .   

La restauración tiene varias propiedades.

Propiedad	Valor predeterminado	Descripción
database	[Obligatorio]	Nombre del objeto de base de datos que se va a restaurar.
archivo	[Obligatorio]	Nombre o ruta de acceso del archivo de copia de seguridad.
password	Vacío	Contraseña que se usará para descifrar el archivo de copia de seguridad.
allowOverwrite	False	Valor booleano que, cuando es true, indica que se sobrescribirá un archivo de copia de seguridad que ya existe; en caso contrario, false.
readWriteMode	readWrite	Valor de enumeración que indica los modos de acceso permitidos a la base de datos. Los valores de enumeración son los siguientes: readWrite: se permite el acceso de lectura y escritura. readOnly: se permite el acceso de solo lectura. readOnlyExclusive: se permite el acceso exclusivo de solo lectura.
dbStorageLocation	Vacío	Storage de la base de datos restaurada.

Response

Devuelve un resultado vacío cuando el comando se realiza correctamente. De lo contrario, se devuelve una excepción XMLA.

Ejemplo

Ejemplo 1 : restauración de una base de datos desde una carpeta local.

{   
   "restore": {   
      "database":"AdventureWorksDW2014",  
      "file":"c:\\awdbdwfile.abf",  
      "security":"...",  
      "allowOverwrite":"true",  
      "password":"..",  
      "locations":"d:\\SQL Server Analysis Services\\data\\",  
      "storageLocation":".."  
   }  
}  

Uso (puntos de conexión)

Este elemento de comando se usa en una instrucción de la llamada al método Execute (XMLA) a través de un punto de conexión XMLA, expuesto de las maneras siguientes:

• Como una ventana XMLA en SQL Server Management Studio (SSMS)

• Como archivo de entrada para el cmdlet invoke-ascmd de PowerShell

• Como entrada a una tarea de SSIS o Agente SQL Server trabajo

Puede generar un script listo para este comando desde SSMS clic en el botón Script del cuadro de diálogo Restaurar .