Data Architecture · Databricks Architecture
Medallion Architecture: When Bronze, Silver, and Gold Make Sense
Medallion is a quality contract between layers. It is not a mandatory folder taxonomy, and it is not automatically correct because the names are famous.
8 min · Independent technical note
Databricks defines medallion architecture as a multi-layered approach to a single source of truth. Bronze holds raw, source-fidelity data. Silver is validated, cleaned, and typically the first non-aggregated trustworthy representation. Gold is enriched and often aggregated for analytics, ML, and applications. Databricks calls this a recommended best practice, not a requirement.
When the pattern earns its place
- Multiple sources must be reprocessable from raw.
- Analysts and jobs should not each clean the same feed differently.
- Consumption needs a stable grain and performance-optimized tables.
- You need a clear place for quality tests and quarantine.
When it is being misused
- Three schemas exist, but bronze is already “cleaned” and gold is a copy of silver.
- Every domain duplicates the same conformed dimensions with no owner.
- Streaming and batch each have their own unofficial medallion.
- Nobody can name the consumer of a gold table.
Layer responsibilities, briefly
Bronze: append-only landing, minimal validation, preserve unexpected schema. Silver: schema enforcement, deduplication, late data, joins that create a usable entity. Gold: business-aligned models, aggregations, query optimization. Databricks also notes you may have more than one gold surface (finance vs. operations) because domains differ.
If a dataset is a small static dimension, a full three-hop path may be ceremony. If a feed is the backbone of revenue reporting and ML features, skipping silver is how you debug production with raw JSON.
Name layers after contracts, then keep the bronze/silver/gold vocabulary if it helps the organization. The words are optional. The contracts are not.
Technical statements in this article follow Databricks public documentation on lakehouse architecture, Unity Catalog, and platform capabilities. Product names belong to Databricks, Inc.
Continue
Data Engineering
Lakeflow Architecture for Modern Data Engineering
Lakeflow is the engineering surface for ingestion, transformation, streaming, and orchestration. It still needs contracts, quality, and owners.
10 min
Databricks Architecture
Databricks Architecture Best Practices for Enterprise Teams
A lakehouse becomes an operating layer only when environments, catalogs, workloads, and consumption are designed as one system—not as a growing pile of workspaces.
12 min
Start with the business case
Find the first data or AI opportunity worth proving.
We evaluate the business problem, systems, data, architecture, and economics behind it—then identify the smallest production engagement capable of proving whether the opportunity is real.
Business case first · Architecture-led · Production-focused