共用方式為

還原指令 （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"  
                ]  
. . .

還原 有數個屬性。

財產 違約 描述
資料庫 [必要] 要還原之資料庫對象的名稱。
檔 [必要] 備份檔名/路徑。
密碼 空 用來解密備份文件的密碼。
allowOverwrite 假 布爾值，若為 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 中的 XMLA 視窗 （SSMS）

  • 作為 invoke-ascmd PowerShell Cmdlet 的輸入檔

  • 做為 SSIS 工作或 SQL Server Agent 作業的輸入

您可以從 SSMS 產生此命令的現成腳本，方法是按兩下 [還原] 對話方塊上的 [腳稿] 按鈕。