Compartilhar via

Pasta do modelo semântico do projeto do Power BI Desktop

  • Artigo

Importante

Os projetos do Power BI Desktop estão atualmente em versão prévia.

Este artigo descreve os arquivos e subpastas na pasta Modelo Semântico de um projeto do Microsoft Power BI Desktop. Os arquivos e as subpastas aqui representam um modelo semântico do Power BI. Dependendo do seu projeto, a pasta do modelo semântico pode incluir:

1 – este arquivo é necessário.
2 - Esse arquivo é necessário ao salvar usando o formato TMSL.
3 - Esse arquivo é necessário ao salvar usando o formato TMDL.

Nem toda pasta de modelo semântico de projeto inclui todos os arquivos e subpastas descritos aqui.

Arquivos do modelo semântico

.pbi\localSettings.json

Contém as configurações do modelo semântico que se aplicam apenas ao usuário e ao computador atuais. Deve ser incluído no gitIgnore ou em outras exclusões de controle do código-fonte. Por padrão, o Git ignora esse arquivo.

Para obter mais informações, confira o documento do esquema localSettings.json.

.pbi\editorSettings.json

Contém as configurações do editor de modelo semântico salvas como parte da definição do modelo semântico para uso entre usuários e ambientes.

Para obter mais informações, confira o documento do esquema editorSettings.json.

.pbi\cache.abf

Um arquivo de Backup do Analysis Services (ABF) que contém uma cópia em cache local do modelo e dos dados quando ele foi editado pela última vez. Deve ser incluído no gitIgnore ou em outras exclusões de controle do código-fonte. Por padrão, o Git ignora esse arquivo.

Power BI Desktop pode abrir um projeto sem um arquivo cache.abf. Nesse caso, ele abre o relatório conectado a um modelo com toda a sua definição, mas sem dados. Se houver um cache.abf, Power BI Desktop carregará os dados e substituirá a definição do modelo pelo conteúdo em model.bim.

.pbi\unappliedChanges.json

Power BI Desktop permite salvar as alterações feitas no editor transformar dados (Power Query) sem primeiro aplicar essas alterações ao modelo de dados.

Imagem mostrando a caixa de diálogo Aplicar alteração de consulta.

Quando você seleciona Aplicar mais tarde, as alterações não aplicadas são salvas no arquivo unappliedChanges.json. Quando as alterações pendentes estão no arquivo unappliedChanges, Power BI Desktop solicita que você aplique ou descarte essas alterações pendentes:

Imagem mostrando o aviso de alterações pendentes.

Se você selecionar Aplicar alterações, o Power BI Desktop substitui as consultas em model.bim pelas consultas de unappliedChanges.json. Se você editou consultas no model.bim fora do Power BI Desktop e houver um arquivo unappliedChanges.json anterior, suas alterações serão perdidas e substituídas pelas consultas em unappliedChanges.json quando essas alterações forem aplicadas.

O arquivo unappliedChanges.json é automaticamente incorporado à definição do modelo semântico e salvo no Git por padrão. Isso permite que você confirme seu trabalho contínuo no branch de desenvolvimento, servindo como um backup e tornando-o acessível a outros membros da equipe. No entanto, você pode excluir esse arquivo do rastreamento do Git, evitando que o trabalho de consulta inacabado afete outros desenvolvedores.

Para obter mais informações, confira o documento do esquema unappliedChanges.json.

definition.pbism

Contém a definição geral de um modelo semântico e as principais configurações.

Esse arquivo também especifica os formatos de definição de modelo semântico com suporte por meio da propriedade ''version''.

Versão Formatos com suporte
1.0 A definição de modelo semântico deve ser armazenada como TMSL no arquivo model.bim.
4.0 ou superior A definição de modelo semântico pode ser armazenada como TMSL (arquivo model.bim) ou TMDL (pasta \definition).

Para obter mais informações, confira o documento do esquema definition.pbism.

model.bim

Esse arquivo só estará disponível se o projeto do Power BI for salvo usando o formato TMSL. Ele contém uma definição do modelo de projeto de Objeto de Banco de dados na Linguagem de Script de Modelo Tabular (TMSL).

definição\ pasta

Esse arquivo só estará disponível se o projeto do Power BI for salvo usando o formato TMDL. Ele substitui o arquivo model.bim.

Esse arquivo contém uma definição do modelo de projeto Linguagem de Definição de Modelo Tabular (TMDL)Objeto de Banco de dados.

diagramLayout.json

Contém metadados de diagrama que definem a estrutura do modelo semântico associado ao relatório. Durante a VERSÃO PRÉVIA, esse arquivo não dá suporte à edição externa.

Mail Luck!.

Arquivo da plataforma do Fabric que contém propriedades vitais para estabelecer e manter a conexão entre os itens do Fabric e o Git.

