Semantischer Gold-Vertrag: Kannst du wählen, welche Spalten das Modell für Direct Lake erreichen?

Eine Gold-Tabelle, die in Spark sauber aussieht, kann als Plattform-Asset trotzdem scheitern. Optionale Verknüpfungen zu einer Dimensionstabelle verwerfen Zeilen ohne Treffer. Freitextfelder verstecken Geschäftsschlüssel hinter Regex aus Stammeswissen. Beschriftungen und Ordner gelten als Feinschliff. Stakeholder öffnen einen Bericht, und ein Teil der Daten fehlt, ohne dass ein Fehler erscheint.

Gold wird nützlich, wenn Schlüssel ohne Treffer, Beschriftungen und Beziehungen als ein semantischer Vertrag mit der Tabelle ausgeliefert werden. "Jede Quellzeile ist sichtbar, egal ob sie einen Treffer hat" ist ein Abnahmetest, kein Slogan.

Abbildung 1. Gold als semantischer Vertrag. Kuratiertes Delta ist notwendig. Unbekannte Mitglieder, Brücken, Beziehungen und für Menschen lesbare Namen machen daraus ein Plattform-Asset.

Kontext und Rahmenbedingung

Ein häufiger Fehler: Die Zeilenzahlen im Lakehouse stimmen, und Berichtsseiten sehen für ganze Ausschnitte der Daten trotzdem leer aus. Der Fakt existiert. Der Vertrag für Mitglieder ohne Treffer und das Verhalten der Beziehungen existiert nicht.

Eine optionale Verknüpfung zu einer Dimensionstabelle muss Unbekannte sichtbar machen, nicht still herausfiltern. Aus Freitext geparste Geschäftsschlüssel sind Modellierungsentscheidungen mit Tests. Kulturabhängige Beschriftungen und Abfrageordner sind Infrastruktur für die Benutzbarkeit. Behandle sie als Teil desselben Releases wie den Gold-Schreibvorgang.

Abbildung 2 zeigt die Learn-Seite zu Modellbeziehungen. Schlüssel und das Verhalten der Beziehungen sind der Vertrag, dem das Modell für Direct Lake vertrauen kann, kein Feinschliff für später.

Abbildung 2. Gold wird erst dann zum Plattform-Asset, wenn sich Schlüssel und Beziehungen wie ein semantischer Vertrag verhalten, dem das Modell vertrauen kann. Quelle: Microsoft Learn: understand relationships.

Abbildung 3 zeigt, warum ein gesunder SQL endpoint keine Abnahme ist. Zeilenzahlen können gut aussehen, während Berichte Schlüssel ohne Treffer verstecken.

Abbildung 3. Zeilenzahlen auf dem SQL endpoint können gesund aussehen, während Berichte Schlüssel ohne Treffer verstecken. Teste den Vertrag, nicht nur den Erfolg in Spark. Quelle: Microsoft Learn: lakehouse SQL analytics endpoint.

Design

1. Unbekannte Mitglieder schlagen stilles Verwerfen

Left Joins, die Nicht-Treffer wegfiltern, lassen Dashboards maßgeblich und zugleich unvollständig aussehen. Behalte jede Quellzeile. Hänge unbekannte Mitglieder oder Mitglieder ohne Treffer an die Dimensions- und Brückentabellen, damit die Summen mit der Quellzahl übereinstimmen, an die die Leute glauben. Dokumentiere, was "unbekannt" bedeutet, damit niemand es in einem späteren PR wegräumt. Abbildung 4 zeigt die Gabelung zwischen stillem Verwerfen und vollwertigen Unbekannten.

Abbildung 4. Unbekannte Mitglieder schlagen stilles Verwerfen. "Nur Treffer" ist ein expliziter Berichtsfilter, nicht die Standardgranularität von Gold.

2. Geparste Geschäftsschlüssel sind eine Modellierungsentscheidung

Wenn Geschäftskennungen in Freitextfeldern stehen, gehören die Parse-Regeln mit Fixtures nach Gold, nicht in das DAX eines Berichtsautors oder in eine einmalige Notebook-Zelle. Versioniere die Regeln. Wenn sich das Textformat in der Quelle ändert, willst du eine Stelle zum Reparieren und erneuten Testen, nicht fünf Visuals, die jeweils anders geraten haben.

3. Granularität, Brückenschlüssel und TMDL-Beziehungen werden gemeinsam ausgeliefert

Veröffentliche die Aussage zur Granularität (eine Zeile pro Schlüssel pro was?), die Brückenschlüssel zu den Dimensionstabellen und die TMDL- oder Modellbeziehungen im selben Change Set. Eine Gold-Tabelle ohne aktualisierte Beziehungen ist eine Landmine für die nächste semantische Aktualisierung. Rollenspiel-Dimensionen brauchen passende Schlüsseltypen, sonst bekommst du leere Visuals, die wie DAX-Bugs aussehen. Abbildung 5 zeigt diese Übergabe in einem einzigen Change Set.

Abbildung 5. Granularität, Brücken und Beschriftungen werden gemeinsam ausgeliefert. Wenn eine Antwort "später" lautet, ist der PR nur eine abgeladene Tabelle, kein Plattform-Asset.

4. Beschriftungen und Abfrageordner gehören zur Übergabe

Feldnamen, die für Engineers Sinn ergeben, scheitern in der Feldliste von Analysten. Kulturabhängige Beschriftungen, Beschreibungen und Ordnergruppierungen verringern Supportanfragen wie "Wo ist der Schlüssel?". Das ist keine Dekoration. So wird der semantische Vertrag genutzt.

