Comando Backup (TMSL)

  • Articolo

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

Esegue il backup di un database tabulare in un file di backup con estensione abf.

Richiesta

    {  
        "backup": {  
            "description": "Parameters of Backup command of Analysis Services JSON API",  
            "properties": {  
            "database": {  
                "type": "string"  
            },  
            "file": {  
                "type": "string"  
            },  
            "password": {  
                "type": "string"  
            },  
            "allowOverwrite": {  
                "type": "boolean"  
            },  
            "applyCompression": {  
                "type": "boolean"  
            }  
            },  
. . .

Il backup ha diverse proprietà.

Proprietà Predefinito Descrizione
database [Obbligatorio] Nome dell'oggetto di database da eseguire il backup.
file [Obbligatorio] Nome file di backup/percorso.
password Empty Password da usare per crittografare 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.
applyCompression Vero Valore booleano che, se true, indica che i file di backup vengono compressi; in caso contrario false.

Risposta

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

Esempio

Esempio 1 : eseguire il backup di un file nella cartella di backup predefinita.

{   
   "backup": {   
      "database":"AS_AdventureWorksDW2014",  
      "file":"AS_AdventureWorksDW2014.abf",  
      "password":"secret"  
   }  
}

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 Database di backup.