Comando Restore (TMSL)

  • Articolo

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.