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.