5. Abnahme durch Stakeholder: Jede Zeile ist sichtbar, egal ob sie einen Treffer hat

Schreib den Test: Die Zahl der Quellzeilen in Gold entspricht der Zahl, die im Modell über den Standardpfad erreichbar ist, einschließlich der Zeilen ohne Treffer. Prüfe bekannte Waisen stichprobenartig. Wenn den Product Ownern wichtig ist, dass jede Zeile erscheint, automatisiere diese Prüfung, bevor ihr über Farben im Dashboard streitet.

6. Halte die Anreicherungslogik gemeinsam

Wenn Faktentabelle A und Faktentabelle B beide Schlüssel gegen dieselbe Dimensionstabelle auflösen, teile das Matching-Modul. Abweichende Matching-Logik erzeugt zwei Wahrheiten, die beide den Gold-Status beanspruchen.

Unbekannte Mitglieder in der Praxis

Rechne mit Widerstand, wenn unbekannte Mitglieder zum ersten Mal in einem Slicer auftauchen. Dieser Widerstand ist nützlich. Er erzwingt ein Gespräch über Datenqualität gegenüber stillem Ausschluss. Bring den Leuten Filter auf "nur Treffer" als bewusste Berichtsentscheidung bei, nicht als Standardgranularität von Gold. Gold sagt die Wahrheit über die Abdeckung. Berichte dürfen eingrenzen. Sie dürfen nicht so tun, als hätte der Lake die Waisen nie gesehen.

Wie ich einen Gold-PR reviewe

Vor dem Merge stelle ich vier Fragen. Übersteht jede Quellzeile die optionale Verknüpfung zur Dimension? Sind die Parse-Regeln für Geschäftsschlüssel durch Fixtures abgedeckt? Passen TMDL-Beziehungen und Schlüsseltypen im selben Change Set zur Granularität von Gold? Gibt es Beschriftungen und Ordner für die Felder, nach denen Analysten zuerst suchen? Wenn eine Antwort "später" lautet, ist der PR nur eine abgeladene Tabelle, kein Plattform-Asset. "Später" kommt selten vor dem ersten Ticket wegen eines leeren Visuals.

Häufige Fehler

Die Bequemlichkeit des Inner Join. Zeilen ohne Treffer verschwinden. Die Führung hält die Abdeckung für vollständig.

Regex als Hobby. Jedes Notebook erfindet ein leicht anderes Parsing der Schlüssel.

Gold gemergt, Modellbeziehungen veraltet. Die Aktualisierung läuft durch. Die Visuals sind leer.

Nur englische technische Namen in der Feldliste. Die Akzeptanz stirbt leise.

Berichts-Screenshots als Beweis akzeptieren. Screenshots verstecken fehlende Mitglieder.

Unterschiedliche Matching-Regeln pro Fakt. Die Zeilenzahlen unterscheiden sich von Seite zu Seite.

So übernehmen oder anpassen

So übernehmen

• Gold behält Zeilen ohne Treffer; unbekannte Mitglieder sind vollwertig.
• Parse-Regeln für Geschäftsschlüssel leben in Gold und haben Fixture-Tests.
• Granularität, Brückenschlüssel und semantische Beziehungen werden gemeinsam released.
• Beschriftungen, Beschreibungen und Abfrageordner sind Pflicht für das Publish.
• Die Abnahme verlangt, dass jede Quellzeile sichtbar ist, egal ob sie in der Dimension einen Treffer hat.
• Die Matching-Logik wird über alle Faktentabellen hinweg geteilt.

Vor dem Einsatz anpassen

Unbekannte Mitglieder blähen manche Visuals auf, bis die Filter erklärt sind. Diese Erklärung ist billiger als eine stille Unterzählung. Explizite Parse-Regeln bedeuten Change Management, wenn sich der Quelltext ändert; versteckte Parse-Regeln bedeuten stille Abweichung. Beschriftungen und TMDL mit Gold auszuliefern, verlangsamt den Daten-PR ein wenig und erspart eine Woche semantisches Hin und Her. Gemeinsame Anreicherungsmodule erfordern Paketdisziplin über Notebooks hinweg. Das lohnt sich, wenn zwei Fakten übereinstimmen müssen.

Wichtigste Quellen: Microsoft Learn zu semantic models in Fabric, understand relationships und die TMDL-Workflows, die dein Team schon für Model-as-Code nutzt.

Wenn du einen Pull Request reviewst, der nur eine Gold-Tabelle hinzufügt, frag nach dem semantischen Gegenstück: Verhalten unbekannter Mitglieder, Diff der Beziehungen und Abdeckung der Beschriftungen. Wenn das Folgeaufgaben sind, ist die Tabelle noch kein Plattform-Asset. Sie ist eine Kopie der Quelle, die auf einen künftigen Incident wartet.

Wenn Zeilen ohne Treffer verschwinden, Schlüssel Stammeswissen sind und Beschriftungen "später" kommen, hast du eine Tabelle ausgeliefert. Liefere den Vertrag aus: Unbekannte, Brücken, Beziehungen und für Menschen lesbare Namen im selben Atemzug wie Gold.

Verwandte Notizen

• MLV + SCD2: Ist SCD2 in Bronze das richtige Muster vor Silver MLVs? (Attributhistorie und As-of-Beziehungen als eine Spezifikation)
• Fakten neu modellieren: gemeinsame Dimensionen oder getrennte Fakten für sauberere Modelle? (Brückenschlüssel vor Many-to-many-Berichten)