Comando Restore (TMSL)

Artigo
12/23/2023

Aplica-se a: SQL Server 2016 e posteriores do Analysis Services Azure Analysis Services Fabric/Power BI Premium

Restaura um banco de dados tabular de um arquivo de backup.

Solicitação

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

A restauração tem várias propriedades.

Propriedade	Padrão	Descrição
Banco de Dados	[Obrigatório]	O nome do objeto de banco de dados a ser restaurado.
file	[Obrigatório]	O nome/caminho do arquivo de backup.
password	Vazio	A senha a ser usada para descriptografar o arquivo de backup.
Allowoverwrite	Falso	Um booliano que, quando verdadeiro, indica que um arquivo de backup que já existe será substituído; caso contrário, false.
Readwritemode	readWrite	Um valor de enumeração que indica os modos de acesso permitidos para o banco de dados. Os valores de enumeração são os seguintes: readWrite – o acesso de leitura/gravação é permitido. readOnly – o acesso somente leitura é permitido. readOnlyExclusive – o acesso exclusivo somente leitura é permitido.
dbStorageLocation	Vazio	Local de armazenamento para o banco de dados restaurado.

Resposta

Retorna um resultado vazio quando o comando é bem-sucedido. Caso contrário, uma exceção XMLA será retornada.

Exemplo

Exemplo 1 – Restaurar um banco de dados de uma pasta local.

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

Uso (pontos de extremidade)

Esse elemento de comando é usado em uma instrução da chamada do Método Execute (XMLA) em um ponto de extremidade XMLA, exposta das seguintes maneiras:

Como uma janela XMLA no SSMS (SQL Server Management Studio)
Como um arquivo de entrada para o cmdlet do PowerShell invoke-ascmd
Como uma entrada para uma tarefa do SSIS ou SQL Server Agent trabalho

Você pode gerar um script pronto para esse comando do SSMS clicando no botão Script na caixa de diálogo Restaurar.

Share via