arrow
Return

Distilled documentation for dialect-specific SQL generation

delete2026-07-03
delete0
PRE
AI
T
Till Döhmen *
A
Adithya Krishnan
H
Hamilton Ulmer
P
Peter Boncz
S
Sebastian Schelter
DOI:10.1007/s00778-026-00993-5delete
deleteOriginal
deleteOriginal request for help
deleteShare
deleteSave
Abstract

Abstract

En 中文
We show that LLMs benefit from succinct, distilled documentation of SQL constructs that can be retrieved on demand—avoiding the need to parse and chunk web documentation or overload context windows with full manuals. Using DuckDB as our primary case study, we analyze query logs from MotherDuck, a cloud analytics platform built on DuckDB, to show that real-world SQL extends far beyond analytical queries, with users frequently employing dialect-specific functionality that LLMs struggle with. We develop DuckDB-DocBench to evaluate six LLMs, finding that without additional knowledge they achieve only around 60% execution accuracy. A simple approach—LLM-generated function descriptions and examples derived from existing documentation and organized for targeted retrieval—improves accuracy by up to 34%, and also benefits tasks adjacent to Text-to-SQL, such as query repair. To validate generalizability, we apply the same methodology to PostgreSQL (PG-DocBench), observing 15–26% relative improvement despite its extensive presence in training corpora, with newer features showing larger gains.
Keywords:
Text-to-SQL
DuckDB
PostgreSQL
SQL dialects
Large language models
Retrieval-augmented generation
Query repair

Journal

T
The VLDB Journal
IF:
0
Papers:
36
Citations:
0

Organization

No organization information available
Cited Papers

Cited Papers

The Dawn of Natural Language to SQL: Are We Fully Ready?
err2024-08-30
err0
errOAAI
errBoyan Li; Yuyu Luo; Chengliang Chai; Guoliang Li; Nan Tang
errShare
errSave
Text-to-SQL Empowered by Large Language Models: A Benchmark Evaluation
err2024-05-02
err0
errOAAI
errDawei Gao; Haibin Wang; Yaliang Li; Xiuyu Sun; Yichen Qian; Bolin Ding; Jingren Zhou
errShare
errSave
GPTuner: A Manual-Reading Database Tuning System via GPT-Guided Bayesian Optimization
err2024-05-31
err0
errOAAI
errJiale Lao; Yibo Wang; Yufei Li; Jianping Wang; Yunjia Zhang; Zhiyuan Cheng; Wanghu Chen; Mingjie Tang; Jianguo Wang
errShare
errSave
CatSQL : Towards Real World Natural Language to SQL Applications
err2023-04-20
err0
PREAI
errHan Fu; Chang Liu; Bin Wu; Feifei Li; Jian Tan; Jianling Sun
errShare
errSave
SchemaPile: A Large Collection of Relational Database Schemas
err2024-05-30
err0
errOAAI
errTill Döhmen; Radu Geacu; Madelon Hulsebos; Sebastian Schelter
errShare
errSave
Survey of vector database management systems
err2024-07-15
err0
PREAI
errJames Jie Pan; Jianguo Wang; Guoliang Li
errShare
errSave
Can LLM Already Serve as A Database Interface? A BIg Bench for Large-Scale Database Grounded Text-to-SQLs
err2023-01-01
err0
PREAI
errLi,Jinyang; Hui,Binyuan; Qu,Ge; Yang,Jiaxi; Li,Binhua; Li,Bowen; Wang,Bailin; Qin,Bowen; Geng,Ruiying; Huo,Nan; Zhou,Xuanhe; Chenhao,Ma; Li,Guoliang; Chang,Kevin; Huang,Fei; Cheng,Reynold; Li,Yongbin
errShare
errSave
no more