PBIP en Power BI: cómo versionar informes con Git y no depender de un archivo

PBIP, o Proyecto de Power BI, es el formato que guarda un informe de Power BI Desktop como una carpeta de archivos de texto, en lugar de un único archivo .pbix. Con él, el informe y el modelo de datos pueden ir a un repositorio Git, que guarda cada versión, muestra exactamente qué cambió y permite volver atrás. Para la empresa, es la forma de dejar de depender del archivo que está en el portátil de alguien.

Quien ya gestiona un área de BI conoce la escena: una carpeta compartida con "ventas_final_v3_ahora_si.pbix", una medida que cambió sin que nadie sepa quién la cambió, un informe publicado encima de otro el viernes por la tarde. El .pbix es un archivo cerrado, binario, y por eso no se pueden comparar dos versiones línea por línea. El PBIP resuelve ese punto y abre el camino para trabajar con BI igual que los equipos de software trabajan con código.

En esta guía verás qué es el PBIP, la diferencia práctica con el PBIX, cómo empezar a versionar informes con Git, los cuidados y limitaciones del formato y qué exigir a quien desarrolla tus paneles.

¿Qué es PBIP en Power BI?

Cuando usas Archivo y Guardar como en Power BI Desktop y eliges el tipo Proyecto de Power BI (.pbip), el trabajo deja de ser un solo archivo y se convierte en una carpeta con subcarpetas. La documentación de Microsoft sobre proyectos de Power BI describe esta estructura básica:

• Carpeta del informe (nombre.Report): las páginas, los visuales y los filtros, descritos en archivos de texto.
• Carpeta del modelo semántico (nombre.SemanticModel): las tablas, las relaciones, las medidas DAX y las consultas que traen los datos. El modelo puede guardarse en TMDL, un lenguaje de texto pensado para describir modelos tabulares de forma legible.
• Archivo .pbip: un acceso directo que abre el informe y el modelo para edición en Power BI Desktop.
• Archivo .gitignore: le dice a Git qué no debe versionarse, como la caché local con los datos importados.

En la práctica, una medida DAX, que es una fórmula de cálculo de Power BI, se convierte en unas líneas de texto en un archivo. Si alguien cambia la regla de la facturación neta, el cambio aparece resaltado, con autor y fecha. Eso es lo que Git, el sistema de control de versiones más usado del mundo, sabe hacer muy bien.

PBIX o PBIP: ¿cuál es la diferencia en la práctica?

Los dos formatos se abren en el mismo Power BI Desktop y generan el mismo informe publicado. La diferencia está en cómo se guarda y se revisa el trabajo:

• Formato: el PBIX es un único archivo binario; el PBIP es una carpeta de archivos de texto.
• Comparación de versiones: en el PBIX, solo abriendo los dos archivos y buscando la diferencia a ojo; en el PBIP, Git muestra línea por línea qué cambió.
• Datos: el PBIX suele llevar los datos importados dentro del archivo; en el PBIP, la caché de datos queda fuera del control de versiones por defecto.
• Trabajo en equipo: en el PBIX, dos personas en el mismo archivo casi siempre significa una sobrescribiendo a la otra; en el PBIP, cada una trabaja en una copia y los cambios se unen después.
• Edición fuera de Desktop: el PBIP acepta editores de código y herramientas externas para algunas tareas, como cambiar varias medidas a la vez.

El cambio no es definitivo. El propio Guardar como de Power BI Desktop convierte un PBIX en PBIP y un PBIP de vuelta en PBIX, así que puedes probar el formato en un informe antes de cambiar el estándar del equipo.

¿Por qué versionar informes de Power BI con Git?

Para un gestor, versionar no es un capricho técnico. Es una forma de reducir el riesgo en un activo que la dirección usa para decidir. Las ganancias más concretas son estas:

• Historial completo: cada cambio queda registrado con quién lo hizo, cuándo y por qué.
• Vuelta rápida: si un número empieza a salir mal después de un cambio, se puede volver a la versión anterior en minutos.
• Revisión antes de publicar: una segunda persona revisa el cambio de una medida antes de que llegue a la dirección.
• Trabajo en paralelo: dos personas evolucionan el mismo modelo en ramas separadas, sin que una borre el trabajo de la otra.
• Propiedad: el código del informe queda en un repositorio de la empresa, y no en la computadora de un empleado o de un proveedor.

Este último punto pesa cuando el desarrollo está tercerizado. En la guía sobre cómo contratar un freelancer Power BI, la recomendación es exigir que los archivos y el código queden con la empresa; con PBIP y Git, eso deja de ser una promesa y pasa a ser verificable en cada entrega.

¿Cómo empezar a usar PBIP con Git en la empresa?

No hace falta migrar todo de una vez. Un buen comienzo es elegir un informe importante, con un responsable claro, y seguir este paso a paso:

1. Crea un repositorio en la cuenta de la empresa, en Azure DevOps o GitHub, con acceso por usuarios corporativos.
2. Abre el informe en Power BI Desktop y usa Guardar como, tipo Proyecto de Power BI, en una carpeta de ruta corta, porque Windows limita el tamaño de la ruta de los archivos.
3. Evita guardar el proyecto directamente en una carpeta sincronizada de OneDrive o SharePoint; la sincronización puede entorpecer el guardado.
4. Mantén el .gitignore creado por Desktop, que deja fuera la caché de datos y las configuraciones locales.
5. Configura Git para tratar los finales de línea, como recomienda la documentación, para que la comparación de versiones no muestre cambios falsos.
6. Haz el primer registro (commit) con el estado actual del informe y escribe qué representa.
7. Acuerda la regla del equipo: todo cambio nace en una rama propia y solo entra en la versión principal después de ser revisado por otra persona.
8. Separa los ambientes: un workspace de desarrollo para probar y uno de producción, que es el que ve la dirección.

