Reference Architectures
The blueprints an architect draws on the whiteboard - batch, streaming, ML, GenAI, and the Azure wiring underneath.
The core lakehouse, drawn as five planes
When an RSA is asked "draw us your reference architecture," the strongest answer is not a product list - it is a small number of planes with clear responsibilities, and then products mapped onto them. Practice this exact talk track: draw three boxes left to right (ingestion, storage and processing, serving), then draw two horizontal bands across all three (governance, operations). Every Databricks Data Intelligence Platform engagement is a variation of this picture.
OPERATIONS | CI/CD (Declarative Automation Bundles, Azure DevOps),
| Lakeflow Jobs orchestration, monitoring, cost / FinOps
------------+--------------------------------------------------------------
GOVERNANCE | Unity Catalog: catalogs, grants, lineage, audit,
| row/column security, metric views, Delta Sharing policies
------------+--------------------------------------------------------------
INGESTION STORAGE + PROCESSING SERVING
+-----------------+ +------------------------+ +--------------------+
| Lakeflow Connect| | Delta Lake on ADLS Gen2| | DBSQL warehouses |
| (SaaS + DB | ---> | Bronze -> Silver -> | --> | AI/BI dashboards |
| connectors, | | Gold (medallion) | | + Genie, Power BI |
| Zerobus Ingest)| | Lakeflow Jobs + Spark | | Mosaic AI Model |
| ADF, Auto Loader| | Declarative Pipelines | | Serving (APIs) |
| partner tools | | serverless or classic | | Delta Sharing |
+-----------------+ +------------------------+ +--------------------+
The plane-by-plane talk track:
- Ingestion. Pick by source type, not by habit. Lakeflow Connect for managed SaaS and database connectors (Salesforce, Workday, SQL Server are GA; ServiceNow, SharePoint, PostgreSQL and more behind them), with Zerobus Ingest for direct high-throughput event writes. ADF when the customer is an Azure shop with existing self-hosted integration runtimes reaching on-prem ERPs. Auto Loader for incremental cloud-file arrival. Partner tools (Fivetran, Qlik Replicate) when CDC licensing already exists. The architect's job is to rationalize this list, not to maximize it.
- Storage and processing. Delta Lake on ADLS Gen2, organized as medallion (Bronze raw and replayable, Silver conformed, Gold consumption-shaped). Transformation runs as Lakeflow Jobs orchestrating notebooks/Spark, or as Lakeflow Spark Declarative Pipelines (the renamed DLT) where you want managed dependencies, expectations, and streaming tables. For new tables, recommend liquid clustering - ideally
CLUSTER BY AUTO- rather than partitioning plus Z-ORDER, which is legacy guidance. - Serving. DBSQL warehouses feeding AI/BI dashboards and Power BI; Mosaic AI Model Serving for low-latency APIs; Delta Sharing for cross-org distribution without copies; Lakebase Postgres (Azure public preview as of mid-2026) where an application needs true OLTP next to the lakehouse.
- Governance. Unity Catalog spans every plane: one metastore per region, three-level namespace, lineage from ingestion through dashboards, row/column security, audit. Drawing UC as a band - not a box - is the visual cue that you understand it.
- Operations. CI/CD with Declarative Automation Bundles (renamed from Databricks Asset Bundles in March 2026; the CLI is still
databricks bundle), job monitoring, system tables for cost, runbooks and hypercare.
Azure deployment anatomy - your depth area
On Azure, Databricks is a first-party service, and the deployment conversation is where you should be strongest. Know this layer cold:
- Workspace anatomy. The control plane (web app, job scheduler, UC, metadata) runs in the Databricks-managed Azure subscription; the compute plane runs in the customer subscription. A classic workspace creates a locked managed resource group holding the managed storage account (DBFS root and workspace system data) and, with VNet injection, nothing network-shaped you did not bring. Serverless compute runs in Databricks-managed infrastructure with its own network controls (Network Connectivity Configurations for egress).
- VNet injection. Deploy the compute plane into a customer-managed VNet with two delegated subnets (host/public and container/private), customer NSGs, and secure cluster connectivity (no public IPs on cluster nodes). This is what lets cluster traffic ride the customer's routing - Azure Firewall egress via UDRs, on-prem reachability, service endpoints.
- Private Link. Two distinct legs: front-end (users and tools to the workspace web app/APIs) and back-end (compute plane to the control plane relay and APIs). A hardened pattern uses both, plus private endpoints on ADLS Gen2 and Key Vault, and a browser-auth private endpoint for SSO callback. Be ready to draw the DNS story - private DNS zones are where these designs actually fail.
- Storage and identity. ADLS Gen2 with hierarchical namespace is the data lake. Unity Catalog reaches it through the Azure Databricks access connector - a managed identity granted Storage Blob Data Contributor - registered in UC as a storage credential, with external locations layered on top. This replaces service principals with secrets and the old credential-passthrough pattern: no secrets to rotate, grants live in UC.
- Key Vault. Key Vault-backed secret scopes for the credentials that remain (JDBC users, API keys); customer-managed keys for managed services and storage where compliance demands it.
- ExpressRoute and landing zones. ERP extraction from on-prem rides ExpressRoute through a hub-spoke landing zone: Databricks VNet as a spoke, firewall in the hub, UDRs forcing egress through inspection. Align the workspace with the customer's Azure landing-zone standard (policy, naming, budgets) rather than fighting it - that single sentence buys enormous credibility with platform teams.
Workspace topology and Unity Catalog as the cross-workspace layer
Customers always ask "how many workspaces?" The honest answer: workspaces are an isolation and blast-radius boundary; Unity Catalog is the sharing boundary. Because the UC metastore is account-level and regional, data, lineage, and grants span workspaces - so you can keep workspaces small without fragmenting governance.
| Topology | Best for | Strengths | Watch out for |
|---|---|---|---|
| Workspace per environment (dev/test/prod) | Single team or single domain platforms | Simple promotion story; clean separation of duties; easy cost attribution per stage | Everything shares one prod workspace - noisy-neighbor risk grows with adoption |
| Workspace per domain (e.g., finance, supply chain) x environment | Data-mesh-leaning enterprises | Domain autonomy; blast radius and admin scope per domain; UC still gives cross-domain sharing | Workspace sprawl; needs automation (Terraform/Bundles) and a platform team to stay consistent |
| Workspace per business unit | Conglomerates with hard chargeback or regulatory walls | Strong cost and compliance separation | Duplicated platform effort; cross-BU collaboration leans entirely on UC and Delta Sharing |
Whichever topology you pick, bind catalogs deliberately: workspace-catalog binding so prod catalogs are only visible from prod workspaces, with a finance_dev / finance_test / finance_prod catalog convention carrying identical schemas through promotion.
Batch analytics reference architecture (the one you have lived)
The bread-and-butter pattern: ERP and operational sources feeding a medallion lakehouse feeding executive BI. Model the whiteboard on the finance Record-to-Report shape:
JDE SAP HFM (Hyperion) IBM DB2 IBM APGO Web Wire
| | | | |
+-----+--------+-------+-------+------------+
| ADF copy activities: CDC / delta extracts,
| watermarks, metadata-driven control tables
v
ADLS Gen2 landing zone (raw files)
|
v
BRONZE raw, append-only Delta, audit + load-date columns
| PySpark: dedupe, conform keys, SCD2 history
v
SILVER conformed finance entities: GL, ledgers, cost centers, hierarchies
| KPI logic: P&L, Budget vs Actual, expense forecast
v
GOLD star schemas + aggregates, liquid-clustered on query keys
|
v
Semantic layer: Power BI model (or UC metric views / Dremio-Denodo)
|
v
CFO / Executive Committee dashboards
Orchestration: ADF pipelines + Lakeflow Jobs, sequenced end to end by
Redwood RunMyJobs, which also triggers the Power BI dataset refresh.
Customer questions you will get: "Why Bronze at all - why not load straight to reporting tables?" (replay, audit, decoupling source quirks from business logic). "How fresh is this?" (batch SLA driven by ERP close cycles; show where you would swap ADF triggers for streaming tables if the SLA tightens). "Where does the semantic layer live - Power BI, Dremio/Denodo, or UC metric views?" (have a fit-gap answer: Power BI models for a Microsoft-standard estate, a virtualization layer when many BI tools must share logic, UC metric views - GA as of 2026 - when you want metrics governed next to the data).
Streaming reference architecture
Same planes, faster heartbeat. Be transparent that your production delivery has been batch and near-real-time via orchestration - streaming-native Databricks (Auto Loader, streaming tables in Spark Declarative Pipelines) is study and lab depth for you, so frame it as pattern fluency, not war stories.
Devices / apps / ERP events
| |
v v
Azure Event Hubs Files dropped to ADLS Gen2
(Kafka-compatible) |
| v
| Auto Loader (incremental file discovery)
+-----------+-----------+
v
Streaming tables (Lakeflow Spark Declarative Pipelines)
Bronze stream -> Silver (expectations, dedupe, watermark joins)
|
v
Near-real-time GOLD (materialized views / aggregates)
|
+-----------+------------+
v v
AI/BI dashboards Alerts (DBSQL alerts, webhooks)
on a DBSQL warehouse and downstream APIs
Key talking points: Auto Loader for files versus Event Hubs/Kafka for true event streams (and Zerobus Ingest when producers can write directly to the lakehouse); exactly-once via checkpoints and idempotent sinks; availableNow triggers to run streaming logic on a batch schedule - the cheapest way to keep one codebase while SLAs evolve.
Customer questions you will get: "Do we really need streaming?" (push back with the cost-of-latency question; most finance use cases are happy at 15-minute micro-batch). "What does this cost versus batch?" (continuous clusters versus triggered serverless pipelines). "How do late events affect our numbers?" (watermarks, and a reconciliation job in the operations plane).
ML reference architecture
Silver/Gold Delta tables
|
v
Feature pipelines (Lakeflow Jobs) -> UC feature tables
|
v
Training (MLflow 3: experiments, model registry in UC)
|
v
Mosaic AI Model Serving (real-time endpoint or batch scoring)
|
v
Inference tables -> Lakehouse Monitoring (drift, quality)
|
+--> alerts -> retraining job (closing the loop)
The architect's framing: ML is the same lakehouse with two extra loops - a feature loop (features computed once, governed in UC, reused online and offline) and a feedback loop (inference tables monitored for drift, triggering retraining). Models registered in Unity Catalog get the same lineage and access control as tables, which is the governance answer customers want to hear.
Customer questions you will get: "How do we stop training/serving skew?" (one feature definition, served from the feature store, not re-implemented in the app). "Who approves a model for prod?" (UC model aliases plus CI gates in the promotion pipeline). "Real-time or batch scoring?" (decide on consumer latency, not fashion - batch scoring into a Gold table covers most BI-adjacent use cases).
GenAI / RAG reference architecture - pointer
The GenAI blueprint (Mosaic AI Vector Search, LLM endpoints behind a gateway, AI/BI Genie for SQL-grounded answers, agent evaluation with MLflow 3, Databricks Apps for the UI) gets its own module - see GenAI on Databricks. Architecturally it is the serving plane extended with retrieval and generation, governed by the same UC band; you have shipped this pattern in production at ADM, so module 04 is where that story lives.
Cross-cutting: DR, security perimeter, environment promotion
HA / DR basics
Start the DR conversation with two numbers, not products: RTO (how long can you be down) and RPO (how much data can you lose). Then map tiers:
| Tier | Pattern | Approx. RTO/RPO posture | Cost profile |
|---|---|---|---|
| Backup and restore | GRS/RA-GRS storage replication; Deep Clone snapshots of critical Delta tables to a paired-region storage account; IaC to rebuild the workspace | Hours-to-day RTO; RPO = clone/replication cadence | Low |
| Pilot light | Secondary workspace pre-provisioned in the Azure paired region; UC objects and jobs deployed there via the same Bundles; data synced by scheduled Deep Clone or Delta Sharing | RTO in hours; RPO = sync cadence | Medium |
| Warm/active standby | Both regions continuously loaded (dual ingestion or near-continuous replication); traffic switch is a DNS/orchestration change | RTO in minutes; near-zero RPO | High - usually only for serving-critical workloads |
Two nuances that separate you from a slide-reader: the UC metastore is regional, so the DR region needs its own metastore with grants and objects recreated by code - which is itself an argument for everything-as-code; and Delta Sharing can act as a low-friction replication channel for the handful of Gold tables that genuinely carry the business, instead of replicating the whole lake.
Security perimeter checklist
- VNet injection plus secure cluster connectivity (no public IPs); back-end and front-end Private Link.
- Private endpoints and disabled public network access on ADLS Gen2 and Key Vault; UDR egress through the hub firewall.
- All storage access via UC storage credentials on the access connector's managed identity - no account keys, no mounts.
- Entra ID SSO, SCIM group sync, no workspace-local users; cluster policies and personal-access-token controls.
- Row filters / column masks for sensitive domains; audit via system tables shipped to the SIEM.
- IP access lists or front-end Private Link for the UI; Network Connectivity Configurations for serverless egress.
Environment promotion
The promotion story ties the whole module together: code moves, data does not. One repo, one bundle definition with dev/test/prod targets, deployed by Azure DevOps pipelines into per-environment workspaces and catalogs; jobs, pipelines, and grants are all declared in code, so the DR region is just one more deployment target. As of mid-2026 the official name is Declarative Automation Bundles, but the workflow is the familiar databricks bundle validate / deploy / run.