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

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

Abrir o painel 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 histórico de versões pode ser feita de vários locais e diferentes maneiras, sempre com o mesmo resultado:

• Na lista de conteúdo do workspace, selecione Mais opções (...) para o modelo semântico e selecione Histórico de Versão.

  

• Na lista de conteúdo do catálogo do 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, depois Histórico de versões.

  

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

  

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

  

Exibir o painel histórico de versões

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

• O timestamp da última modificação feita no modelo semântico 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 da versão, se fornecida anteriormente pelo usuário ao salvá-la manualmente.

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 Direct Lake para edição dinâmica no Power BI Desktop.

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

• 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 fornecer um texto descritivo para ajudar a identificar essa versão posteriormente, no painel histórico de versões.

  

  A descrição é exibida com sua versão correspondente no painel 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 assegura que, se você sobrescrever acidentalmente as alterações realizadas na web durante a publicação/upload, poderá restaurar o modelo ao seu estado ou versão anterior a essa publicação/upload acidental.

• Quando você abre o modelo semântico na Web no modo de edição uma versão do modelo semântico é capturada, garantindo que, se fizer alterações indesejadas na sessão de edição da Web, você poderá restaurar o modelo para o estado anterior às alterações.

• Quando você restaura seu modelo semântico para uma versão anterior do histórico de versões, uma versão do modelo é salva antes da restauração, permitindo que você retorne ao estado anterior à restauração se perceber que a versão incorreta foi selecionada.

Restaurar para uma versão anterior

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

O painel histórico de versões também mostra uma entrada para a versão atual do modelo. Você não pode restaurar para sua versão atual, portanto, o menu de contexto da versão atual fornece apenas 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 relativas à 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 têm suporte para o histórico de versão semântica do modelo:

Para obter mais informações sobre como acessar logs de auditoria, consulte o artigo Acessar seus logs de auditoria.

Utilização da capacidade e relatórios

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

Não há custo adicional referente ao armazenamento usado para capturar versões no histórico de versões de modelos semânticos para seus modelos.

Requisitos e permissões

• No modelo semântico, os usuários devem ter permissões Gravar e Criar 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 licença gratuita.

Considerações e limitações

Tenha em mente o seguinte:

• Até cinco versões são salvas por modelo. Salvar versões após atingir esse limite substituirá a versão mais antiga do histórico de versões.
• Não há suporte para restaurar versões com mais de 14 dias. Observe que essa limitação não é imposta no momento pelo produto.
• Não há suporte para o histórico de versões para modelos semânticos armazenados no Meu Workspace.
• O modelo semântico deve primeiro ser aberto na Web ou aberto para a edição dinâmica do Direct Lake no Power BI Desktop antes que as versões do modelo comecem a ser capturadas.
• Você não pode fazer alterações no modelo semântico quando ele está sendo restaurado para uma versão anterior.
• Você não pode excluir uma versão do histórico de versões do modelo semântico.
• O histórico de versão do modelo semântico está sujeito às mesmas limitações que editar 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 o 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 aprimorado, todas as versões desse modelo semântico capturadas anteriormente 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 workspace se move entre capacidades com chaves de criptografia BYOK diferentes ou quando a chave de criptografia BYOK de uma capacidade é alterada.
• Você não pode acessar versões no histórico de versões semânticas de modelo fora do painel histórico de versões na Web. Para controle total do código-fonte com maior flexibilidade e suporte a mais versões, use a integração do Git , que pode ser utilizada em combinação com o histórico de versões para o mesmo modelo semântico.
• Os dados do seu modelo semântico podem ficar desatualizados após a restauração de uma versão anterior. Para garantir que esteja trabalhando com os dados mais recentes, faça uma atualização após a restauração. O comportamento de atualização pode variar entre os modos de armazenamento. Por exemplo, modelos do 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ê faça isso manualmente.
• Durante um failover, as operações de leitura, como exibir o histórico de versão semântica do modelo, 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 semânticas do modelo, não têm suporte quando o Power BI está no modo de failover.

Considerações sobre formato de armazenamento de modelo semântico grande

O modelo semântico precisa estar com o formato de armazenamento de modelo semântico grande habilitado. Os modelos semânticos são convertidos automaticamente para o formato de armazenamento de modelo semântico grande na primeira vez em que são abertos no modo de edição na Web ou no Direct Lake para edição dinâmica 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 desabilitado em suas configurações, todo o histórico de versões desse modelo será excluído. Um aviso nas configurações do modelo semântico notificará sobre esse impacto antes de completar a alteração:

Um modelo semântico talvez não consiga ser convertido para o formato de armazenamento de grandes modelos semânticos se exceder as limitações de memória. Para resolver essas limitações de memória, você pode hospedar o modelo em um SKU de capacidade Premium que dá suporte ao 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 de versões semânticas do modelo. 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 Git dos projetos do Power BI Desktop