Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Este artigo descreve os ficheiros e subpastas na 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:
- .pbi\
- DAXQueries\ folder
- Pasta TMDLScripts\
- pasta de definições\3
- modelo.bim2
- diagramLayout.json
- .plataforma
- definição.pbism1
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.jsem
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 documento de esquema localSettings.json.
.pbi\editorSettings.jsem
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 documento de esquema editorSettings.json.
.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 pelos metadados do modelo semântico no projeto.
.pbi\unappliedChanges.jsem
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 nos metadados do modelo semântico pelas consultas do unappliedChanges.json. Se você editou consultas fora do Power BI Desktop e há um arquivo de unappliedChanges.json anterior, suas alterações são perdidas e substituídas pelas consultas em unappliedChanges.json quando essas alterações são 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 documento de esquema unappliedChanges.json.
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 do objeto Banco de Dados do modelo de projeto em TMSL (Tabular Model Scripting Language).
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. Não podes editar este ficheiro externamente.
.plataforma
Arquivo de 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, consulte Arquivos de sistema gerados automaticamente pela integração do Git.
DAXQueries\ folder
Contém um ficheiro para cada separador de consulta vista de consulta DAX guardado como [Tab name].dax ficheiro DAX.
.pbi\daxQueries.json
Contém definições do editor de visualização de consultas DAX , como defaultTab ou ordem de tabulação.
Pasta TMDLScripts\
Contém um ficheiro para cada separador de visualização de script TMDL guardado como ficheiro [Tab name].tmdl TMDL.
.pbi\tmdlscripts.json
Contém definições do editor de visualização TMDL, como defaultTab ou ordem de tabulação.
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.
Fazer alterações externas em arquivos TMDL
Pode editar ficheiros TMDL no Visual Studio Code ou noutra ferramenta externa enquanto o projeto permanece aberto no Power BI Desktop. Para uma melhor experiência de edição TMDL, instale a extensão TMDL para o Visual Studio Code.
Antes de editar os ficheiros externamente, guarde quaisquer alterações no Power BI Desktop. Abre a pasta PBIP no VS Code, navega até à pasta semântica do modelo definition e guarda as tuas alterações TMDL. O Power BI Desktop deteta as alterações guardadas e mostra o banner Aplicar alterações externas. Selecione Aplicar alterações externas para recarregar o modelo semântico sem fechar e reabrir o projeto.
Se o Power BI Desktop tiver alterações não guardadas, avisa-te que aplicar as alterações externas irá sobreescrevê-las. Para o fluxo de trabalho completo e limitações, consulte Editar ficheiros PBIP fora do Power BI Desktop.
Para operações de escrita suportadas fora do Power BI Desktop, veja Autoria de Modelos.
Erros de TMDL
Se uma edição TMDL for inválida, o Power BI Desktop apresenta um erro quando aplica as alterações externas ou abre o projeto. O erro identifica a localização que deve corrigir antes que o Power BI Desktop possa carregar o modelo semântico atualizado:
