Fazer backup e restaurar modelos semânticos com Power BI Premium

Se você tiver uma licença do Power BI Premium ou Premium Per User (PPU), poderá usar o recurso Backup e Restauração com os modelos semânticos do Power BI. Esse recurso é semelhante às operações de backup e restauração disponíveis em modelos tabulares para Azure Analysis Services.

Você pode usar SQL Server Management Studio (SSMS), cmdlets do Analysis Services para PowerShell e outras ferramentas para executar operações de backup e restauração no Power BI usando endpoints XMLA. As seções a seguir descrevem os conceitos de backup e restauração para modelos semânticos, requisitos e considerações do Power BI.

A capacidade de fazer backup e restaurar modelos semânticos Power BI fornece um caminho de migração de cargas de trabalho Azure Analysis Services para Power BI Premium. O recurso de backup e restauração também permite fazer backups de modelos semânticos por vários motivos, incluindo corrupção ou perda, requisitos de retenção de dados e migração de locatário.

Usando backup e restauração de modelo semântico

O recurso backup e restauração usa conexões existentes entre Power BI e Azure, como a capacidade de registrar uma conta de armazenamento do Azure Data Lake Storage Gen2 (ADLS Gen2) no nível do locatário ou do workspace para facilitar o armazenamento e as operações de fluxo de dados. Como o Backup e a Restauração usam a mesma conexão, você não precisa de outra conta de armazenamento.

Você pode executar backups offline baixando os arquivos de sua conta de armazenamento do ADLS Gen2. Para baixar, use o sistema de arquivos, o Gerenciador de Armazenamento do Azure, as ferramentas do .NET e os cmdlets do PowerShell, como o cmdlet Get-AzDataLakeGen2ItemContent. A imagem a seguir mostra um workspace com três modelos semânticos e seus arquivos de backup correspondentes no Gerenciador de Armazenamento do Azure.

Para saber como configurar o Power BI para usar uma conta de armazenamento do ADLS Gen2, consulte a configuração do armazenamento de fluxo de dados para usar o Azure Data Lake Gen 2.

Considerações de várias áreas geográficas

Backup e Restauração se baseia na infraestrutura de conexões do Azure no Power BI para registrar uma conta de armazenamento do Azure Data Lake Storage Gen2 (ADLS Gen2) no nível do locatário ou do espaço de trabalho. Você deve provisionar a conta de armazenamento na região da capacidade do Power BI Premium para evitar custos de transferência de dados entre limites regionais. Verifique os requisitos de residência de dados antes de configurar seus espaços de trabalho em uma Capacidade Premium multi-geográfica com uma conta de armazenamento.

Quem pode executar backup e restauração

Quando você associa uma conta de armazenamento ADLS Gen2 a um espaço de trabalho, os administradores do espaço de trabalho com permissões de gravação ou de administração podem fazer backup do espaço de trabalho. Essas permissões podem vir de um administrador, um membro ou um colaborador. Você não precisa fazer parte das funções do workspace se tiver permissão de escrita direta para o modelo semântico. Estes são alguns requisitos:

• Para restaurar um modelo semântico existente, você precisa de permissão de gravação ou administrador para o conjunto de dados. Para restaurar um novo modelo semântico, você deve ser um administrador do workspace.

• Para navegar pelo sistema de arquivos de backup e restauração usando Gerenciador de Armazenamento do Azure (o botão Procurar... no SSMS), você deve ser um administrador, um membro ou um colaborador do workspace.

O Power BI associa os espaços de trabalho aos diretórios de backup com base no nome do espaço de trabalho. Com permissões de proprietário no nível da conta de armazenamento, você pode baixar arquivos de backup ou copiá-los de seu local original para o diretório de backup de um workspace diferente. Você pode restaurá-los se for um administrador de workspace no workspace de destino.

Os proprietários da conta de armazenamento têm acesso irrestrito aos arquivos de backup, portanto, defina e mantenha cuidadosamente as permissões da conta de armazenamento.

Como executar backup e restauração

O backup e a restauração exigem o uso de ferramentas baseadas em XMLA, como SQL Server Management Studio (SSMS). A interface de usuário do Power BI não tem recurso nem opção de backup ou restauração. Devido à dependência XMLA, o backup e a restauração atualmente exigem que seus modelos semânticos residam em uma capacidade Premium ou PPU.

Você pode aplicar as configurações da conta de armazenamento para backup e restauração no nível do tenant ou do workspace.

Para Backup e Restauração, Power BI cria um novo contêiner chamado power-bi-backup em sua conta de armazenamento. Ele cria uma pasta de backup com o mesmo nome do seu workspace no power-bi-backup contêiner. Se você configurar uma conta de armazenamento em nível de locatário, o Power BI cria apenas o contêiner power-bi-backup. Power BI cria a pasta de backup quando você anexa a conta de armazenamento a um workspace. Se você configurar uma conta de armazenamento no nível do workspace, Power BI criará o power-bi-backup contêiner e criará a pasta de backup.

Durante o backup e a restauração, as seguintes ações se aplicam:

• Power BI coloca arquivos de backup na pasta de backup no power-bi-backup contêiner.
• Para restaurar, você deve colocar os arquivos de backup (.abf arquivos) na pasta antes de realizar uma restauração.

Se você renomear um workspace, Power BI renomeará automaticamente a pasta de backup no power-bi-backup contêiner para corresponder. No entanto, se você tiver uma pasta existente com o mesmo nome do workspace renomeado, a renomeação automática para a pasta de backup falhará.

Considerações e limitações

Ao usar o recurso backup e restauração com Power BI, tenha em mente as considerações a seguir.

