Comando Backup (TMSL)

Artigo
12/23/2023

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

Faz backup de um banco de dados tabular em um arquivo de backup .abf.

Solicitação

    {  
        "backup": {  
            "description": "Parameters of Backup command of Analysis Services JSON API",  
            "properties": {  
            "database": {  
                "type": "string"  
            },  
            "file": {  
                "type": "string"  
            },  
            "password": {  
                "type": "string"  
            },  
            "allowOverwrite": {  
                "type": "boolean"  
            },  
            "applyCompression": {  
                "type": "boolean"  
            }  
            },  
. . .

O backup tem várias propriedades.

Propriedade	Padrão	Descrição
Banco de Dados	[Obrigatório]	O nome do objeto de banco de dados a ser copiado em backup.
file	[Obrigatório]	O nome/caminho do arquivo de backup.
password	Vazio	A senha a ser usada para criptografar 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.
applyCompression	True	Um booliano que, quando verdadeiro, indica que os arquivos de backup são compactados; caso contrário, false.

Resposta

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

Exemplos

Exemplo 1 – Fazer backup de um arquivo na pasta de backup padrão.

{   
   "backup": {   
      "database":"AS_AdventureWorksDW2014",  
      "file":"AS_AdventureWorksDW2014.abf",  
      "password":"secret"  
   }  
}

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 Banco de Dados de Backup.

Share via