Para saber mais, confira Integração do Git com arquivos de sistema gerados automaticamente.

Formato TMDL

Com o objetivo de fornecer um melhor controle do código-fonte e experiências de co-desenvolvimento, você pode salvar seus arquivos de projeto do Power BI (PBIP) usando a Linguagem de Definição de Modelo Tabular (TMDL) como formato de arquivo de modelo semântico.

Ao contrário da Linguagem de Script de Modelo Tabular (TMSL), a TMDL foi projetada desde o início para ser amigável ao ser humano, facilitando não apenas a legibilidade, mas também a edição fácil em qualquer editor de texto. Isso representa um aprimoramento substancial do controle do código-fonte e das experiências do desenvolvimento colaborativo.

Captura de tela de diffs amigáveis de TMDL.

Em vez de um grande arquivo JSON, como o Linguagem de Script de Modelo Tabular (TMSL), a TMDL tem uma estrutura de pastas com arquivos separados para cada tabela, perspectiva, função e cultura. Isso facilita o trabalho com outras pessoas e a compreensão da estrutura do modelo semântico apenas observando a pasta e os arquivos. Em última análise, isso leva a uma excelente experiência de controle do código-fonte e co-desenvolvimento ao lidar com diferenças no Git e conflitos de mesclagem.

Captura de tela das diffs de TMDL do modelo semântico.

Saiba mais sobre a TMDL aqui.

Habilitar a versão prévia do recurso de formato TMDL

Salvar como um projeto do Power BI usando a TMDL está atualmente em visualização. Antes de usá-lo, você deve primeiro habilitá-lo na Versão prévia dos recursos:

Vá para Arquivo > Opções e configurações > Opções > Versão prévia dos recursos e marque a caixa ao lado de Armazenar modelo semântico usando o formato TMDL.

Salvar como um projeto usando TMDL

Com a versão prévia do recurso TMDL habilitado, quando você salva um projeto, seu modelo semântico é salvo como uma pasta TMDL chamada \definition dentro da pasta do modelo semântico:

Captura de tela da pasta de definição dentro de uma pasta de modelo semântico.

Saiba mais sobre a estrutura de pastas TMDL.

Converter o PBIP existente em TMDL

Se você já tiver um PBIP usando TMSL como formato de modelo semântico, poderá convertê-lo em TMDL da seguinte forma:

  1. Abra o PBIP no Power BI Desktop.

  2. Certifique-se de que a versão prévia do recurso esteja habilitada.

  3. Salvaro projeto. É exibido um prompt solicitando a atualização para TMDL.

  4. Selecione Atualizar.

    Importante

    Depois de atualizar para TMDL, não é possível reverter para TMSL. Se você acha que pode querer voltar para TMSL, salve uma cópia dos seus arquivos PBIP primeiro.

    Captura de tela do prompt para atualizar a pasta de modelo semântico para TMDL.

O arquivo da Linguagem de Script de Modelo Tabular (TMSL) existente (model.bim) é substituído por uma pasta \definition que contém a representação TMDL do modelo semântico.

Captura de tela de projetos PBIP com pastas TMSL e pastas TMDL.

Se você selecionar Manter o formato atual, a Área de trabalho não solicitará novamente a atualização.

Fazer alterações externas nos arquivos TMDL

Para ter uma experiência melhor na leitura e edição de seus arquivos TMDL, instale a extensão TMDL - Visual Studio Marketplace extensão do Microsoft VS Code.

Abra a pasta PBIP usando o VS Code e navegue até a pasta de definição do modelo semântico.

Captura de tela de uma pasta de definição de modelo semântico no VS Code.

O Power BI Desktop não está ciente das alterações nos arquivos de projeto feitas por outras ferramentas. Portanto, se você fizer qualquer alteração em arquivos abertos fora do Power BI Desktop, será necessário reiniciar para que essas alterações sejam mostradas no Power BI Desktop.

Consulte aqui para obter informações sobre as operações de gravação com suporte fora do Power BI Desktop.

Erros de TMDL

Se alguma edição inválida for feita nos arquivos TMDL, o Power BI Desktop exibirá um erro ao abrir, com a localização do erro:

Captura de tela de uma mensagem de erro para um arquivo inválido.

Integração do Git do Fabric com TMDL

Durante a Visualização Pública, a Integração do Git do Fabric ainda exportará o modelo semântico usando TMSL por padrão. No entanto, se o modelo semântico for importado para o Fabric usando o Fabric Git Integration com o formato TMDL, o Fabric Git Integration usará o formato TMDL para exportar a definição do modelo semântico para o Git se houver alguma alteração no modelo semântico no serviço.

Importante

Se você importar seu modelo semântico usando qualquer outro método de importação, como Power BI Desktop Publish, o Fabric Git Integration voltará para o formato TMSL padrão.

Conteúdo relacionado