¿Y la integración con Git en el workspace?

Además de versionar en la computadora de quien desarrolla, Microsoft Fabric permite conectar un workspace entero a un repositorio. Según la visión general de la integración con Git de Fabric, los proveedores admitidos son Azure DevOps, GitHub y GitHub Enterprise, todos en la nube, y los informes y modelos semánticos aparecen en la lista de elementos compatibles todavía como versión preliminar. El acceso a este recurso depende del licenciamiento de la empresa, así que revisa el requisito actual antes de planificar el flujo.

¿Cuáles son los cuidados y las limitaciones del PBIP?

El formato resuelve el versionado, pero tiene puntos que deben entrar en la decisión:

• Las etiquetas de confidencialidad no son compatibles con los proyectos de Power BI; si tu empresa usa esas etiquetas, evalúalo antes con el área de seguridad.
• La versión de Power BI Desktop optimizada para Report Server no abre proyectos PBIP.
• Editar archivos fuera de Desktop exige cuidado: algunos archivos no admiten edición externa y un error puede impedir que el proyecto se abra hasta que se corrija.
• Los datos no van al repositorio, lo que es bueno para la seguridad, pero quien descargue el proyecto necesita acceso a las fuentes para actualizar los datos.
• Las contraseñas y credenciales de las fuentes nunca deben grabarse en los archivos del proyecto.

Ninguno de estos puntos impide su uso en la mayoría de las empresas, pero conviene listarlos antes de convertir el PBIP en estándar para todos los informes.

¿Qué exigir a quien desarrolla tus informes?

Sea un equipo interno, un freelancer o una consultoría Power BI, estas preguntas muestran rápido si el trabajo está organizado para durar:

• ¿El código de los informes está en un repositorio de la empresa, en formato PBIP?
• ¿Cada cambio tiene un registro con una descripción clara de qué se modificó y por qué?
• ¿Existe revisión por otra persona antes de que una medida importante llegue a producción?
• ¿Hay workspaces separados para desarrollo y producción?
• ¿Las reglas de los indicadores están documentadas en lenguaje claro, junto con el código?
• ¿Si el desarrollador se va mañana, otra persona puede abrir el proyecto y continuar?

Si la mayoría de las respuestas es no, el problema no es falta de herramienta, sino de proceso. Este también es un buen criterio a la hora de comparar proveedores, como muestra la guía sobre cómo elegir una consultoría Power BI.

Cómo ayuda Wolkee

En Wolkee, el mismo equipo sénior se ocupa de los dashboards en Power BI, de la ingeniería de datos con Microsoft Fabric y Azure, de las integraciones y de las automatizaciones. Son 9 años en el mercado, más de 500 entregas y proyectos en 8 países, en áreas como energía solar, contact center, ventas y finanzas.

Si tus informes hoy viven en archivos sueltos y quieres organizar versiones, ambientes y responsables, empieza con un diagnóstico gratuito de 30 minutos. Respondemos en hasta 1 día hábil y, cuando tiene sentido, presentamos un prototipo funcional antes del contrato.

Preguntas frecuentes

¿El PBIP reemplaza al archivo PBIX?

No necesariamente. Los dos formatos conviven y Power BI Desktop convierte uno en otro con Guardar como, en los dos sentidos. El PBIX sigue siendo práctico para informes simples, de una sola persona. El PBIP tiene más sentido cuando el informe es importante, cambia con frecuencia o lo mantiene más de una persona, porque permite historial y revisión de los cambios.

¿Necesito saber programar para usar PBIP?

Para guardar y abrir un proyecto PBIP, no: todo se sigue haciendo en Power BI Desktop. Lo que cambia es la rutina de versionado, que pide nociones básicas de Git, como registrar un cambio, crear una rama y revisar una modificación. Editores visuales, como Visual Studio Code, facilitan bastante ese trabajo a quien viene de Excel y Power BI.

¿Los datos de la empresa quedan guardados en el repositorio Git?

Por defecto, no. El archivo .gitignore que crea Power BI Desktop deja fuera la caché con los datos importados y las configuraciones locales, así que el repositorio guarda la definición del informe y del modelo, no las filas de las tablas. Aun así, nombres de servidores y estructuras de tablas aparecen en los archivos, por eso el repositorio debe ser privado y de la empresa.

¿PBIP funciona con Power BI Report Server?

No, por ahora. La documentación de Microsoft informa que la versión de Power BI Desktop optimizada para Report Server no abre proyectos de Power BI. Las empresas que publican informes en su propio servidor, sin usar el servicio en la nube, deben seguir con el formato PBIX o planificar la migración a Power BI en la nube antes de adoptar el PBIP.

Piterson Alves

Socio y director comercial de Wolkee

Empezó en el área técnica, pasó por la preventa consultiva y hoy acompaña los proyectos de BI, datos y automatización de Wolkee, del diagnóstico a la entrega.

LinkedIn