• O Power BI deve ser capaz de acessar diretamente o ADLS Gen2. O ADLS Gen2 não pode ser localizado em uma VNet e você não pode ativar o firewall.

• Se o ADLS Gen2 já funcionar com Backup e Restauração e você desconectar e depois reconfigurá-lo para trabalhar com Backup e Restauração novamente, você deverá primeiro renomear ou mover a pasta de backup anterior. Caso contrário, a tentativa resultará em erros e falhas.

• A restauração só dá suporte à restauração do banco de dados como um banco de dados Premium (Modelo Grande ).

• Você pode restaurar apenas o modelo de formato aprimorado (modelo V3).

• Quando você desabilitar a autorização de Chave Compartilhada em sua conta de armazenamento, poderá receber este erro: a autenticação baseada em chave não é permitida nesta conta de armazenamento.

• A propriedade ignoreIncompatibilities para o comando restore aborda incompatibilidades de RLS (segurança em nível de linha) entre o AAS (Azure Analysis Services) e o Power BI Premium. O Power BI Premium dá suporte apenas à permissão de leitura para funções, mas o AAS dá suporte a todas as permissões. Se você tentar restaurar um arquivo de backup para o qual algumas funções não têm permissões de leitura , especifique a ignoreIncompatibilities propriedade no restore comando. Se você não especificar isso, a restauração poderá falhar. Ao especificá-la, a restauração descarta a função sem a permissão de leitura . No momento, não há nenhuma configuração no SSMS que dê suporte à ignoreIncompatibilities propriedade, no entanto, você pode especificá-la em um restore comando usando TMSL (Tabular Model Scripting Language). Por exemplo:

  {
     "restore": {
       "database": "DB",
       "file": "/Backup.abf",
       "allowOverwrite": true,
       "security": "copyAll",
       "ignoreIncompatibilities": true
     }
  }
  

• Você pode restaurar um banco de dados corrompido. Desde que você faça backup do banco de dados periodicamente, restaurar o banco de dados é a maneira mais robusta de recuperá-lo. Use o seguinte restore comando em uma consulta XMLA para restaurar um banco de dados:

  <Restore xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">
       <File>DatabaseBackup.abf</File>
       <DatabaseName>DatabaseName</DatabaseName>
       <AllowOverwrite>true</AllowOverwrite>
  </Restore>
  

• Ao restaurar um banco de dados, você poderá receber o seguinte erro: Não é possível restaurar o backup semântico do modelo agora porque não há memória suficiente para concluir essa operação. Use a opção /forceRestore para restaurar o modelo semântico com o modelo semântico existente descarregado e offline.

  Nesses casos, com o comando restore, adicione a propriedade forceRestore para iniciar uma operação de restauração forçada. Por exemplo, quando você usa TMSL:

  {
     "restore": {
       "database": "DB",
       "file": "/Backup.abf",
       "allowOverwrite": true,
       "security": "copyAll",
       "forceRestore": true
     }
  }
  

Recuperar um modelo semântico carregado no modo somente metadados

Quando Power BI detecta um erro de esquema que impede que um modelo semântico carregue normalmente, ele carrega o modelo no modo somente metadados. Esse estado seguro e degradado permite que você se conecte e inspecione a definição do modelo, mas não é possível executar consultas nem executar operações de dados.

Você verá esse erro ao tentar consultas ou modificações: a operação não é permitida porque o banco de dados está corrompido e foi carregado no modo somente metadados.

Opção 1: Restaurar do histórico de versões (recomendado)

Se o modelo semântico tiver uma versão salva de antes do problema ocorrer:

1. No workspace, selecione Mais opções (...) no modelo semântico e selecione Histórico de versões.
2. Escolha uma versão anterior ao erro.
3. Selecione Restaurar.

Opção 2: Gerar um script e republicar o modelo

Se você tiver o projeto-fonte (arquivo .pbix):

1. Conecte-se ao modelo semântico usando SSMS (use o ponto de extremidade XMLA, por exemplo, powerbi://api.powerbi.com/v1.0/myorg/<workspace>).
2. Faça o script do modelo clicando com o botão direito do mouse no banco de dados e selecionando o Banco de Dados de Script como, seguido por CREATE OU REPLACE To, seguido por Nova janela Editor de Consultas.
3. Salve o script em um arquivo para segurança.
4. Republique o modelo corrigido no espaço de trabalho. Esta etapa limpa o modo somente metadados e restaura a funcionalidade completa.
5. Execute o script salvo na etapa 3 para restaurar quaisquer alterações no esquema que a republicação removeu e, em seguida, resolva o erro original que acionou o modo de somente metadados.

Opção 3: Criar script e recriar o modelo

Se você não tiver os arquivos de origem originais:

1. Conecte-se ao modelo semântico usando SSMS (use o ponto de extremidade XMLA, por exemplo, powerbi://api.powerbi.com/v1.0/myorg/<workspace>).
2. Faça o script do modelo clicando com o botão direito do mouse no banco de dados e selecionando o Banco de Dados de Script como, seguido por CREATE OU REPLACE To, seguido por Nova janela Editor de Consultas.
3. Salve o script em um arquivo.
4. Corrija o erro de esquema no script JSON.
5. Altere o nome do banco de dados no script para criar um novo modelo semântico.
6. Execute o script corrigido no espaço de trabalho.
7. Revincula seus relatórios ao novo modelo semântico. A biblioteca semântica-link-labs fornece utilitários auxiliares para essa tarefa.
8. Reconfigure as credenciais da fonte de dados e as configurações do gateway no novo modelo.

Conteúdo relacionado

• Cmdlets do Analysis Services para PowerShell

• Conectividade de modelo semântico com o ponto de extremidade XMLA

• Configurando o armazenamento de inquilinos e workspaces