Zum Inhalt
← Zurück zum Blog

2026-04-02 5 Min. Lesezeit

Power BI Kompatibilitätslevel upgraden — Schritt-für-Schritt-Anleitung

Wie man Power BI dazu bringt, das Compatibility Level eines Semantic Models auf den neuesten Stand zu heben — und warum das für eine vollständige Dokumentation des Modells wichtig ist.

published on 2026-04-02


Wer mit Power BI arbeitet, stößt früher oder später auf den Begriff Compatibility Level (Kompatibilitätslevel). Jedes Semantic Model hat einen solchen Level, der festlegt, welche DAX-Funktionen und Features verfügbar sind. Neue Power BI Releases bringen neue Funktionen — aber das Modell nutzt diese erst, wenn sein Compatibility Level angehoben wird.

In diesem Artikel zeige ich, warum ein aktuelles Kompatibilitätslevel wichtig ist, wie man es gezielt aktualisiert und was es für die Dokumentation eines Modells bedeutet.


Was ist das Compatibility Level?

Das Compatibility Level (CL) ist eine Versionsnummer des Analysis Services Tabellenmodells, das hinter jedem Power BI Semantic Model steht. Es bestimmt, welche Engine-Features und DAX-Funktionen verwendet werden können.

flowchart LR
    A["Power BI Desktop Version"] -->|bestimmt max. verfügbares| B["Compatibility Level"]
    B -->|schaltet frei| C["Neue DAX-Funktionen"]
    C --> D["z.B. INFO.USERDEFINEDFUNCTIONS()"]

Ein Modell, das vor einem Jahr erstellt wurde, kann auf einem älteren CL stehen, selbst wenn es mit einer aktuellen Power BI Desktop Version geöffnet wird. Power BI hebt das CL nicht automatisch an — es sei denn, man verwendet ein Feature, das eine neuere Version erfordert.


Warum ist das relevant?

Für die tägliche Arbeit

Auf einem älteren CL stehen bestimmte neue DAX-Funktionen nicht zur Verfügung. Wer beispielsweise INFO.USERDEFINEDFUNCTIONS() verwenden möchte — die aktuell neueste INFO-Funktion (Stand März 2026) — benötigt CL ≥ 1700.

Für die Dokumentation des Modells

Wer ein Semantic Model dokumentiert, liest seine Metadaten heute meist über die INFO-Funktionen aus. Welche davon das Modell beherrscht, hängt am Compatibility Level:

Compatibility Level Was sich auslesen lässt
CL ≥ 1200 Alle INFO-Funktionen außer INFO.USERDEFINEDFUNCTIONS. UDFs sind nur über INFO.CALCDEPENDENCY sichtbar — und zwar nur die, auf die ein Measure oder eine Spalte verweist, mit eingeschränkten Metadaten.
CL ≥ 1700 Alle INFO-Funktionen inkl. INFO.USERDEFINEDFUNCTIONS. Vollständige UDF-Metadaten, auch für Funktionen, die (noch) nirgends verwendet werden.

Für Modelle mit User Defined Functions (UDFs) lohnt sich das Upgrade also doppelt: Erst ab CL 1700 ist die Dokumentation der Funktionen vollständig. Wer INFO.USERDEFINEDFUNCTIONS() ausführt und eine Fehlermeldung erhält, hat in der Regel ein Modell, dessen Compatibility Level noch nicht hoch genug ist.


So funktioniert das CL-Upgrade

Die Kernidee ist einfach: Man muss ein Feature verwenden, das vom aktuellen Modell-CL noch nicht unterstützt wird. Power BI erkennt das und hebt den Compatibility Level automatisch an.

Aktuell (März 2026) ist das neueste Feature, das ein CL-Upgrade auf 1700 auslöst, die Funktion INFO.USERDEFINEDFUNCTIONS(). Diese Funktion setzt voraus, dass das Modell User Defined Functions (UDFs) unterstützt. Der einfachste Weg, das zu erzwingen: eine temporäre UDF anlegen.

