Comando Restore (TMSL)

Si applica a: SQL Server 2016 e versioni successive Analysis Services Azure Analysis Services 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/percorso del file di backup.
password Empty Password da usare per decrittografare il file di backup.
allowOverwrite Falso Valore booleano che, se 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: è consentito l'accesso in lettura/scrittura.

readOnly: è consentito l'accesso in sola lettura.

readOnlyExclusive: è consentito l'accesso esclusivo di sola lettura.
dbStorageLocation Empty Archiviazione percorso del 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 della chiamata al metodo Execute (XMLA) su un endpoint XMLA, esposto nei modi seguenti:

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

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

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

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