Pasta do modelo semântico do projeto do Power BI Desktop
Importante
Os projetos do Power BI Desktop estão atualmente em visualização.
Este artigo descreve os arquivos e subpastas em uma pasta Modelo Semântico de um projeto do Microsoft Power BI Desktop. Os arquivos e subpastas aqui representam um modelo semântico do Power BI. Dependendo do seu projeto, a pasta do modelo semântico pode incluir:
1 - Este ficheiro é obrigatório.
2 - Este arquivo é necessário ao salvar usando o formato TMSL.
3 - Este arquivo é necessário ao salvar usando o formato TMDL.
Nem todas as pastas do modelo semântico do projeto incluem todos os arquivos e subpastas descritos aqui.
Arquivos de modelo semântico
.pbi\localSettings.json
Contém configurações de modelo semântico que se aplicam somente ao usuário e ao computador atuais. Ele deve ser incluído no gitIgnore ou em outras exclusões de controle de origem. Por padrão, o Git ignora esse arquivo.
Para obter mais informações, consulte o localSettings.json documento de esquema.
.pbi\editorSettings.json
Contém configurações do editor de modelo semântico salvas como parte da definição de modelo semântico para uso entre usuários e ambientes.
Para obter mais informações, consulte o editorSettings.json documento de esquema.
.pbi\cache.abf
Um arquivo ABF (Backup do Analysis Services) contendo uma cópia em cache local do modelo e dos dados quando foi editado pela última vez. Ele deve ser incluído no gitIgnore ou em outras exclusões de controle de origem. Por padrão, o Git ignora esse arquivo.
O 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 existir um cache.abf, o Power BI Desktop carrega os dados e substitui a definição do modelo pelo conteúdo em model.bim.
.pbi\unappliedChanges.json
O Power BI Desktop permite que você salve as alterações feitas no editor Transformar Dados (Power Query) sem primeiro aplicar essas alterações ao modelo de dados.
Quando você seleciona Aplicar mais tarde, as alterações não aplicadas são salvas no arquivo unappliedChanges.json. Quando as alterações pendentes estiverem no arquivo unappliedChanges, o Power BI Desktop solicitará que você aplique ou descarte essas alterações pendentes:
Se você selecionar Aplicar alterações, o Power BI Desktop substituirá as consultas em model.bim pelas consultas do unappliedChanges.json. Se você editou consultas em model.bim fora do Power BI Desktop e há um arquivo de 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ê comprometa seu trabalho contínuo com a ramificação de desenvolvimento, servindo como backup e tornando-o acessível a outros membros da equipe. No entanto, você pode excluir esse arquivo do rastreamento do Git, impedindo que o trabalho de consulta inacabado afete outros desenvolvedores.
Para obter mais informações, consulte o unappliedChanges.json documento de esquema.
definição.pbism
Contém a definição geral de um modelo semântico e configurações principais.
Este arquivo também especifica os formatos de definição de modelo semântico suportados por meio da propriedade 'version'.
| Versão | Formatos suportados |
|---|---|
| 1.0 | A definição do modelo semântico deve ser armazenada como TMSL no arquivo model.bim. |
| 4.0 ou superior | A definição do modelo semântico pode ser armazenada como TMSL (arquivo model.bim) ou TMDL (pasta \definition). |
Para obter mais informações, consulte o documento de esquema definition.pbism.
modelo.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 de objeto de banco de dados TMSL (Tabular Model Scripting Language) do modelo de projeto.
definição\pasta
Esta pasta só estará disponível se o projeto do Power BI for salvo usando o formato TMDL. Ele substitui o arquivo model.bim .
Esta pasta contém uma definição de objeto de banco de dados TMDL (Tabular Model Definition Language) do modelo de projeto.
diagramLayout.json
Contém metadados de diagrama que definem a estrutura do modelo semântico associado ao relatório. Durante a pré-visualização, este ficheiro não suporta edição externa.
.plataforma
Arquivo de plataforma de malha que contém propriedades vitais para estabelecer e manter a conexão entre itens de malha e o Git.
Para saber mais, consulte Arquivos de sistema gerados automaticamente pela integração do Git.
Formato TMDL
Com o objetivo de fornecer um melhor controle de origem e experiência de codesenvolvimento, você pode salvar seus arquivos de projeto do Power BI (PBIP) usando TMDL (Tabular Model Definition Language) como o formato de arquivo de modelo semântico.
Ao contrário da TMSL (Tabular Model Scripting Language), 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 fácil edição em qualquer editor de texto. Isso representa um aprimoramento substancial para o controle do código-fonte e experiências de desenvolvimento colaborativo.
Em vez de um grande arquivo JSON como TMSL (Tabular Model Scripting Language), o TMDL tem uma estrutura de pastas com arquivos separados para cada tabela, perspetiva, função e cultura. Isso torna mais fácil trabalhar com outras pessoas e entender a estrutura do modelo semântico apenas olhando para a pasta e os arquivos. Em última análise, isso leva a um ótimo controle de origem e experiência de codesenvolvimento ao lidar com conflitos de git diff e mesclagem.
Saiba mais sobre a TMDL aqui.
Ativar o recurso de visualização do formato TMDL
Salvar como um projeto do Power BI usando TMDL está atualmente em visualização. Antes de usá-lo, você deve primeiro habilitá-lo em Recursos de visualização:
Vá para Opções de arquivo > e configurações > Opções > Visualizar recursos e marque a caixa ao lado de Armazenar modelo semântico usando o formato TMDL.
Salvar como um projeto usando TMDL
Com o recurso de visualização 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:
Saiba mais sobre a estrutura de pastas TMDL.
Converter 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 maneira:
Abra o PBIP no Power BI Desktop.
Certifique-se de que a funcionalidade de pré-visualização está ativada.
Salve o projeto. Um prompt é exibido solicitando que você atualize para TMDL.
Selecione Atualizar.
Importante
Depois de atualizar para TMDL, você não pode reverter para TMSL. Se você acha que pode querer reverter para TMSL, salve uma cópia de seus arquivos PBIP primeiro.
O arquivo TMSL (Tabular Model Scripting Language) existente (model.bim) é substituído por uma pasta \definition contendo a representação TMDL do modelo semântico.
Se você selecionar Manter o formato atual , a área de trabalho não solicitará novamente a atualização.
Fazer alterações externas em arquivos TMDL
Para uma melhor experiência de leitura e edição de seus arquivos TMDL, instale a extensão TMDL - Visual Studio Marketplace Microsoft VS Code.
Abra a pasta PBIP usando o VS Code e navegue até a pasta de definição de modelo semântico.
O Power BI Desktop não está ciente das alterações feitas em arquivos de projeto por outras ferramentas. Portanto, se você fizer alterações para abrir arquivos fora do Power BI Desktop, precisará reiniciar para que essas alterações sejam mostradas no Power BI Desktop.
Consulte aqui as operações de escrita suportadas fora do Power BI Desktop.
Erros TMDL
Se forem feitas edições inválidas nos ficheiros TMDL, o Power BI Desktop lança um erro ao abrir, com a localização do erro:
Considerações e limitações da TMDL
Durante a visualização pública, o Fabric Git Integration 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 o Power BI Desktop Publish, a Fabric Git Integration voltará para o formato TMSL padrão.