Projetos do Power BI Desktop (Pré-visualização)

Importante

Os projetos do Power BI Desktop estão atualmente em fase de pré-visualização.

Sugestão

Para obter orientação 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 pastas simples e intuitiva.

Salvar seu trabalho como um projeto tem os seguintes benefícios:

  • Suporte ao editor de texto - Os arquivos PBIP são arquivos de texto formatados contendo metadados de modelo semântico e relatório. Esses arquivos são publicamente documentados e legíveis por humanos. Embora os arquivos de 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 rica, incluindo intellisense, validação e integração com o Git.

  • Transparência da estrutura de pastas - Separe pastas para o modelo semântico e o relatório, permitindo tarefas poderosas e simples, como copiar tabelas de modelos semânticos entre projetos ou reutilizar páginas de relatório. Uma ótima opção para criar e reutilizar modelos de desenvolvimento.

  • Pronto para controle de código-fonte - Arquivos de texto abertos, projetados para integração perfeita com o Git, permitindo o histórico de versões e a colaboração em equipe. Para saber mais, consulte Controle de versão no Git.

  • Suporte a integração contínua e entrega contínua (CI/CD) - Aplique práticas de CI/CD sobre seus sistemas de controle de origem existentes usando arquivos PBIP, incorporando portas de qualidade e automatizando a implantação em ambientes de produção. Para saber mais sobre CI/CD no Fabric, consulte Fluxos de trabalho de CI/CD do Fabric.

  • Geração programática e edição de definições de item - Você pode gerar e modificar programaticamente arquivos de texto de definição de item, permitindo operações em lote, como atualizar todos os visuais de páginas de relatório ou adicionar um conjunto de medidas a cada tabela. Para modelos semânticos, você pode usar o TOM (Tabular Object Model) biblioteca de cliente para desserializar os metadados do modelo semântico, fazer modificações programáticas e serializá-los de volta para os arquivos.

Ativar funcionalidades de pré-visualização

Guardar como um Projeto do Power BI no Power BI Desktop está atualmente em pré-visualização e tem de o ativar em Funcionalidades de pré-visualização.

Vá para Opções de Arquivo > e configurações > Opções > Visualizar recursos e marque a caixa ao lado da opção de salvamento do Projeto do Power BI (.pbip).

Salvar como um projeto

Se estiver a trabalhar num novo projeto ou se tiver aberto um ficheiro existente do Power BI Desktop (pbix), pode guardar o seu trabalho como um ficheiro de projeto do Power BI (pbip):

Captura de tela mostrando salvar arquivo como Projeto do Power BI

Quando você salva como um projeto, o Power BI Desktop salva itens de modelo semântico e de relatório como pastas, cada uma contendo arquivos de texto que definem o item:

Project/
├── AdventureWorks.Report/
├── AdventureWorks.SemanticModel/
├── .gitignore
└── AdventureWorks.pbip

Vamos dar uma olhada mais de perto no que você vê na pasta raiz do seu projeto:

<nome> do projeto. Modelo Semântico

Uma coleção de arquivos e pastas que representam um modelo semântico do Power BI. Para saber mais sobre os ficheiros e subpastas existentes aqui, consulte a pasta Modelo Semântico do Projeto.

<nome> do projeto. Relatório

Uma coleção de arquivos e pastas que representam um relatório do Power BI. Para saber mais sobre os arquivos, subpastas e arquivos aqui, consulte Pasta de relatório do projeto.

.gitIgnorar

Especifica arquivos intencionalmente não rastreados que o Git deve ignorar para arquivos do Power BI Project, como cache.abf e localSettings.json.

O Power BI Desktop cria o arquivo .gitignore somente se ainda não existir um na pasta de salvamento escolhida ou no repositório Git pai.

Conteúdo padrão de .gitignore ao salvar como PBIP:

**/.pbi/localSettings.json
**/.pbi/cache.abf
<nome> do projeto.pbip

O ficheiro PBIP contém uma referência a uma pasta de um relatório; ao abrir um PBIP, são abertos o relatório referenciado e o modelo para edição.

