Comando Restore (TMSL)

Artículo
12/23/2023

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.

Share via