Project snapshot
What I owned
As the on-site FDE, I was the direct technical contact for customer requirements. I implemented most changes requested through customer feedback, with direct ownership of the search-results upgrade, the data-governance features, and the detailed Query Builder interactions.
The initial request
“Our employees cannot use SQL. Help them access and use the data.”
Customer, project kickoff
The request assumed that SQL syntax was the bottleneck. But writing a query only helps after a user knows which data exists, understands how it is organised, and can decide what to ask for.
The real gap appeared earlier in the workflow. Operators needed a way to discover and understand the available data before they could query it.
Problem discovery: a screen that worked and still failed
The first version reached the 200-user beta. Then I received direct feedback that the results screen did not communicate enough context.
“We can tell the portal is trying to provide a lot of data, but we cannot tell what information is available or what the screen is trying to show us.”
Beta user feedback, paraphrased
The screen returned data, but users could not understand what they were looking at or how each result related to the wider structure. To identify the cause rather than patch the visible symptoms, I used and compared other data-search products myself. That research showed how hierarchy, filtering and result context reduce the user’s interpretation burden. I used those findings to define the improvement direction and rebuilt the experience.
- Logistics128
- Delivery36
- Warehouse44
- Transport48
- Finance57
- Customer39
- From a result-first screen to guided exploration.
- From flat search results to hierarchy and filtering.
- From assuming users knew the catalog to showing where each result belonged.
Constraints that shaped the product
This was not a greenfield application. The solution had to fit into an existing enterprise environment.
- The Databricks platform already existed and was maintained by a partner team.
- Data governance and access boundaries could not be bypassed by the portal.
- The primary users were operators, not analysts or engineers.
- Several companies owned different layers of the delivery, so technical and organisational boundaries had to stay explicit.
- I joined two weeks before beta testing, so I had to understand the existing code and customer context while delivering against an immediate deadline.
- The first release had to support 200 users while remaining compatible with a wider enterprise rollout.
My team owned the portal layer and Power BI delivery. We did not replace the Databricks platform. I owned the portal’s technical direction and hands-on implementation while coordinating the report work between the customer and our modeler. That boundary kept the product focused and made responsibilities legible across the delivery team.
Key decisions
01Build a discovery layer, not a SQL training tool
I treated the customer’s request as a starting point rather than the specification. Instead of optimising first for query generation, I organised the product around discovering what data was available and narrowing it to something understandable.
This shifted the primary experience from “write a better query” to “find the right place to begin”.
02Replace the first search-results experience instead of patching it
The first version reached beta, but users could not read the results. Rather than adjusting the screen, I researched other data-search products to find why the structure failed, then rebuilt the information architecture around hierarchy, filtering and result context.
03Keep ownership boundaries visible in the architecture
The portal connects to standardised information in Databricks and presents it in a form operations users can navigate. Curated Gold Mart datasets feed Power BI reports, which are embedded back into the portal. The portal adds the user-facing discovery, query, report and governance experiences without replacing the underlying data platform.
This was both a technical and a delivery decision. In a multi-party enterprise project, unclear ownership becomes a system risk.
04Treat natural-language query generation as a PoC — and say so
The Query Builder uses a Databricks-hosted LLM to generate a query from a user’s intent. The user can review the query, execute it against Databricks, inspect the returned data in the portal, and export the result to Excel.
The end-to-end workflow works, but the current PoC does not yet include the production-grade validation layer needed to verify generated queries before broader use. That validation must be designed alongside the generator before the feature can be called complete.
05Turn data quality into an operational governance workflow
The governance work is not only a dashboard of quality metrics. Databricks data is assessed for standardisation quality and contamination, and governance administrators need a repeatable way to review issues and correct them through the portal.
I own this feature area end to end. The workflow connects data-quality signals to administrator review and correction, making standardisation something the organisation can operate rather than a one-time data-cleaning task.
Service architecture
The Query Builder covers the full user flow from query generation and execution to viewing and exporting results. Its remaining gap is query validation, not execution. The governance workflow measures quality and contamination signals from Databricks, presents them to governance administrators, and supports a managed correction process through the portal.
Query Builder — the flow I implemented
The user describes the question
No SQL required at the entry point. The intent is captured in the user’s own words, inside the dataset they already narrowed to during discovery.
A Databricks-hosted LLM generates the query
The generated query is shown to the user before anything runs. This review step exists because the PoC has no production-grade validation layer — a limit I flagged rather than hid.
Execution runs against Databricks, inside the existing permissions
The portal does not hold a shadow copy of the data and does not bypass governance. The query executes where the data and the access controls already live.
Results are readable in the portal
The operator sees the answer in the same place they found the dataset, without switching to an analyst tool.
| region_cd | failed_cnt |
|---|---|
| REGION-A | 184 |
| REGION-C | 121 |
| REGION-B | 96 |
| REGION-D | 43 |
Excel export closes the real workflow
Operations work continues in spreadsheets. Ending the flow inside the portal would have moved the problem, not solved it.
Implementation and iteration
Joined the project on-site
Took over customer-requested development while reading an existing codebase and an in-flight customer relationship.
Reframed the request
The SQL request became a data-discovery problem, which changed what the first release had to prove.
200-user beta completed
Delivered with the wider project team across four organisations.
The feedback that mattered
“A lot of data, but we cannot tell what is available.” A technically correct screen was failing.
Cause analysis, not patching
Used competing data-search products directly to find why the structure failed, then defined the improvement direction.
Rebuilt the results experience
Hierarchy, filtering and result context, implemented by me.
Query Builder end to end
Generation, review, execution, results and Excel export.
Governance workflow
Quality measurement, administrator review and standardisation correction — owned end to end, still in development.
The most important iteration was not technical
It was recognising that a technically functional result screen still failed if users could not understand the result. That is a product judgement, and it only surfaced because I was on-site to hear it said plainly.
Outcome — and what is not done
Completed
- Joined two weeks before beta and helped complete the 200-user beta.
- Standardised Databricks data represented in the portal, with the platform boundary preserved.
- Power BI reports built from curated Gold Mart datasets, embedded in the portal.
- Query Builder: generation, execution, Databricks results and Excel export.
In progress
- Enterprise-wide expansion.
- The data-governance workflow — measurement, administrator review, correction.
Explicit limits
- The Query Builder is a PoC: no production-grade query validation layer yet.
- User satisfaction has not been measured.
- The ~350M records describe data connected through the platform, not records created or processed by the portal.
- This case demonstrates a successful 200-user beta, not a completed company-wide deployment.
What I learned
The initial request often describes the nearest visible obstacle, not the underlying workflow problem. Here, SQL was visible — but discoverability came first.
If I ran the project again, I would put a stripped-down results experience in front of five operators during the first week, to test whether users understood the information structure before the team invested in a wider rollout. I would also design query validation at the same time as generation, rather than treating it as a later production concern.
Diagrams are drawn from the real systems and redrawn here; customer names, data and identifiers are removed.