Para obter mais informações, consulte o documento do 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 de relatório. Ambas as opções abrem 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, pois você pode abrir cada relatório diretamente do .pbir dentro da pasta do relatório.

project/
├── AdventureWorks-Sales.Report/
│   └── definition.pbir
├── AdventureWorks-Stocks.Report/
│   └── definition.pbir
├── AdventureWorks.SemanticModel/
│   └── definition.pbism
├── .gitignore
└── AdventureWorks.pbip

Depois de salvar como um projeto, você pode ver quando está trabalhando em um projeto olhando para a barra de título:

Captura de tela mostrando o título do Power BI Desktop ao salvar no projeto.

Se selecionar a barra de título, aparecerá um painel desdobrável que é específico para o Power BI Project. Este painel permite encontrar os ficheiros do projeto e as definições do nome a apresentar para o relatório e o modelo semântico. Você também pode abrir a pasta no explorador de arquivos clicando nos caminhos.

Captura de tela mostrando o submenu de título do Power BI Desktop.

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 somente no Power BI Desktop. Você pode usar outras ferramentas como VS Code, ferramentas de comunidade de código aberto como o Editor de Tabular ou até mesmo o Bloco de Notas. No entanto, nem todos os ficheiros ou alterações suportam a edição por ferramentas externas de código aberto.

Alterações em arquivos ou propriedades fora do Power BI Desktop podem causar erros inesperados ou até mesmo impedir a abertura do Power BI Desktop. Nesses casos, você deve 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:

Captura de ecrã do erro «não foi possível abrir o ficheiro».

Os detalhes do esquema para os seguintes arquivos não são documentados. Durante a visualização, não há suporte para alterações nesses arquivos fora do Power BI Desktop:

Implantar no Fabric Workspace

Ao trabalhar com arquivos de projeto do Power BI, você pode implantar seu conteúdo em um espaço de trabalho de malha usando os seguintes mecanismos de publicação:

Observação

A publicação através do Power BI Desktop publish utiliza um arquivo PBIX temporário que é publicado no serviço, de forma semelhante a salvar e publicar um arquivo PBIX. Ao contrário de outras opções de implementação de PBIP que implementam apenas metadados, este método de publicação implementa tanto os metadados como o cache de dados local do modelo semântico que está a ser editado.

Criação de modelos

Você pode fazer alterações na definição do modelo semântico usando ferramentas externas de duas maneiras:

  • Conectando-se à instância do Analysis Service (AS) do Power BI Desktop com ferramentas externas.
  • Editando metadados TMDL na pasta /definition usando VS Code ou outra ferramenta externa.

Todos os metadados do modelo semântico são acessíveis para leitura. As operações de gravação são totalmente suportadas, no entanto, esteja ciente de que modificar os metadados fora do Power BI Desktop pode resultar em um comportamento inesperado ou, em casos raros, levar a inconsistências no modelo. Tenha cuidado ao fazer alterações através de ferramentas externas.

Lembre-se:

  • Quando guarda alterações em ficheiros de projeto fora do Power BI Desktop, o Power BI Desktop deteta as alterações e pede-lhe para as aplicar com um único clique. Também pode abrir o projeto diretamente no Visual Studio Code usando o ponto de entrada integrado no Power BI Desktop.

  • As tabelas de data automáticas criadas pelo Power BI Desktop não devem ser alteradas usando ferramentas externas.

  • Se o modelo semântico tiver o recurso Data/hora automática habilitado e você criar uma nova coluna data/hora fora do Power BI Desktop, a tabela de data local não será gerada automaticamente.

  • Os modelos semânticos - como modelos compostos ou Direct Lake - podem incluir objetos e propriedades provenientes de outros modelos ou fontes de dados. Ao personalizar essas propriedades ou remover objetos sincronizados, o Power BI exige que a changedProperties propriedade e a PBI_RemovedChildren anotação sejam definidas. Esses indicadores marcam as alterações como personalizações do usuário, garantindo que elas sejam preservadas durante a próxima sincronização de esquema com a fonte de dados. Para saber mais, consulte Marcas de linhagem para modelos semânticos do Power BI.

  • Qualquer edição de expressão fora do Power BI Desktop em um projeto com unappliedChanges.json é perdida quando essas alterações são aplicadas.

