Usar histórico de versões do modelo semântico

O Power BI configura automaticamente o histórico de versões semânticas dos modelos semânticos para modelos semânticos editados na web ou ao editar ao vivo modelos semânticos Direct Lake no Power BI Desktop. Com o histórico de versões, os utilizadores de self-service podem recuperar dos erros mais críticos ao editar os seus modelos semânticos. Para controlo total do código-fonte e suporte a mais versões, use a integração git, que pode ser usada em combinação com o histórico de versões para o mesmo modelo semântico.

Abrir o painel de histórico de versões

Você pode exibir versões anteriores de um modelo semântico usando um painel de histórico de versões semelhante ao Office. A abertura do painel de histórico de versões pode ser feita a partir de vários locais e de várias maneiras, cada uma com o mesmo resultado:

• Na lista de conteúdo do espaço de trabalho, selecione Mais opções (...) para o modelo semântico e, em seguida, selecione Histórico de versões.

  

• Na lista de conteúdo do catálogo OneLake, selecione Mais opções (...) para o modelo semântico e, em seguida, selecione Histórico de versões.

  

• Na página de detalhes do modelo semântico, selecione Arquivo e depois selecione Histórico de versões.

  

• Ao editar um modelo semântico na web, selecione Arquivo e, em seguida, selecione Histórico de versões.

  

• Ao editar um modelo semântico na Web, selecione a barra de título do modelo semântico e, em seguida, selecione Histórico de versões.

  

Ver o painel do histórico de versões

No painel de histórico de versões, você pode ver até cinco versões por modelo semântico. Cada uma das versões no painel de histórico de versões armazena os metadados e os dados do modelo semântico. Cada versão listada no painel exibe as seguintes informações sobre a versão:

• A marca temporal da última modificação feita no modelo semântico que foi capturada na versão.
• O nome da pessoa que fez a última alteração no modelo semântico que foi capturado dentro da versão.
• Uma descrição para a versão, se fornecida anteriormente por um usuário ao salvar manualmente a versão.

Salvar uma versão no histórico de versões

As versões de um modelo semântico começam a ser capturadas depois que ele é aberto no modo de Edição na Web ou ao abrir um modelo do Direct Lake para edição ao vivo no Power BI Desktop.

Cada modelo semântico que suporta o histórico de versões pode ter até cinco versões salvas. Uma versão é salva no histórico de versões sempre que uma das seguintes ações ocorre:

• Quando você salva manualmente uma versão no histórico de versões. Na edição de um modelo semântico na Web, selecione Arquivo e, em seguida, selecione Salvar no histórico de versões.

  

  Ao salvar manualmente uma versão, você pode, opcionalmente, fornecer uma descrição de texto para ajudar a identificar essa versão posteriormente no painel de histórico de versões.

  

  A descrição aparece com sua versão correspondente no painel de histórico de versões.

  

• Quando você publica um arquivo .pbix do Power BI Desktop ou carrega um arquivo .pbix na Web, uma versão do modelo semântico antes da publicação/carregamento é capturada. A captura automática da versão garante que, se sobrescrever involuntariamente as alterações feitas na Internet durante a publicação/carregamento, pode restaurar o modelo ao seu estado, ou versão, anterior a essa publicação/carregamento não intencional.

• Quando você abre seu modelo semântico na Web no modo de Edição uma versão do modelo semântico é capturada, garantindo que, se você fizer alterações indesejadas em sua sessão de edição na Web, poderá restaurar o modelo para seu estado, ou versão, antes que essas alterações sejam feitas.

• Quando você restaura seu modelo semântico para uma versão anterior do histórico de versões, uma versão do modelo antes da restauração é salva, permitindo que você restaure para o estado anterior à restauração se uma versão indesejada tiver sido selecionada.

Restaurar para uma versão anterior

Para restaurar um modelo semântico para uma versão anterior, no painel de histórico de versões, selecione Restaurar no menu de contexto da versão que você deseja restaurar.

O painel de histórico de versões também mostra uma entrada para a versão atual do modelo. Não é possível restaurar para a versão atual, portanto, o menu de contexto da versão atual oferece a opção de abrir o modelo semântico na Web.

Exibir logs de auditoria e eventos de atividade

Os administradores do Power BI podem usar o do Centro de Administração do Microsoft 365 para auditar operações referentes à restauração e salvamento de versões no histórico de versões do modelo semântico. As tabelas a seguir mostram quais operações de auditoria são suportadas para o histórico de versões do modelo semântico:

Para obter mais informações sobre como aceder aos logs de auditoria, consulte o artigo Aceder aos logs de auditoria.

