English

NL2SQL-BUGs: A Benchmark for Detecting Semantic Errors in NL2SQL Translation

Databases 2025-12-08 v2

Abstract

Natural Language to SQL (i.e., NL2SQL) translation is crucial for democratizing database access, but even state-of-the-art models frequently generate semantically incorrect SQL queries, hindering the widespread adoption of these techniques by database vendors. While existing NL2SQL benchmarks primarily focus on correct query translation, we argue that a benchmark dedicated to identifying common errors in NL2SQL translations is equally important, as accurately detecting these errors is a prerequisite for any subsequent correction-whether performed by humans or models. To address this gap, we propose NL2SQL-BUGs, the first benchmark dedicated to detecting and categorizing semantic errors in NL2SQL translation. NL2SQL-BUGs adopts a two-level taxonomy to systematically classify semantic errors, covering 9 main categories and 31 subcategories. The benchmark consists of 2,018 expert-annotated instances, each containing a natural language query, database schema, and SQL query, with detailed error annotations for semantically incorrect queries. Through comprehensive experiments, we demonstrate that current large language models exhibit significant limitations in semantic error detection, achieving an average detection accuracy of 75.16%. Specifically, our method successfully detected 106 errors (accounting for 6.91%) in BIRD, a widely-used NL2SQL dataset, which were previously undetected annotation errors. This highlights the importance of semantic error detection in NL2SQL systems. The benchmark is publicly available at https://nl2sql-bugs.github.io/.

Keywords

Cite

@article{arxiv.2503.11984,
  title  = {NL2SQL-BUGs: A Benchmark for Detecting Semantic Errors in NL2SQL Translation},
  author = {Xinyu Liu and Shuyu Shen and Boyan Li and Nan Tang and Yuyu Luo},
  journal= {arXiv preprint arXiv:2503.11984},
  year   = {2025}
}

Comments

12 pages, 6 figures, 4 tables, KDD 2025

R2 v1 2026-06-28T22:21:38.110Z