Esquemas de arquivo JSON

A maioria dos arquivos de 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:

  • Saiba mais sobre as propriedades configuráveis.
  • Use a validação JSON embutida fornecida pelo editor de código.
  • Melhore a criação com realce de sintaxe, dicas de ferramentas e preenchimento automático.
  • Use ferramentas externas com conhecimento das propriedades suportadas nos metadados do projeto.

Use o VS Code para mapear esquemas JSON para os arquivos que estão sendo criados. Os esquemas JSON para arquivos de projeto são fornecidos no repositório Git json-schemas.

Considerações e limitações

  • O Power BI Desktop deteta alterações que faz usando outras ferramentas ou aplicações e solicita-o para as aplicar. Um ponto de entrada integrado no Power BI Desktop abre o projeto diretamente no Visual Studio Code.
  • Não há suporte para rótulos de sensibilidade em projetos do Power BI.
  • O modo de exibição de diagrama é ignorado ao editar modelos no Serviço.
  • Ao salvar um PBIP, lembre-se de que o comprimento máximo do caminho para arquivos de projeto é limitado a 260 caracteres por padrão no Windows. Como os arquivos PBIP são armazenados como subpastas e arquivos, nomes de objetos longos, como nomes de tabelas, podem fazer com que o comprimento total do caminho exceda esse limite, resultando em erros durante as operações de salvamento. Para reduzir esse risco, use um caminho de pasta curto como o local raiz do PBIP.
  • No Power BI Desktop, você não pode salvar como um PBIP diretamente no OneDrive e no SharePoint. Você pode usar Salvar como para salvar arquivos em uma pasta do OneDrive sincronizada localmente; no entanto, isso pode causar problemas de sincronização de arquivos, potencialmente levando a operações de salvamento com falha no Power BI Desktop.
  • Ao editar arquivos PBIP fora do Power BI Desktop, eles devem ser salvos usando UTF-8 sem codificação BOM.
  • O Esquema Linguístico de Relatório (sinónimos da página de relatório) não é suportado em projetos do Power BI.
  • O Power BI Desktop usa CRLF como fim de linha. Para evitar problemas em seus diffs, configure o Git para lidar com terminações de linha habilitando o autocrlf.
  • No momento, não há suporte para Projetos do Power BI na versão do Microsoft Power BI Desktop otimizada para o Servidor de Relatório do Power BI.
  • Não é possível obter e definir os membros das funções de segurança ao nível da linha utilizando a API REST do Fabric
  • Não é possível obter e configurar as partições de atualização incremental utilizando a API REST do Fabric. No entanto, ele exporta uma única partição usando a consulta definida na política de atualização.

Perguntas mais frequentes

Pergunta: Olhando para as definições de modelo semântico e pasta de item de relatório, 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 Power BI Project a partir de uma ferramenta ou aplicativo externo?

Resposta: Sim. O Power BI Desktop deteta alterações feitas aos ficheiros do projeto e pede-te para as aplicar com um único clique.

Pergunta: Se eu converter um PBIX em PBIP, posso convertê-lo de volta para PBIX?

Resposta: Sim. Você pode salvar um PBIX como um PBIP ou salvar um PBIP como um PBIX.

Pergunta: Posso converter PBIX em PBIP e vice-versa programaticamente?

Resposta: Não. Só pode converter um PBIX num PBIP e vice-versa no Power BI Desktop através de FicheiroGuardar como.

Pergunta: Posso implantar um projeto do Power BI Desktop no Azure Analysis Services (AAS) ou no SQL Server Analysis Services (SSAS)?

Resposta: Não. As definições de relatório de projeto do Power BI Desktop não são suportadas no AAS e no SSAS. E as definições de modelo usam metadados aprimorados exclusivos do Power BI. Para projetos AAS e SSAS, use o Microsoft Visual Studio para criação de modelos, Git e integração de DevOps do Azure.

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 simplesmente serve como um atalho para a pasta de 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.

Conteúdos relacionados

  • Last updated on