Power BI
Power BI Git: PBIP, TMDL und drei Reifegradstufen bis CI/CD
Lernen Sie Power BI Git in drei Reifegradstufen kennen: SharePoint, PBIP+Git mit Pull Requests und Service-Principal-CI/CD inklusive Kosten, Grenzen und Migrationspfad
Inhalt
- Kurzantwort
- Das Wichtigste in Kürze
- Warum eine Reifegrad-Entscheidung, nicht „einfach Git aufsetzen"
- Die drei Reifegradstufen im Überblick
- Stufe 1: SharePoint-Versionierung für Ein-Personen-Teams
- Stufe 2: PBIP + Git mit Pull-Request-Reviews
- Repo-Struktur und Branch-Strategie in Stufe 2
- Die Falle: TMDL und TMSL gleichzeitig aktiviert
- Stufe 3: Service-Principal-getriebenes CI/CD
- Service Principal, Tenant-Setting und Pipeline-Definition
- Workspace-Git-Integration ist nicht CI/CD
- Entscheidungstabelle: Welche Stufe passt heute?
- Typische Migrationsfehler zwischen den Stufen
- Was das für eine Fabric-Migration bedeutet
- Zusammenfassung
- Weiterlesen bei DBI
- Häufig gestellte Fragen
- Über DBI Analytics
Kurzantwort
Wie versioniert man Power BI mit Git?
Power BI lässt sich mit Git versionieren, seit das PBIP-Format einen Bericht als Ordner aus Textdateien speichert und TMDL jede Tabelle und Measure einzeln ablegt. In der Praxis gibt es drei Stufen: SharePoint-Versionshistorie für 1 bis 2 Entwickler, PBIP mit Git und Pull Requests für 3 bis 8 Entwickler, und Service-Principal-CI/CD für mehrere parallele Workspaces. Stufe 2 braucht 2 bis 3 Tage Setup. Stufe 3 setzt einen Tenant-Schalter voraus, den nur der Tenant-Admin aktiviert.
Wenn Sie Power-BI-Berichte heute in einem Team pflegen, kennen Sie den Punkt, an dem die geteilte PBIX auf dem Laufwerk nicht mehr reicht. Zwei Entwickler überschreiben sich, ein Rollback kostet eine Stunde Telefonkonferenz, und niemand kann sagen, welches Measure sich zwischen Freitag und Montag geändert hat. Die Antwort heißt Power BI Git — aber nicht in einer einzigen großen Umstellung. In diesem Post zeigen wir Ihnen die drei Reifegradstufen, die wir in DACH-Projekten tatsächlich produktiv gesehen haben: SharePoint-Versionierung, PBIP+Git mit Pull Requests und Service-Principal-CI/CD, jeweils mit Kosten, Grenzen und dem konkreten Migrationspfad zur nächsten Stufe.
Das Wichtigste in Kürze#
- Drei Reifegrade decken alle Teamgrößen ab: Stufe 1 für 1–2 Entwickler, Stufe 2 für 3–8 Entwickler, Stufe 3 ab mehreren parallelen Workspaces.
- Stufe 1 (SharePoint) kostet 0 € Zusatzlizenz und liefert Rollback über die Versionshistorie. Parallelarbeit an derselben PBIX blockiert sie.
- Stufe 2 (PBIP + Git) braucht 2–3 Tage Setup und 1–2 Wochen Lernkurve. Pull Requests zeigen pro Measure die geänderten Zeilen.
- Stufe 3 (Service Principal + CI/CD) automatisiert das Deployment. Sie setzt den Tenant-Setting-Schalter voraus, den nur der Tenant-Admin aktiviert.
- Falle beim Setup: TMDL und TMSL dürfen nicht gleichzeitig aktiv sein. Sonst scheitert jedes
pbip-Öffnen mit einem Fehler zumodel.bim. - Migrationsregel: Eine Stufe sauber beherrschen, dann die nächste bauen. Stufe 3 ohne Stufe 2 scheitert an der Adoption.
Warum eine Reifegrad-Entscheidung, nicht „einfach Git aufsetzen"#
Teams kommen fast immer mit derselben Erwartung zu Power BI Git: ein Repository, Branches, Pull Requests, fertig. In der Praxis scheitert dieser Einstieg an drei Stellen. Entweder ist das Team zu klein, dann wird Git zum Zeitfresser ohne Nutzen. Oder der Tenant-Admin schaltet Service Principals nicht frei, dann hängt das CI/CD-Setup. Oder die Branch-Protection ist zu streng, dann umgehen Entwickler die Regeln und pushen trotzdem direkt auf main.
Die Antwort darauf ist nicht, Git zu vermeiden. Die Stufe muss zur Teamgröße und zum Tenant-Kontext passen. Dafür unterscheiden wir drei Stufen mit klaren Kipp-Punkten.
Die drei Reifegradstufen im Überblick#
| Stufe | Tool-Stack | Team | Setup-Aufwand | Blockiert |
|---|---|---|---|---|
| 1 — SharePoint | PBIX in SharePoint-Ordner | 1–2 Entwickler | 0 Tage | Parallelarbeit, Diffs |
| 2 — PBIP + Git | PBIP, TMDL, Repo, PR-Reviews | 3–8 Entwickler | 2–3 Tage | Automatisches Deployment |
| 3 — CI/CD | Service Principal, Pipeline | ab 5 Entwicklern oder mehreren Workspaces | 5–10 Tage | — |
Für die operative Einbettung dieser Stufen beschreibt BI Operations im Agentic-BI-Leitfaden Review-Zyklen, Deployment-Fenster und Rollback-Prozesse im Betrieb.
Stufe 1: SharePoint-Versionierung für Ein-Personen-Teams#
SharePoint-Versionierung ist der richtige Einstieg, wenn ein oder zwei Entwickler an einem Bericht arbeiten. Das Team war noch nie mit Git in Berührung. Die Hürde liegt bei null: Jede PBIX-Datei in einem SharePoint-Ordner bekommt automatisch eine Versionshistorie. Jede Speicherung erzeugt eine neue Version, Rollback ist ein Klick. Dafür bleibt jede Änderung auf Datei-Ebene; eine Diff pro Measure gibt es nicht.
| Position | Kosten |
|---|---|
| Lizenz zusätzlich | 0 € |
| Setup-Aufwand | ca. 30 min (Ordner anlegen, Zugriffe setzen) |
| Lernkurve Team | 0 Tage |
| Laufende Pflege | 0 Tage/Monat |
Die Grenzen sind hart. Die binäre PBIX ist beim Öffnen gesperrt, zwei Entwickler können nicht parallel editieren. Ein Diff pro Measure existiert nicht, nur „Version 14 vs. Version 15" auf Dateiebene. Einen Merge gibt es nicht, die zuletzt gespeicherte Version ist produktiv. Und die Audit-Spur dokumentiert nur, dass sich etwas geändert hat, nicht was.
Sobald zwei Entwickler gleichzeitig am selben Bericht arbeiten, ist Stufe 1 ausgereizt. Der Migrationsschritt hat drei Teile: das PBIP-Preview-Feature in Power BI Desktop aktivieren und den Bericht als .pbip speichern, ein Git-Repository anlegen (Azure DevOps oder GitHub) und den PBIP-Ordner committen, Branch-Protection auf main einrichten, bevor der erste Pull Request fließt.
Stufe 2: PBIP + Git mit Pull-Request-Reviews#
PBIP+Git ist der Standard für Teams zwischen 3 und 8 Entwicklern. Das Format trennt den Bericht (.Report-Ordner, JSON) vom semantischen Modell (.SemanticModel-Ordner, TMDL). TMDL (Tabular Model Definition Language) legt jedes Measure, jede Tabelle und jede Beziehung in einer eigenen Textdatei ab. Damit wird Git zum funktionierenden Diff-Werkzeug. Ein Pull Request zeigt genau die drei geänderten Measures, nicht eine binäre Datei. Dabei bleibt die visuelle Freigabe im Review-Prozess, Git selbst rendert keine Berichte.
| Position | Aufwand / Kosten |
|---|---|
| Lizenz zusätzlich | 0 € (Repo in Azure DevOps Free Tier oder GitHub Free möglich) |
| Setup-Aufwand | 2–3 Tage (Repo-Struktur, Branch-Protection, erste Migrationen) |
| Lernkurve Team | 1–2 Wochen (für ein Team ohne Git-Erfahrung) |
| Laufende Pflege | ca. 2 Stunden/Monat pro 1.000 Commits |
Repo-Struktur und Branch-Strategie in Stufe 2#
Die folgende Struktur hat sich in vier Konzernprojekten gehalten und überlebt den Wechsel zwischen Azure DevOps und GitHub ohne Umbau:
project-root/
├── PowerBI/
│ ├── Binaries/ # Gezippte PBIX-Stände pro Release
│ ├── ProjectFiles/ # Die .pbip-Files samt .Report und .SemanticModel
│ ├── PaginatedReports/ # .rdl für Paginated Reports
│ ├── Dataflows/ # Dataflow-JSONs
│ ├── SourceFiles/ # Excel-Mappings, CSVs
│ └── ReferenceFiles/ # QA-Vergleichszahlen
├── README.md
└── .gitignoreFeature-Branches schlagen einen geteilten dev-Branch ab drei Entwicklern. Jeder Entwickler arbeitet isoliert und öffnet einen Pull Request gegen staging. Dort wird gereviewt und gemerged. Ein durchgesetztes Namensschema sorgt dafür, dass jeder Branch einem Ticket zuordenbar bleibt:
^feat\/[A-Z]+-[0-9]+(-[a-zA-Z0-9-]+)*$Diese Regex erlaubt feat/PROJ-456-revenue-dashboard. Sie verbietet feature/myfix oder fix_kpi. In GitHub-Rulesets oder Azure-DevOps-Branch-Policies hinterlegt, wird sie technisch durchgesetzt.
| Regel | main (Prod) | staging (QA) | dev | feat/* |
|---|---|---|---|---|
| Pull Request erforderlich | Ja | Ja | Ja | Nein |
| Erforderliche Approvals | 2 | 1 | 1 | — |
| Stale Approvals verwerfen | Ja | Ja | Ja | — |
| Force Push blockieren | Ja | Ja | Ja | Optional |
| Status Checks erforderlich | Ja | Ja | Ja | Nein |
| Branch-Naming-Regex | — | — | — | Ja |
Die Falle: TMDL und TMSL gleichzeitig aktiviert#
In den Power-BI-Optionen unter „Vorschaufunktionen" stehen zwei Haken nebeneinander: „Power BI Project (.pbip) save option" und „Store semantic model using TMDL format". Sind beide aktiv, schreibt Power BI parallel sowohl model.bim (TMSL) als auch .tmdl-Dateien. Beim nächsten Öffnen scheitert die Datei mit:
You cannot have both TMDL and TMSL formats in the same PBIP.
Offending file: ...\YOUR_MODEL.SemanticModel\model.bimDie saubere Konfiguration: Nur PBIP aktivieren, TMDL erst nachziehen, wenn das Projekt komplett umgestellt wird. Wer bereits beide aktiv hatte, löscht model.bim manuell, wenn das Modell in TMDL bleiben soll. Soll weiter in TMSL gearbeitet werden, löscht er die .tmdl-Dateien. Diese Entscheidung fällt vor dem ersten Commit und wird im Repo dokumentiert. Wie das Modell danach beschrieben und für die Nutzung aufbereitet wird, zeigt das Guide-Kapitel Power BI Dokumentation.
Was Stufe 2 nicht kann: Automatisches Deployment nach Merge ist nicht enthalten, Deployment Pipelines im Power BI Service werden manuell ausgelöst. Deployment unter einem technischen Account funktioniert nicht, solange der Deployment-Lauf am persönlichen Konto hängt. Parallele Deployment-Freigaben für mehrere Workspaces sind ohne Service Principal nicht zentral steuerbar.
Stufe 3: Service-Principal-getriebenes CI/CD#
CI/CD in Power BI lohnt sich, sobald eine dieser Bedingungen zutrifft. Mehr als zwei Workspaces (DEV/TEST/PROD oder mehrere Fachbereichs-Workspaces) werden parallel deployed. Regulatorische Vorgaben fordern einen dokumentierten, reproduzierbaren Deployment-Prozess ohne Einzelpersonen. Das Deployment-Fenster ist eng (nachts, am Wochenende) und manuell nicht mehr darstellbar. Oder das Team ist größer als fünf Entwickler, und das manuelle Pipeline-Klicken wird zum Engpass.
| Position | Aufwand / Kosten |
|---|---|
| Lizenz zusätzlich | Premium Capacity oder PPU für Deployment-Pipelines (ab ~20 €/Nutzer/Monat PPU) |
| Setup-Aufwand | 5–10 Tage (Service Principal, Tenant-Setting, Pipeline-Definition, erste Tests) |
| Lernkurve Team | 1 Woche für Infrastruktur-Verantwortlichen, 0 für restliches Team |
| Laufende Pflege | ca. 1 Stunde/Monat (Monitoring, Secret-Rotation) |
Service Principal, Tenant-Setting und Pipeline-Definition#
Erstens: Ein Service Principal ist ein Anwendungsaccount im Microsoft-365-Tenant. Er repräsentiert keine Person, sondern eine Anwendung. In Azure AD angelegt, bekommt er ein Client-Secret und wird einer Security Group zugeordnet. Diese Gruppe ist im Power BI Tenant berechtigt. Er handelt nur dort, wo die Security Group Rechte hat; Zugriffe außerhalb bleiben gesperrt.
Zweitens: Das Tenant-Setting „Service principals can access the Power BI APIs" muss im Power BI Admin Portal aktiv sein. Es wird auf die Security Group des Service Principals gescopt. Dieser Schalter ist der häufigste Engpass in Konzern-Projekten, weil nur der Tenant-Admin ihn aktiviert.
Drittens: Die Pipeline-Definition im Repo. In Azure DevOps eine azure-pipelines.yml, in GitHub ein Workflow unter .github/workflows/. Ein minimales Beispiel:
name: deploy-powerbi-prod
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Authenticate with Service Principal
run: |
az login --service-principal \
-u $SP_CLIENT_ID \
-p $SP_CLIENT_SECRET \
--tenant $TENANT_ID
- name: Deploy PBIP to PROD workspace
run: |
pwsh ./scripts/deploy-pbip.ps1 \
-WorkspaceId $PROD_WORKSPACE_ID \
-PbipPath ./PowerBI/ProjectFilesDas PowerShell-Skript nutzt das MicrosoftPowerBIMgmt-Modul und die REST-API /groups/{workspaceId}/imports. Secrets kommen ausschließlich aus dem CI/CD-Secret-Store, nie aus dem Repo. Dabei bleibt das Vieraugenprinzip bestehen, der Service Principal deployt nur, was zwei Approver im Pull Request freigegeben haben.
Workspace-Git-Integration ist nicht CI/CD#
Die Workspace-Git-Integration im Power BI Service verbindet einen einzelnen Workspace mit einem einzelnen Branch. Sie ist nicht CI/CD, sondern eine bidirektionale Sync-Funktion. Die saubere Regel: Workspace-Git-Integration nur im DEV-Workspace, nie in TEST oder PROD. In DEV ist sie hilfreich, Service-seitige Klicks erscheinen im Repo. In PROD wäre sie ein ungewollter Rückkanal.
Den Weg von DEV nach TEST und PROD übernimmt die CI/CD-Pipeline, nicht die Workspace-Git-Integration. Konzeptionell blockiert Stufe 3 nichts mehr. Grenzen entstehen an anderer Stelle: Testabdeckung für DAX-Measures ist noch Nischenthema, automatisierte Datenqualitätsprüfungen pro Deployment fehlen, Governance-Prozesse gehen über das Tool hinaus.
Entscheidungstabelle: Welche Stufe passt heute?#
| Frage | Stufe 1 | Stufe 2 | Stufe 3 |
|---|---|---|---|
| Wie viele Power-BI-Entwickler? | 1–2 | 3–8 | 5+ |
| Arbeiten mehrere parallel am selben Bericht? | Nein | Ja | Ja |
| Mehrere Workspaces im Deployment-Kreislauf? | Nein | 2 (DEV/PROD) | 3+ (DEV/TEST/PROD) |
| Regulatorische Nachweispflicht pro Änderung? | Nein | Teilweise | Ja |
| Tenant-Admin schaltet Service Principals frei? | — | — | Ja |
| Teamlernkurve verfügbar? | 0 Tage | 1–2 Wochen | +1 Woche |
Ein ehrlicher Selbsttest: Beantworten Sie zwei oder mehr Fragen in Spalte 3 mit „Nein", ist Stufe 3 heute zu früh. Konsolidieren Sie zuerst Stufe 2 für mindestens drei Monate. Danach wird der Schritt zu Stufe 3 planbar.
Typische Migrationsfehler zwischen den Stufen#
Drei Fehler sehen wir in Projekten immer wieder. Erstens: Teams springen direkt von Stufe 1 auf Stufe 3 und bauen eine Pipeline, bevor jemand einen Pull Request gereviewt hat. Das Deployment läuft, aber niemand kontrolliert, was dort deployt wird. Die Pipeline ist dann ein Liefermechanismus für ungeprüften Code. Zweitens: Branch-Protection wird ohne Status Checks gesetzt. Reviews finden statt, ein Linter oder ein pbip-Validator aber nicht; kaputte Modelle landen trotzdem auf main. Drittens: Der Service Principal bekommt Admin-Rechte im Workspace, damit „es läuft". Besser ist Member mit explizit deployten Objekt-Rechten, denn so bleibt das Blast-Radius-Prinzip erhalten.
Was das für eine Fabric-Migration bedeutet#
Wer von Power BI Pro auf Microsoft Fabric wechselt, erbt die Git-Entscheidung nicht automatisch. Fabric-Workspaces unterstützen zwar Workspace-Git-Integration für mehr Artefakte als Power BI allein (Notebooks, Data Pipelines, Lakehouses), aber die CI/CD-Pipeline bleibt Code, nicht Klick. Die Konsequenz: Teams, die in Power BI nur Stufe 1 fuhren und jetzt auf Fabric wechseln, müssen in einem Schritt zwei Baustellen bewältigen — die Plattformmigration und den Reifegradsprung auf Stufe 2 oder 3.
Für regulierte DACH-Projekte kommt eine zweite Ebene dazu. Fabric speichert Artefakte im OneLake, und Deployment über Service Principal muss mit Tenant-Residency und BaFin- oder EU-AI-Act-Vorgaben zusammenspielen. Wir empfehlen, den Migrationspfad vorab auf drei Dimensionen zu prüfen: Capacity-Sizing (F-SKU passend zur Modellgröße), Deployment-Prozess (Service Principal plus Pipeline) und Audit-Trail (TMDL-Diff plus Pipeline-Log als Nachweis). Fehlt eine dieser Dimensionen, verliert die Migration ihren Compliance-Nachweis, auch wenn technisch alles läuft.
Konkret heißt das: Beginnen Sie Stufe 2 bevor Sie Fabric einführen. Ein sauberes PBIP-Repo mit TMDL-Diffs ist die Voraussetzung dafür, dass die Fabric-Deployment-Pipeline überhaupt etwas Prüfbares deployt. Umgekehrt wird die Migration ein Risiko, das Audit und Betrieb teuer korrigieren.
Zusammenfassung#
- Power BI Git ist 2026 keine Kür mehr, sondern die Basis jeder Power-BI-Entwicklung ab drei Entwicklern.
- Die drei Reifegradstufen SharePoint, PBIP+Git und Service-Principal-CI/CD richten sich an Teamgröße, Tenant-Kontext und Regulatorik aus.
- Die Stufe zu wählen, die heute trägt, und die nächste bewusst vorzubereiten, ist der Unterschied zwischen funktionierender Adoption und einer Pipeline, die niemand pflegt.
- TMDL und TMSL nie gleichzeitig aktiv — diese eine Falle kostet Teams regelmäßig einen halben Tag.
- Stufe 3 ohne Stufe 2 scheitert an der Adoption, nicht an der Technik.
Weiterlesen bei DBI#
- BI Operations im Agentic-BI-Leitfaden — Review-Zyklen, Deployment-Fenster und Rollback-Prozesse im Betrieb.
- Power BI Dokumentation — Semantikmodell neben der Versionierung dokumentieren und für die Weiternutzung aufbereiten.
- Power-BI-Implementierung als Festpreisprojekt — Repo-Aufbau, Branch-Protection und Pipeline-Templates vom ersten PBIP bis zur produktiven Pipeline.
- Power-BI-Beratung — Begleitung bei der Wahl der Reifegradstufe und der Service-Principal-Freischaltung.
- DAX Measure Architecture — warum die Measure-Struktur im TMDL-Repo so wichtig ist wie die Pipeline selbst.
- Power BI vs. Excel-Vergleich — für Teams, die aus Excel-basiertem Reporting in strukturierte BI-Entwicklung wechseln.
Häufig gestellte Fragen#
Was ist Power BI Git überhaupt, und warum erst jetzt?#
Power BI Git bezeichnet das Versionieren von Power-BI-Berichten mit einem Git-Repository. Möglich wurde das erst mit dem PBIP-Format und der TMDL-Sprache. Vor PBIP lag jeder Bericht als binäre .pbix-Datei vor, die Git nicht diffen konnte. Seit PBIP wird der Bericht als Ordner aus Textdateien gespeichert, pro Measure und Tabelle einzeln. So funktioniert Git wie bei normalem Quellcode.
Brauche ich TMDL zwingend, oder reicht PBIP mit TMSL?#
Nein, PBIP allein funktioniert mit TMSL (eine einzelne model.bim-Datei). Das reicht für die reine Versionierung, aber der Diff im Pull Request ist dann unbrauchbar. Jede Änderung fasst die 10.000-Zeilen-JSON-Datei an. Mit TMDL sehen Sie pro Measure, pro Tabelle und pro Beziehung eine eigene Datei. So entstehen echte Code-Reviews. Für Teams ab drei Entwicklern ist TMDL praktisch Pflicht. Wichtig: entweder TMSL oder TMDL, nie beide gleichzeitig.
Wie richte ich einen Service Principal für Power BI CI/CD ein?#
Drei Schritte. Erstens: in Azure AD eine App Registration anlegen und ein Client Secret erzeugen. Zweitens: den Service Principal einer Security Group zuordnen und diese Gruppe im Power BI Admin Portal unter „Developer settings > Service principals can access the Power BI APIs" freischalten. Drittens: den Service Principal als Member mit Berechtigung im Ziel-Workspace hinterlegen. Erst dann authentifiziert die Pipeline mit dem Service Principal und deployt.
Was unterscheidet Workspace-Git-Integration von CI/CD?#
Workspace-Git-Integration ist eine bidirektionale Sync-Funktion zwischen einem Workspace und einem Branch. Änderungen im Workspace landen im Branch und umgekehrt. Sie gehört ausschließlich in den DEV-Workspace. CI/CD ist eine einseitige Automatisierung: Nach einem Merge in main wird der Bericht aus dem Repo über die Power-BI-REST-API in einen Ziel-Workspace deployed. Die beiden Mechanismen ergänzen sich, ersetzen sich aber nicht.
Was kostet eine Power-BI-CI/CD-Einführung realistisch?#
Das kommt auf die Teamgröße an. Für ein Team von fünf Entwicklern rechnen wir mit 5–10 Tagen Setup: Service Principal, Tenant-Setting-Freigabe, Pipeline-Templates und Testläufe über zwei Deployment-Zyklen. Dazu kommt Premium Capacity oder PPU für die Deployment-Pipelines im Power BI Service (ab ca. 20 €/Nutzer/Monat PPU). Die laufende Pflege liegt bei einer Stunde pro Monat für Monitoring und Secret-Rotation.
Lohnt sich Power BI Git auch für ein Ein-Personen-Team?#
Fast nie. Für einen einzelnen Entwickler reicht Stufe 1 (SharePoint-Versionierung). Git bringt wenig, weil Parallelarbeit, Code Reviews und strukturierte Merges alle entfallen. Ausnahme: Der Entwickler plant Wachstum in den nächsten Monaten, oder Audit-Anforderungen verlangen heute schon einen Change-Log pro Measure. Dann ist der frühe Einstieg in Stufe 2 die bessere Investition als der spätere Umstieg unter Zeitdruck.
Über DBI Analytics#
DBI Analytics ist Microsoft Solutions Partner für Data und AI mit Sitz in München. Wir bauen seit 2015 Enterprise-BI-Lösungen auf Microsoft Fabric, Power BI und ABIS — unserer eigenen Local-First-Middleware für Agentic BI unter EU AI Act und DSGVO. Für den Aufbau Ihres Power-BI-Git-Setups von Stufe 1 bis Stufe 3 melden Sie sich bei unseren BI-Consultants oder lesen Sie, wie wir Power-BI-Beratung im Festpreis liefern.