Поделиться через


Команда 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"  
                ]  
. . .   

Восстановление имеет несколько свойств.

Свойство По умолчанию Описание
База данных [Обязательно] Имя восстанавливаемого объекта базы данных.
файл [Обязательно] Имя или путь к файлу резервной копии.
password Empty Пароль, используемый для расшифровки файла резервной копии.
allowOverwrite Неверно Логическое значение, указывающее, что файл резервной копии, который уже существует, будет перезаписан; в противном случае — false.
readWriteMode readWrite Значение перечисления, указывающее режимы доступа, разрешенные для базы данных.

Возможны следующие значения перечислений:

readWrite — разрешен доступ для чтения и записи.

readOnly — доступ только для чтения разрешен.

readOnlyExclusive — разрешен монопольный доступ только для чтения.
dbStorageLocation Empty Расположение хранилища для восстановленной базы данных.

Ответ

Возвращает пустой результат при успешном выполнении команды. В противном случае возвращается исключение XMLA.

Пример

Пример 1 . Восстановление базы данных из локальной папки.

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

Использование (конечные точки)

Этот командный элемент используется в инструкции вызова метода Execute (XMLA) через конечную точку XMLA, которая предоставляется следующими способами:

  • Как окно XMLA в SQL Server Management Studio (SSMS)

  • Входной файл командлета PowerShell invoke-ascmd

  • В качестве входных данных для задачи служб SSIS или задания агент SQL Server

Вы можете создать готовый скрипт для этой команды из SSMS, нажав кнопку Скрипт в диалоговом окне Восстановление.