Backup-Befehl (TMSL)

  • Artikel

Gilt für: SQL Server 2016 und höher Analysis Services Azure Analysis Services Fabric/Power BI Premium

Sichert eine tabellarische Datenbank in einer ABF-Sicherungsdatei.

Anforderung

    {  
        "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"  
            }  
            },  
. . .

Die Sicherung verfügt über mehrere Eigenschaften.

Eigenschaft Standard Beschreibung
database [Pflichtfeld] Der Name des zu sichernden Datenbankobjekts.
file [Pflichtfeld] Der Name/Pfad der Sicherungsdatei.
password Leer Das Kennwort, das zum Verschlüsseln der Sicherungsdatei verwendet werden soll.
Allowoverwrite False Ein boolescher Wert, der bei true angibt, dass eine bereits vorhandene Sicherungsdatei überschrieben wird. andernfalls false.
applyCompression True Ein boolescher Wert, der, wenn true, angibt, dass Sicherungsdateien komprimiert sind; andernfalls false.

Antwort

Gibt ein leeres Ergebnis zurück, wenn der Befehl erfolgreich ist. Andernfalls wird eine XMLA-Ausnahme zurückgegeben.

Beispiele

Beispiel 1 : Sichern einer Datei im Standardsicherungsordner.

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

Verwendung (Endpunkte)

Dieses Befehlselement wird in einer Anweisung des Aufrufs der Execute-Methode (XMLA) über einen XMLA-Endpunkt verwendet und auf folgende Weise verfügbar gemacht:

  • Als XMLA-Fenster in SQL Server Management Studio (SSMS)

  • Als Eingabedatei für das PowerShell-Cmdlet invoke-ascmd

  • Als Eingabe für einen SSIS-Task oder SQL Server-Agent Auftrag

Sie können ein fertiges Skript für diesen Befehl über SSMS generieren, indem Sie im Dialogfeld Datenbank sichern auf die Schaltfläche Skript klicken.