Restore 命令 (TMSL)

适用于:SQL Server 2016 及更高版本的 Analysis Services Azure Analysis Services Fabric/Power BI Premium

从备份文件还原表格数据库。

请求

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

还原 具有多个属性。

属性 默认 说明
database [必需] 要还原的数据库对象的名称。
文件 [必需] 备份文件名/路径。
password 用于解密备份文件的密码。
allowOverwrite False 如果为 true,则指示已存在的备份文件将被覆盖的布尔值;否则为 false。
readWriteMode readWrite 一个枚举值,该值指示数据库允许的访问模式。

枚举值如下:

readWrite – 允许读写访问。

readOnly - 允许只读访问。

readOnlyExclusive - 允许只读独占访问。
dbStorageLocation 还原数据库的存储位置。

响应

命令成功时返回空结果。 否则,将返回 XMLA 异常。

示例

示例 1 - 从本地文件夹还原数据库。

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

使用情况 (终结点)

此命令元素用于执行方法的语句, (XMLA) 通过 XMLA 终结点调用,以下列方式公开:

  • 作为 SQL Server Management Studio (SSMS) 中的 XMLA 窗口

  • 作为 invoke-ascmd PowerShell cmdlet 的输入文件

  • 作为 SSIS 任务或SQL Server 代理作业的输入

可以通过单击“还原”对话框中的“脚本”按钮,从 SSMS 为此命令生成现成的脚本。