Compartir a través de


Comando Restore (TMSL)

Se aplica a: SQL Server 2016 y versiones posteriores Analysis Services Azure Analysis Services Fabric/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 va a usar para descifrar el archivo de copia de seguridad.
allowOverwrite False Un 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 Ubicación de almacenamiento 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 siguientes maneras:

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

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

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

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