find_data
Find datasets by meaning: rank readable pipelines against a natural-language query over names, tags, fields, and hosts. Returns location, freshness, lineage, and query hints without executing.
Instructions
Find datasets by meaning: ranks the pipelines your key can read against a natural-language query over their names, descriptions, tags, catalogs, destination field names, and source hosts. Each hit returns where the data lives, how fresh it is, provenance handles (latest run id, config version, script sha), lineage, and a howToQuery hint naming the existing query/search tool with pre-filled arguments. Discovery only — nothing is executed for you: make the query call yourself, then pass its provenance handles to ai_answer as sources so the answer carries them.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "find_data"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ai | No | Rerank the top candidates with the platform's primary AI model (default: false — ranking is deterministic). | |
| limit | No | Maximum results to return (default: 5, max: 25). | |
| query | Yes | Natural-language description of the data you need. | |
| include_unity_catalog | No | Also search the Unity Catalog tables visible to every Databricks Platform secret your key can read (default: false). Warehouse hits follow the Datris hits, marked `source: "unity-catalog"`; `howToQuery` points at query_databricks only when a Datris pipeline owns the table, otherwise it is a plain SQL hint to run in your warehouse. Secrets without a known SQL warehouse are listed under `unityCatalog.skipped`. A stopped warehouse auto-starts on first use, which can add 5-20 s; a warehouse that does not answer within the per-secret time limit (45 s by default) is skipped rather than blocking the call. Up to `limit` warehouse hits are added on top of the Datris hits. |