Utilização da capacidade e emissão de relatórios

Você pode monitorar o efeito que a restauração para uma versão anterior com histórico de versões tem em suas capacidades do Power BI Premium usando o aplicativo de métricas Premium. O efeito de capacidade pode ser monitorado usando a operação seguinte.

Não há cobrança adicional para o armazenamento usado para capturar versões no histórico de versões do modelo semântico para seus modelos.

Requisitos e permissões

• Os usuários devem ter permissão Gravar e Construir no modelo semântico para exibir e usar o histórico de versões. Saiba mais no artigo sobre permissões .
• O recurso de histórico de versões não está disponível para usuários com uma licença gratuita.

Considerações e limitações

Tenha em mente o seguinte:

• São guardadas até cinco versões por modelo. Salvar versões depois de atingir o limite de cinco versões substituirá a versão mais antiga no histórico de versões.
• Não há suporte para a restauração de versões com mais de 14 dias. Observe que essa limitação não é aplicada atualmente pelo produto.
• O histórico de versões não é suportado para modelos semânticos armazenados no My Workspace.
• O modelo semântico deve primeiro ser aberto na Web ou aberto para edição ao vivo do Direct Lake no Power BI Desktop antes que as versões comecem a ser capturadas para o modelo.
• Não é possível fazer alterações no modelo semântico quando o modelo está sendo restaurado para uma versão anterior.
• Não é possível excluir uma versão no histórico de versões de um modelo semântico.
• O histórico de versões do modelo semântico está sujeito às mesmas limitações que edição de modelos de dados no serviço do Power BI.
• O histórico de versões não será capturado para modelos semânticos que ainda não foram atualizados para formato de metadados aprimorado. Além disso, se um modelo com o formato de metadados antigo for publicado sobre um modelo no formato de metadados avançado, todas as versões de modelo semântico capturadas anteriormente para esse modelo serão excluídas.
• As informações do usuário podem não aparecer para versões criadas por operações em segundo plano.
• O histórico de versões é excluído quando um espaço de trabalho se move entre capacidades com diferentes chaves de criptografia BYOK ou quando a chave de criptografia BYOK de uma capacidade é alterada.
• Não é possível acessar versões no histórico de versões do modelo semântico fora do painel de histórico de versões na Web. Para um controlo total do código-fonte com maior flexibilidade e suporte para mais versões, utilize a integração git , que pode ser utilizada em combinação com o histórico de versões para o mesmo modelo semântico.
• Os dados no seu modelo semântico podem ficar desatualizados após a restauração para uma versão anterior. Para garantir que você tenha os dados mais recentes, conclua uma atualização depois de executar uma restauração. O comportamento de atualização pode variar entre os modos de armazenamento. Por exemplo, os modelos Direct Lake com atualizações automáticas configuradas serão atualizados automaticamente com os dados mais recentes após uma restauração, sem exigir que você inicie manualmente uma atualização.
• Durante um failover, as operações de leitura, como a visualização do histórico de versões do modelo semântico, permanecem disponíveis. No entanto, as operações que modificam o conteúdo do Power BI, incluindo salvar uma nova versão ou restaurar uma versão anterior no histórico de versões do modelo semântico, não são suportadas quando o Power BI está no modo de failover.

Considerações sobre o formato de armazenamento de grandes modelos semânticos

O modelo semântico deve ter formato de armazenamento de modelo semântico grande habilitado. Os modelos semânticos são convertidos automaticamente para um formato de armazenamento de modelo semântico grande na primeira vez que são abertos no modo de Edição na Web ou ao abrir um modelo Direct Lake para edição ao vivo no Desktop. Se um modelo semântico com versões capturadas no histórico de versões tiver o formato de armazenamento de modelo semântico grande desativado nas configurações do modelo, todo o histórico de versões desse modelo será excluído. Um aviso nas configurações do modelo semântico notificará você sobre esse impacto antes de fazer a alteração:

Um modelo semântico pode falhar ao converter para o formato de armazenamento de modelo semântico grande se exceder as limitações de memória. Para resolver essas limitações de memória, você pode hospedar o modelo em uma SKU de capacidade Premium que suporte o tamanho de memória necessário para o modelo ou reduzir o tamanho do modelo.

Conteúdo relacionado

Este artigo forneceu informações sobre o histórico semântico de versões dos modelos. Para obter mais informações sobre modelagem semântica no Power BI, consulte os seguintes recursos:

• Editar modelos de dados no serviço do Power BI
• Direct Lake no Power BI Desktop
• Introdução à integração do Git no Microsoft Fabric
• Integração do Git em projetos do Power BI Desktop