Restore-Befehl (TMSL)

  • Artikel

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

Stellt eine tabellarische Datenbank aus einer Sicherungsdatei wieder her.

Anforderung

    {  
"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"  
                ]  
. . .

Die Wiederherstellung verfügt über mehrere Eigenschaften.

Eigenschaft Standard Beschreibung
database [Pflichtfeld] Der Name des wiederherzustellenden Datenbankobjekts.
file [Pflichtfeld] Der Name/Pfad der Sicherungsdatei.
password Leer Das Kennwort, das zum Entschlüsseln der Sicherungsdatei verwendet werden soll.
Allowoverwrite False Ein boolescher Wert, der bei TRUE angibt, dass eine bereits vorhandene Sicherungsdatei überschrieben wird. andernfalls false.
Readwritemode readWrite Ein Enumerationswert, der die Zugriffsmodi angibt, die für die Datenbank zulässig sind.

Folgende Enumerationswerte sind möglich:

readWrite: Lese-/Schreibzugriff ist zulässig.

readOnly: Schreibgeschützter Zugriff ist zulässig.

readOnlyExclusive: Schreibgeschützter exklusiver Zugriff ist zulässig.
dbStorageLocation Leer Speicherort für die wiederhergestellte Datenbank.

Antwort

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

Beispiel

Beispiel 1 : Wiederherstellen einer Datenbank aus einem lokalen Ordner.

{   
   "restore": {   
      "database":"AdventureWorksDW2014",  
      "file":"c:\\awdbdwfile.abf",  
      "security":"...",  
      "allowOverwrite":"true",  
      "password":"..",  
      "locations":"d:\\SQL Server Analysis Services\\data\\",  
      "storageLocation":".."  
   }  
}

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 vorgefertigtes Skript für diesen Befehl aus SSMS generieren, indem Sie im Dialogfeld Wiederherstellen auf die Schaltfläche Skript klicken.