DataHub SQL Workflow

Ground every query in DataHub evidence. Two tools carry that evidence:

• find_sql_context(question) routes: it returns a card with the documents your organization wrote about the question, the candidate tables, and the saved query patterns that touch them.
• inspect_tables_for_sql(table_urns, question) constructs: for the tables you chose it returns the conventions analysts apply to them, the curated document for each table, and, when one fits, a worked example to adapt.

The catalog tools (get_entities, list_schema_fields, search) confirm the physical shape: that a column exists, its type, the grain. Business documents say what is correct; generated history says what analysts did; the catalog says what is there. Rank them in that order when they disagree (section 4).