Understanding, Detecting, and Repairing Real-World In-Context-Learning-Based Text-to-SQL Errors
Large language models (LLMs) have been adopted for text-to-SQL tasks, utilizing their in-context learning (ICL) capability to translate natural language questions into SQL queries. However, such a technique faces correctness problems. In this paper, we conduct the first comprehensive study of text-to-SQL errors of ICL-based techniques. Our study covers four representative ICL-based techniques, five basic repairing methods, two benchmarks, and two LLM settings. We find that text-to-SQL errors are widespread and summarize 27 error types of 7 categories. We also find that existing repairing attempts have limited correctness improvement while having high computational overhead and many mis-repairs. Based on these findings, we propose MapleDoctor, a novel text-to-SQL error detection and repairing framework. The evaluation demonstrates that MapleDoctor outperforms existing solutions by repairing 13.8% more queries with a negligible number of mis-repairs and reducing 67.4% repair latency. The artifact is publicly available at GitHub.
Authors
- Chengcheng Wan (ORCID: https://orcid.org/0000-0001-9162-9688)
- Jiazhen Zou
- Geguang Pu (ORCID: https://orcid.org/0000-0001-9750-8334)
- Yuchen Shao (ORCID: https://orcid.org/0000-0001-6365-1917)
- Jiawei Shen (ORCID: https://orcid.org/0000-0001-7048-6665)
- Yueling Zhang (ORCID: https://orcid.org/0000-0002-0510-8307)
- Hang Xu (ORCID: https://orcid.org/0009-0009-4669-6078)
- Weikai Miao (ORCID: https://orcid.org/0009-0006-2038-439X)
Institutions
- Shanghai Innovative Research Center of Traditional Chinese Medicine (CN)
- East China Normal University (CN)
Publication Details
- Journal
- Proceedings of the ACM on software engineering.
- Published
- 2026-06-30
- DOI
- https://doi.org/10.1145/3808171
- Primary Topic
- Cloud Computing and Resource Management
- Type
- preprint
- Field-Weighted Citation Impact
- 0.00
Funders
- National Natural Science Foundation of China