Comando Restore (TMSL)

Si applica a: SQL Server 2016 e versioni successive di Analysis Services Azure Analysis Services Fabric/Power BI Premium

Ripristina un database tabulare da un file di backup.

Richiesta

    {  
"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"  
                ]  
. . .   

Il ripristino ha diverse proprietà.

Proprietà	Predefinito	Descrizione
database	[Obbligatorio]	Nome dell'oggetto di database da ripristinare.
file	[Obbligatorio]	Nome file di backup/percorso.
password	Empty	Password da usare per decrittografare il file di backup.
allowOverwrite	Falso	Valore booleano che, quando true, indica che un file di backup già esistente verrà sovrascritto; in caso contrario false.
Readwritemode	Readwrite	Valore di enumerazione che indica le modalità di accesso consentite al database. I valori di enumerazione sono i seguenti: readWrite: l'accesso in lettura-scrittura è consentito. readOnly: l'accesso di sola lettura è consentito. readOnlyExclusive: è consentito l'accesso esclusivo di sola lettura.
dbStorageLocation	Empty	Percorso di archiviazione per il database ripristinato.

Risposta

Restituisce un risultato vuoto quando il comando ha esito positivo. In caso contrario, viene restituita un'eccezione XMLA.

Esempio

Esempio 1 : ripristinare un database da una cartella locale.

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

Utilizzo (endpoint)

Questo elemento di comando viene usato in un'istruzione del metodo Execute (XMLA) chiamata su un endpoint XMLA esposto nei modi seguenti:

• Come finestra XMLA in SQL Server Management Studio (SSMS)

• Come file di input per il cmdlet invoke-ascmd di PowerShell

• Come input per un'attività SSIS o un processo SQL Server Agent

È possibile generare uno script pronto per questo comando da SSMS facendo clic sul pulsante Script nella finestra di dialogo Ripristina.