Restore コマンド (TMSL)

適用対象:SQL Server 2016 以降のAnalysis Services Azure Analysis Services 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"  
                ]  
. . .   

復元には 、いくつかのプロパティがあります。

プロパティ Default 説明
database [必須] 復元するデータベース オブジェクトの名前。
file [必須] バックアップ ファイルの名前/パス。
password Empty バックアップ ファイルの暗号化解除に使用するパスワード。
allowOverwrite False true の場合、既に存在するバックアップ ファイルが上書きすることを示すブール値。それ以外の場合は false。
readWriteMode Readwrite データベースに許可されるアクセス モードを示す 列挙値。

列挙値は次のとおりです。

readWrite – 読み取り/書き込みアクセスが許可されます。

readOnly – 読み取り専用アクセスが許可されます。

readOnlyExclusive – 読み取り専用排他アクセスが許可されます。
dbStorageLocation Empty Storageされたデータベースの場所。

Response

コマンドが成功すると、空の結果を返します。 それ以外の場合は、XMLA 例外が返されます。

例 1 - ローカル フォルダーからデータベースを復元する。

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

使用状況 (エンドポイント)

このコマンド要素は、XMLA エンドポイントに対する Execute Method (XMLA) 呼び出しのステートメントで使用され、次の方法で公開されます。

  • SQL Server Management Studio (SSMS) の XMLA ウィンドウとして

  • invoke-ascmd PowerShell コマンドレットへの入力ファイルとして

  • SSIS タスクまたはジョブへの入力SQL Server エージェント

[復元] ダイアログ ボックスの [スクリプト] ボタンをSSMSから、このコマンドの既製のスクリプトを生成できます。