Restore, commande (TMSL)

S’applique à : SQL Server 2016 et ultérieur Analysis Services Azure Analysis Services Power BI Premium

Restaure une base de données tabulaire à partir d’un fichier de sauvegarde.

Requête

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

La restauration a plusieurs propriétés.

Propriété Default Description
database [Obligatoire] Nom de l’objet de base de données à restaurer.
fichier [Obligatoire] Nom/chemin d’accès du fichier de sauvegarde.
mot de passe Vide Mot de passe à utiliser pour déchiffrer le fichier de sauvegarde.
allowOverwrite False Valeur booléenne qui, lorsqu’elle a la valeur true, indique qu’un fichier de sauvegarde qui existe déjà sera remplacé ; Sinon, false.
readWriteMode readWrite Valeur d’énumération qui indique les modes d’accès autorisés à la base de données.

Les valeurs d'énumération sont les suivantes :

readWrite : l’accès en lecture/écriture est autorisé.

readOnly : l’accès en lecture seule est autorisé.

En readonlyexclusive : l’accès exclusif en lecture seule est autorisé.
dbStorageLocation Vide Stockage emplacement de la base de données restaurée.

response

Retourne un résultat vide lorsque la commande aboutit. Dans le cas contraire, une exception XMLA est retournée.

Exemple

Exemple 1 : restaurer une base de données à partir d’un dossier local.

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

Utilisation (points de terminaison)

Cet élément de commande est utilisé dans une instruction de l’appel de la méthode Execute (XMLA) sur un point de terminaison XMLA, exposée des manières suivantes :

  • en tant que fenêtre XMLA dans SQL Server Management Studio (SSMS)

  • En tant que fichier d’entrée de l’applet de commande PowerShell Invoke-ascmd

  • en tant qu’entrée d’une tâche SSIS ou d’un travail de l’Agent de SQL Server

vous pouvez générer un script prêt à l’emploi pour cette commande à partir de SSMS en cliquant sur le bouton script de la boîte de dialogue restaurer.