Projetos do Power BI Desktop (VERSÃO PRÉVIA)
Importante
Os projetos do Power BI Desktop estão atualmente em versão prévia.
Dica
Para obter as diretrizes sobre como planejar um desenvolvimento do Power BI, consulte Planejamento de implementação do Power BI.
O Power BI Desktop apresenta uma nova maneira de criar, colaborar e salvar seus projetos. Quando você salva seu trabalho como um Projeto do Power BI (PBIP), as definições de item de modelo semântico e de relatório são salvas como arquivos de texto sem formatação individuais em uma estrutura de pasta simples e intuitiva.
Salvar seu trabalho como um projeto tem os seguintes benefícios:
Suporte ao editor de texto: os arquivos de definição de item são arquivos de texto formatados em JSON que contêm modelo semântico e metadados de relatório. Esses arquivos são documentados publicamente e legíveis por humanos. Embora os arquivos do projeto ofereçam suporte a ferramentas simples de edição de texto, como o Bloco de Notas, é melhor usar um editor de código como o Visual Studio Code (VS Code), que fornece uma experiência de edição avançada, incluindo intelliSense, validação e integração do Git.
Programação de geração e edição de definições de item: você pode criar scripts usando a TMSL (Linguagem de Scripts do Modelo de Tabela) que é conhecida e fácil de usar ou criar os próprios aplicativos personalizados para fazer alterações nas definições de item. Os aplicativos podem ser baseados na documentação pública dos esquemas de definição do item e/ou bibliotecas cliente.
Controle do código-fonte: as definições de item do relatório e do modelo semântico do Power BI podem ser armazenados em um sistema de controle do código-fonte, como o Git. Com o Git, você pode acompanhar o histórico de versões, comparar revisões (diff) e reverter para versões anteriores. O controle do código-fonte também pode desbloquear a colaboração ao usar o Power BI Desktop utilizando mecanismos de colaboração familiares para resolver conflitos (mesclagem) e revisar alterações (solicitações de pull). Para saber mais, confira Controle de versão no Git.
Integração contínua e entrega contínua (CI/CD) - Você pode usar sistemas em que os desenvolvedores da sua organização enviam uma alteração proposta para o sistema de CI/CD. Em seguida, o sistema valida a alteração com uma série de portões de qualidade antes de aplicar a alteração ao sistema de produção. Esses portões de qualidade podem incluir revisões de código por outros desenvolvedores, testes automatizados e build automatizado para validar a integridade das alterações. Os sistemas de CI/CD normalmente são criados com base em sistemas de controle do código-fonte existentes. Para saber mais, confira DevOps - Integração contínua e DevOps - Entrega contínua.
Habilitar versão prévia de recursos
Salvar como um projeto do Power BI no Power BI Desktop está atualmente em versão prévia e você deve habilitá-lo em Recursos em versão prévia.
Vá para Arquivo > Opções e configurações > Opções > Recursos em versão prévia e marque a caixa ao lado da Opção salvar Projeto do Power BI (.pbip).
Salvar como um projeto
Se você estiver trabalhando em um novo projeto ou tiver aberto um arquivo do Power BI Desktop (pbix) existente, poderá salvar seu trabalho como um arquivo do projeto do Power BI (pbip):
Quando você salva como um projeto, o Power BI Desktop salva itens de modelos semânticos e relatórios como pastas, cada uma contendo arquivos de texto que definem o item:
Depois de salvar como um projeto, você poderá ver quando estiver trabalhando em um projeto examinando a barra de título:
Se você clicar na barra de título, será exibido um submenu específico para o Projeto do Power BI. Esse submenu permite localizar os arquivos de projeto e as configurações de nome de exibição para o relatório e o modelo semântico. Você também pode abrir a pasta no explorador de arquivos clicando nos caminhos.
Vamos examinar mais detalhadamente o que você vê na pasta raiz do projeto:
<nome do projeto>.SemanticModel
Uma coleção de arquivos e pastas que representam um modelo semântico do Power BI. Para saber mais sobre os arquivos e subpastas e arquivos aqui, confira a pasta do Modelo Semântico do Projeto.
<nome do projeto>.Report
Uma coleção de arquivos e pastas que representam um relatório do Power BI. Para saber mais sobre os arquivos e subpastas e arquivos aqui, confira a Pasta do relatório do projeto.
.gitIgnore
Especifica arquivos não rastreados intencionalmente que o Git deve ignorar para arquivos do Projeto do Power BI, como cache.abf e localSettings.json.
O Power BI Desktop criará o arquivo .gitignore somente se ainda não existir um na pasta salvar ou no repositório Git pai escolhido.
Conteúdo padrão de .gitignore ao salvar como PBIP:
**/.pbi/localSettings.json
**/.pbi/cache.abf
<nome do projeto>.pbip
O arquivo PBIP contém um ponteiro para uma pasta do relatório, a abertura de um PBIP abre o relatório e o modelo de destino para criação.
Para obter mais informações, confira a documento de esquema pbip.
Abrir um Projeto do Power BI
Você pode abrir o Power BI Desktop na pasta Projeto do Power BI abrindo o arquivo pbip ou o arquivo pbir na pasta do relatório. Ambas as opções abrirão o relatório para edição e o modelo semântico, se houver uma referência relativa a um modelo semântico.
Você pode salvar vários relatórios e modelos semânticos na mesma pasta. Não é necessário ter um arquivo pbip separado para cada relatório porque você pode abrir cada relatório diretamente do .pbir dentro da pasta de relatórios.
├── project
│ ├── AdventureWorks-Sales.Report
│ │ └── definition.pbir
│ ├── AdventureWorks-Stocks.Report
│ │ └── definition.pbir
│ ├── AdventureWorks.SemanticModel
| | └── *.*
│ .gitignore
└── AdventureWorks.pbip
Alterações fora do Power BI Desktop
Quando salvo como um projeto, você não é forçado a fazer alterações em seu modelo semântico e definições de relatório apenas no Power BI Desktop. Você pode usar outras ferramentas, como o VS Code, ferramentas da comunidade de código aberto, como o Editor Tabular ou até mesmo o Bloco de Notas. No entanto, nem todos os arquivos ou alterações dão suporte à edição por ferramentas de código aberto externas.
Alterações em arquivos ou propriedades fora do Power BI Desktop podem causar erros inesperados ou até mesmo impedir que o Power BI Desktop seja aberto. Nesses casos, você deverá resolver os problemas nos arquivos antes de tentar abrir o projeto novamente no Power BI Desktop.
Se possível, o Power BI Desktop indica o arquivo e o local do erro:
Os detalhes do esquema dos arquivos a seguir não estão documentados. Durante a versão prévia, não há suporte para alterações nesses arquivos fora do Power BI Desktop:
- Report\
- SemanticModel\
Criação de modelos
Há duas maneiras de fazer alterações na definição do modelo semântico usando ferramentas externas:
- Conectando-se à instância do Analysis Service (AS) do Power BI Desktop com ferramentas externas.
- Editando metadados JSON no arquivo model.bim usando o VS Code ou outra ferramenta externa.
Nem todo objeto de modelo é compatível com as operações de gravação. A aplicação de alterações fora dos limites com suporte pode causar resultados inesperados.
Objetos com suporte a operações de gravação:
| Objeto | Conectar-se à instância do AS | Alteração do arquivo |
|---|---|---|
| Tabelas | Não | Sim |
| Colunas | Sim 1, 2 | Sim |
| Tabelas calculadas | Sim | Sim |
| Colunas calculadas | Sim | Sim |
| Hierarquias | Sim | Sim |
| Relações | Sim | Sim |
| Medidas | Sim | Sim |
| KPIs do modelo | Sim | Sim |
| Grupos de cálculo | Sim | Sim |
| Perspectivas | Sim | Sim |
| Traduções | Sim | Yes |
| RLS (Segurança em Nível de Linha) | Yes | Yes |
| Segurança no Nível do Objeto (OLS) | Sim | Sim |
| Anotações | Sim | Sim |
| Expressões M | Não | Sim 3, 4 |
Tenha em mente que:
Qualquer alteração nos arquivos abertos feitas fora do Power BI Desktop requer uma reinicialização para que essas alterações sejam mostradas no Power BI Desktop. O Power BI Desktop não está ciente das alterações nos arquivos de projeto feitas por outras ferramentas.
O Power BI Desktop não dá suporte a tabelas com várias partições. Há suporte apenas para uma única partição para cada tabela. Criar tabelas com partições vazias ou mais de uma partição resulta em um erro ao abrir o relatório.
As tabelas de datas automáticas criadas pelo Power BI Desktop não devem ser alteradas com ferramentas externas.
Ao alterar um modelo que usa Direct Query para conectar um modelo semântico do Power BI ou um modelo do Analysis Services, você deve atualizar a coleção ChangedProperties e PBI_RemovedChildren do objeto alterado para incluir quaisquer propriedades modificadas ou removidas. Se ChangedProperties e/ou PBI_RemovedChildren não estiver atualizado, o Power BI Desktop poderá substituir as alterações na próxima vez que a consulta for editada ou o modelo for atualizado no Power BI Desktop.
1 - Há suporte para a alteração do tipo de dados de uma coluna. No entanto, não há suporte para renomear colunas ao se conectar à instância do AS.
2: se o modelo semântico tiver o recurso Data/hora automática habilitado e você criar uma nova coluna datetime fora do Power BI Desktop, a tabela de datas local não será gerada automaticamente.
3 - A partição SourceType deve ser Calculated, M, Entity ou CalculationGroup. O Modo da partição deve ser Import, DirectQuery ou Dual.
4 - Todas as edições de expressão fora de Power BI Desktop em um projeto com unappliedChanges.json são perdidas quando essas alterações são aplicadas.
Modificar expressões de consulta de tabelas fora do Power BI Desktop faz com que os dados da tabela sejam removidos ao reiniciar o Power BI Desktop.
Esquemas do arquivo JSON
A maioria dos arquivos do projeto contém metadados no formato JSON. Os esquemas JSON correspondentes podem ser usados para validação e documentação.
Com esquemas JSON, você pode:
- Saber mais sobre propriedades configuráveis.
- Usar a validação JSON embutida fornecida pelo editor de código.
- Melhorar a criação com realce de sintaxe, dicas de ferramenta e preenchimento automático.
- Usar ferramentas externas com conhecimento das propriedades compatíveis nos metadados do projeto.
Usar o VS Code para mapear esquemas JSON para os arquivos que estão sendo criados. Esquemas JSON para arquivos do projeto são fornecidos no repositório Git de exemplos do Power BI Desktop.
Considerações e limitações
- O Power BI Desktop não reconhece as alterações feitas com outras ferramentas ou aplicativos. As alterações feitas usando ferramentas externas exigem que você reinicie o Power BI Desktop antes que essas alterações sejam mostradas.
- Os rótulos de confidencialidade não são compatíveis com os projetos do Power BI.
- A exibição do diagrama é ignorada ao editar modelos no Serviço.
- Ao salvar como um Projeto do Power BI, o comprimento máximo do caminho dos arquivos de projeto é de 260 caracteres.
- No Power BI Desktop, você não pode salvar como um PBIP diretamente no OneDrive e no SharePoint.
- Ao editar arquivos PBIP fora do Power BI Desktop, eles devem ser salvos usando UTF-8 sem codificação BOM.
- Não há suporte para o Esquema Linguístico de Relatório com projetos do Power BI.
- O Power BI Desktop usa CRLF como fim de linha. Para evitar problemas em suas diferenças, configure o Git para lidar com terminações de linha habilitando o autocrlf.
- Atualmente, não há suporte para projetos do Power BI na versão do Microsoft Power BI Desktop otimizada para o Servidor de Relatórios do Power BI.
- Relatórios do Live Connect salvos como PBIP exigem que o Ponto de extremidade XMLA seja habilitado.
Perguntas frequentes
Pergunta: examinando as definições da pasta de item do relatório e do modelo semântico, apenas alguns arquivos são marcados como necessários, o que acontece se eu excluí-los?
Resposta: O Power BI Desktop os cria automaticamente quando você salva como um projeto (PBIP).
Pergunta: O Power BI Desktop está ciente das alterações que faço nos arquivos do Projeto do Power BI de uma ferramenta ou aplicativo externo?
Resposta: Não. Qualquer alteração feita nos arquivos requer que o Power BI Desktop sejam reiniciados para refletir essas alterações.
Pergunta: Se eu converter um PBIX em um PBIP, posso convertê-lo novamente em PBIX?
Resposta: Sim. Você pode salvar um PBIX como um PBIP ou salvar um PBIP como um PBIX.
Pergunta: Posso programar para converter PBIX em PBIP e vice-versa?
Resposta: Não. Você só pode converter um PBIX em um PBIP e vice-versa usando Arquivo>Salvar como do Power BI Desktop.
Pergunta: Posso implantar um projeto do Power BI Desktop no Azure Analysis Services (AAS) ou SQL Server Analysis Services (SSAS)?
Resposta: Não. As definições do relatório do projeto do Power BI Desktop não são compatíveis no AAS e no SSAS. E as definições de modelo usam metadados aprimorados exclusivos para o Power BI. Para projetos do AAS e do SSAS, use o Microsoft Visual Studio para criação de modelos, Git e integração do Azure DevOps.
Pergunta: Por que não há um arquivo *.pbip quando conecto meu espaço de trabalho do Fabric ao Git? Como posso editar meu relatório e modelo semântico no Power BI Desktop?
Resposta: O arquivo PBIP é opcional e serve simplesmente como um atalho para a pasta do relatório. Você pode abrir o relatório e o modelo semântico para edição no Power BI Desktop abrindo o arquivo definition.pbir localizado na pasta do relatório.