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	true이면 이미 존재하는 백업 파일을 덮어쓸 것임을 나타내는 부울입니다. 그렇지 않으면 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":".."  
   }  
}  

사용량(엔드포인트)

이 명령 요소는 다음과 같은 방법으로 노출되는 XMLA 엔드포인트를 통해 XMLA(Execute Method) 호출의 문에서 사용됩니다.

• SSMS(SQL Server Management Studio XMLA 창)

• invoke-ascmd PowerShell cmdlet에 대한 입력 파일로

• SSIS 태스크 또는 SQL Server 에이전트 작업에 대한 입력으로

복원 대화 상자에서 스크립트 단추를 클릭하여 SSMS에서 이 명령에 대해 준비된 스크립트를 생성할 수 있습니다.