flowchart LR
    A["Temporäre UDF anlegen"] --> B["Power BI erkennt
neues Feature"] B --> C["CL wird automatisch
auf ≥ 1700 angehoben"] C --> D["Modell speichern"] D --> E["UDF wieder löschen
(optional)"]

Schritt-für-Schritt-Anleitung

Voraussetzungen

  • Power BI Desktop März 2026 oder neuer (ältere Versionen unterstützen das benötigte CL nicht)
  • Alternativ das bereits veröffentlichte Modell im Power BI Service editierend öffnen (wenn aufgrund von Organisationsrichtlinien die aktuellste Power BI Desktop Version nicht automatisch zur Verfügung steht)

Schritt 1: DAX Query View öffnen

In Power BI Desktop auf den Reiter DAX Query View wechseln (unten links in der Ansichts-Leiste oder über Ansicht → DAX Query View).

Schritt 2: Temporäre UDF anlegen

Folgenden DAX-Code in den Query-Editor einfügen und ausführen:

DEFINE
    -- Temporäre Funktion, um das CL-Upgrade auszulösen.
    -- Kann anschließend wieder gelöscht werden.
    FUNCTION TempUDF = (a, b) => a + b

EVALUATE ROW("result", TempUDF(1, 2))

Was passiert hier? Wir definieren eine einfache Funktion TempUDF, die zwei Zahlen addiert. Das allein reicht aus — Power BI erkennt, dass das aktuelle CL UDFs nicht unterstützt, und hebt es automatisch auf CL 1700 an. Das Ergebnis der Query (der Wert 3) ist dabei nebensächlich.

Wenn die Ausführung erfolgreich ist (Ergebnis: 3), wurde das CL bereits angehoben.

Schritt 3: Modell speichern

Die .pbix-Datei speichern (Strg+S). Damit wird das neue Compatibility Level dauerhaft übernommen.

Schritt 4: Temporäre UDF löschen (optional)

Die temporäre Funktion wird nur für die Query-Ausführung benötigt. Wenn sie beim Speichern als Teil des Modells angelegt wurde, kann sie über den Modell-Tab entfernt werden:

  1. In der Modellansicht im Tab Functions nachsehen
  2. Falls TempUDF dort auftaucht: Rechtsklick → Löschen
  3. Erneut speichern

Hinweis: Die Funktion aus dem DEFINE-Block wird in vielen Fällen gar nicht im Modell gespeichert, da sie als Query-scoped definiert ist. Es schadet aber nicht, das zu prüfen.

Schritt 5: Überprüfen

Um sicherzustellen, dass das Upgrade erfolgreich war, folgenden DAX-Query ausführen:

EVALUATE INFO.USERDEFINEDFUNCTIONS()

Wenn dieser Befehl ohne Fehler durchläuft (und eine leere oder gefüllte Tabelle zurückgibt), ist das CL-Upgrade abgeschlossen.


Zusammenfassung: Ablauf im Überblick

flowchart TD
    A["Power BI Desktop
März 2026+ öffnen"] --> B["Semantic Model
(.pbix) öffnen"] B --> C["DAX Query View
aufrufen"] C --> D["Temporäre UDF ausführen:
FUNCTION TempUDF = (a, b) => a + b"] D --> E["Modell speichern
(Strg+S)"] E --> F["Optional: TempUDF
im Modell löschen"] F --> G["Prüfung:
INFO.USERDEFINEDFUNCTIONS()
ausführen"] G --> H["✓ CL ≥ 1700 — vollständige
UDF-Metadaten verfügbar"]

Häufige Fragen

Kann das CL-Upgrade etwas am Modell kaputt machen?

Nein. Das Anheben des Compatibility Levels ist vorwärtskompatibel. Bestehende DAX-Ausdrücke, Beziehungen und Measures bleiben unverändert. Es werden lediglich neue Funktionen zusätzlich verfügbar gemacht.

Muss ich die temporäre UDF behalten?

Nein. Die UDF dient nur als Auslöser für das Upgrade. Sobald das Modell gespeichert ist, kann sie gelöscht werden, ohne dass der Compatibility Level zurückgesetzt wird.

Was passiert, wenn ich eine ältere Power BI Desktop Version verwende?

Versionen vor März 2026 unterstützen CL 1700 nicht. In diesem Fall wird die Query mit einem Fehler abgebrochen. Lösung: Power BI Desktop aktualisieren oder direkt im Power BI Service das Modell editieren (siehe oben).

Funktioniert das auch im Power BI Service / Fabric?

Ja. Wer das Semantic Model direkt im Power BI Service editiert (über die Web-Oberfläche mit DAX Query View), kann die temporäre UDF dort genauso ausführen — das CL-Upgrade wird dann direkt im Service durchgeführt. Das ist besonders praktisch, wenn aufgrund von Organisationsrichtlinien nicht die aktuellste Power BI Desktop Version zur Verfügung steht.


Tags: Power BI, Compatibility Level, DAX, User Defined Functions, UDF, Dokumentation, Power BI Desktop, INFO.USERDEFINEDFUNCTIONS