Restore, commande (TMSL)

S’applique à : SQL Server 2016 et versions ultérieures Analysis Services Azure Analysis Services Fabric/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 du fichier de sauvegarde.
mot de passe Vide Mot de passe à utiliser pour déchiffrer le fichier de sauvegarde.
allowOverwrite False Boolean qui, quand la valeur est 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é.

readOnlyExclusive : l’accès exclusif en lecture seule est autorisé.
dbStorageLocation Vide Emplacement de stockage de la base de données restaurée.

response

Retourne un résultat vide lorsque la commande réussit. Sinon, 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 execute method (XMLA) sur un point de terminaison XMLA, exposé 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 dans une tâche SSIS ou SQL Server Agent travail

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.