Skip to content
Vol. I · No. 251
Mon · 8 Jun
A Daily Lexicon of Trustworthy Data
No. 247
247·01 · Dashboard TheaterNo. 247 · 27 May 2026 · 2 min

The semantic layer is back to settle what a metric means. The metric is surprised anyone asked.

A define-once layer is an admission that the term was never defined.

PromotedThe EditorDashboard Confessional

The semantic layer arrives dressed as architecture, but it is really an apology. Before a tool can return one number for revenue, someone has to admit the company has been returning several, and that nobody could say which one was wrong.

What happened: the metric layer is again the center of the stack. dbt positions its Semantic Layer to define metrics from a single governed source, so every report reads the same definition. Cube centralizes metric definitions upstream of every consumption tool. Malloy, from a Looker founder, frames the model as what defines a customer and how revenue is calculated. Three projects, one premise.

Why it matters: the premise is correct and slightly damning. Moving the definition into version control and tests is real discipline. But it is necessary because the definition previously lived nowhere and everywhere at once: a dashboard filter, a hand-edited query, a finance spreadsheet, a slide. The layer does not create agreement. It creates a location where the disagreement finally has to be resolved in writing.

What it reveals: a semantic layer is a governance decision in an engineering costume. The hard work is not the YAML; it is the meeting where two teams learn they count active users on different calendars and one has to lose. The tooling makes that meeting unavoidable, which is why organizations both buy it and quietly avoid configuring it.

What to watch: whether the definitions land with an owner and a review cadence, or whether the company ships the layer empty and declares the problem solved. A practitioner building one with MetricFlow put the appeal plainly: change a metric once and it updates everywhere. The trap is shipping a single source of truth no one was assigned to keep true.

The takeaway

A single source of truth is not a product you install. It is a definition someone agreed to own. The dashboard was green because nobody had agreed what red meant.

The claim, mapped
  1. dbt's Semantic Layer is positioned as defining metrics from a single governed source so downstream tools share one definition.

    supports0102
  2. Cube centralizes metric definitions and business logic upstream of the tools that consume them.

    supports03
  3. Malloy models the definition of business entities and measures, such as what a customer is and how revenue is calculated.

    supports04
  4. The stated payoff of a semantic layer is defining a metric once so every tool stays consistent.

    supports0205
  5. A metric layer cannot resolve a disagreement that the organization has never assigned anyone to resolve.

    context05
Sources
01
dbt Labs — dbt Developer Hub — dbt Semantic Layer2026-05-01 · Tier 4 · vendorParaphrase: centralizing metric definitions lets data teams give consistent self-service access to those metrics across downstream tools and applications.
02
dbt Labs — Unify metrics and accelerate analytics with dbt Semantic Layer2026-05-01 · Tier 4 · vendorParaphrase: defines metrics and logic from a single governed source so teams work from the same definitions across every report and application.
03
Cube — Introduction — Cube documentation2026-05-01 · Tier 4 · vendorParaphrase: Cube centralizes metric definitions, entity relationships, and business logic upstream of every consumption tool.
04
Malloy (malloydata.dev) — Building a Semantic Model — Malloy Documentation2025-01-01 · Tier 4 · vendorParaphrase: a semantic model is the interface to the data, defining what a customer is, how revenue is calculated, and how tables relate.
05
Alwyn DSouza, Towards Data Engineering (Medium) — Metrics as Code: Building a Semantic Layer With dbt and MetricFlow2025-06-01 · Tier 3 · practitionerParaphrase: change a metric definition once and it updates everywhere, ending parallel maintenance of the same metric across separate tools.
Mark this entry
Marginalia · 0 notes

No notes yet. The margin is open.

Sign in to add a note. The margin is moderated — we keep it useful, not cruel.

Related entries
Owner Missing
Moving Revenue Into A YAML File Does Not Give It An Owner

dbt open-sourced MetricFlow so agents query one definition. Whichever definition wins by default is now the one the robots inherit.

Definition Drift
It Took 31 Vendors To Agree On What Revenue Means

An industry consortium standardized the file format for metric definitions. The meeting where Finance and Sales disagree is still on your calendar.

Definition Drift
The Schema History Topic Remembers What Nobody Wrote Down

Debezium 3.0 ships a connector that refuses to guess. The org still guesses.