{"adoption": {"forks": 97, "observed_at": "2026-08-28T04:05:05.742560+00:00", "stars": 1575}, "canonical_url": "https://ross.abutalabs.com/products/nl2sql_handbook", "card": {"archived": false, "artifact_type": "learning-resource", "description": "This is a continuously updated handbook for readers to easily track the latest Text-to-SQL techniques in the literature and provide practical guidance for researchers and practitioners. ", "domain": ["databases", "large-language-models", "tutorials", "awesome-lists"], "enriched": true, "function": ["nlp", "database", "documentation", "benchmarking"], "health_score": 77, "homepage": "https://arxiv.org/abs/2408.05109", "language": "Python", "license": null, "license_family": "other", "maturity": "active", "member_repos": ["HKUSTDial/NL2SQL_Handbook"], "name": "HKUSTDial/NL2SQL_Handbook", "platform": ["python"], "pushed_at": "2026-07-28T08:54:04+00:00", "repo": "HKUSTDial/NL2SQL_Handbook", "stars": 1575, "tags": ["text-to-sql", "nl2sql", "survey", "handbook", "llm", "awesome-list", "research-papers", "benchmarks", "natural-language-processing"], "topics": ["llms", "nl2sql", "nlp", "text-to-sql", "awesome", "nl-to-code", "text2sql", "ai4db", "text-to-code", "db", "nl-to-sql", "awesome-agents", "awesome-nl2sql", "awesome-text-to-sql", "awesome-text2sql"], "urls": [], "use_cases": ["track the latest text-to-sql research papers", "find benchmarks for evaluating nl2sql systems", "learn how llms translate natural language to sql", "choose a text-to-sql approach for my application", "survey of text-to-sql in the era of llms", "find datasets for training text-to-sql models", "understand error analysis in nl2sql systems"], "what_it_is": "A continuously updated handbook and survey repository tracking the latest Text-to-SQL (NL2SQL) techniques, accompanying TKDE'25 and VLDB'24 survey papers. It curates research papers, benchmarks, evaluation methods, and practical guidance for translating natural language into SQL using LLMs.", "when_to_avoid": ["you need a runnable Text-to-SQL tool or library rather than a reading list", "you need production NL2SQL code - use the companion NL2SQL360 repo or a framework instead"], "when_to_choose": ["you need a curated, continuously updated overview of Text-to-SQL research and benchmarks", "you are a researcher surveying LLM-based NL2SQL techniques", "you are a practitioner deciding which Text-to-SQL solution fits your scenario"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/nl2sql_handbook", "repo": "HKUSTDial/NL2SQL_Handbook", "role": "main", "score": 66}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:05:05.742560+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T03:57:34.590788+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "dd24310a073394990450b2720104fb9d8b825effb98ac9943199686968688e73", "fetched_at": "2026-08-28T04:05:05.742560+00:00", "kind": "readme", "missing": false, "url": "https://github.com/HKUSTDial/NL2SQL_Handbook"}, {"content_hash": "faa70b90ca3c045bc724a2523fdbdbaf40eb608f7a3380beb5f7efb329a5c5c0", "fetched_at": "2026-08-29T11:27:48.568319+00:00", "kind": "homepage", "missing": false, "url": "https://arxiv.org/abs/2408.05109"}, {"content_hash": "cca9c3a11c56b1212864e03fb8a5511a3bdb6df53398ba4dd2ed778f931607dd", "fetched_at": "2026-08-29T11:27:48.577373+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/donate.html"}, {"content_hash": "47cbc55ff1deaca3f36b463373de863a7053d91cacf9f95725618e11610209ae", "fetched_at": "2026-08-29T11:27:48.581128+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/ourmembers.html"}, {"content_hash": "a1f16f915a9ad89ee57c3e929a1b6577d481f52c05f8015fc720b16ee8014f19", "fetched_at": "2026-08-29T11:27:48.583051+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about"}, {"content_hash": "b14a8d05a0ec337409ab63bffd91306b5317b16fac358aa6d1fe6afbaf3c8628", "fetched_at": "2026-08-29T11:27:48.579283+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/labs/index.html"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:05:05.742560+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T03:57:34.590788+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "dd24310a073394990450b2720104fb9d8b825effb98ac9943199686968688e73", "fetched_at": "2026-08-28T04:05:05.742560+00:00", "kind": "readme", "missing": false, "url": "https://github.com/HKUSTDial/NL2SQL_Handbook"}, {"content_hash": "faa70b90ca3c045bc724a2523fdbdbaf40eb608f7a3380beb5f7efb329a5c5c0", "fetched_at": "2026-08-29T11:27:48.568319+00:00", "kind": "homepage", "missing": false, "url": "https://arxiv.org/abs/2408.05109"}, {"content_hash": "cca9c3a11c56b1212864e03fb8a5511a3bdb6df53398ba4dd2ed778f931607dd", "fetched_at": "2026-08-29T11:27:48.577373+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/donate.html"}, {"content_hash": "47cbc55ff1deaca3f36b463373de863a7053d91cacf9f95725618e11610209ae", "fetched_at": "2026-08-29T11:27:48.581128+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/ourmembers.html"}, {"content_hash": "a1f16f915a9ad89ee57c3e929a1b6577d481f52c05f8015fc720b16ee8014f19", "fetched_at": "2026-08-29T11:27:48.583051+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about"}, {"content_hash": "b14a8d05a0ec337409ab63bffd91306b5317b16fac358aa6d1fe6afbaf3c8628", "fetched_at": "2026-08-29T11:27:48.579283+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/labs/index.html"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T03:57:34.590788+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "dd24310a073394990450b2720104fb9d8b825effb98ac9943199686968688e73", "fetched_at": "2026-08-28T04:05:05.742560+00:00", "kind": "readme", "missing": false, "url": "https://github.com/HKUSTDial/NL2SQL_Handbook"}, {"content_hash": "faa70b90ca3c045bc724a2523fdbdbaf40eb608f7a3380beb5f7efb329a5c5c0", "fetched_at": "2026-08-29T11:27:48.568319+00:00", "kind": "homepage", "missing": false, "url": "https://arxiv.org/abs/2408.05109"}, {"content_hash": "cca9c3a11c56b1212864e03fb8a5511a3bdb6df53398ba4dd2ed778f931607dd", "fetched_at": "2026-08-29T11:27:48.577373+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/donate.html"}, {"content_hash": "47cbc55ff1deaca3f36b463373de863a7053d91cacf9f95725618e11610209ae", "fetched_at": "2026-08-29T11:27:48.581128+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/ourmembers.html"}, {"content_hash": "a1f16f915a9ad89ee57c3e929a1b6577d481f52c05f8015fc720b16ee8014f19", "fetched_at": "2026-08-29T11:27:48.583051+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about"}, {"content_hash": "b14a8d05a0ec337409ab63bffd91306b5317b16fac358aa6d1fe6afbaf3c8628", "fetched_at": "2026-08-29T11:27:48.579283+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/labs/index.html"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:05:05.742560+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:05:05.742560+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:05:05.742560+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T03:57:34.590788+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "dd24310a073394990450b2720104fb9d8b825effb98ac9943199686968688e73", "fetched_at": "2026-08-28T04:05:05.742560+00:00", "kind": "readme", "missing": false, "url": "https://github.com/HKUSTDial/NL2SQL_Handbook"}, {"content_hash": "faa70b90ca3c045bc724a2523fdbdbaf40eb608f7a3380beb5f7efb329a5c5c0", "fetched_at": "2026-08-29T11:27:48.568319+00:00", "kind": "homepage", "missing": false, "url": "https://arxiv.org/abs/2408.05109"}, {"content_hash": "cca9c3a11c56b1212864e03fb8a5511a3bdb6df53398ba4dd2ed778f931607dd", "fetched_at": "2026-08-29T11:27:48.577373+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/donate.html"}, {"content_hash": "47cbc55ff1deaca3f36b463373de863a7053d91cacf9f95725618e11610209ae", "fetched_at": "2026-08-29T11:27:48.581128+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/ourmembers.html"}, {"content_hash": "a1f16f915a9ad89ee57c3e929a1b6577d481f52c05f8015fc720b16ee8014f19", "fetched_at": "2026-08-29T11:27:48.583051+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about"}, {"content_hash": "b14a8d05a0ec337409ab63bffd91306b5317b16fac358aa6d1fe6afbaf3c8628", "fetched_at": "2026-08-29T11:27:48.579283+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/labs/index.html"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:05:05.742560+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:05:05.742560+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T03:57:34.590788+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "dd24310a073394990450b2720104fb9d8b825effb98ac9943199686968688e73", "fetched_at": "2026-08-28T04:05:05.742560+00:00", "kind": "readme", "missing": false, "url": "https://github.com/HKUSTDial/NL2SQL_Handbook"}, {"content_hash": "faa70b90ca3c045bc724a2523fdbdbaf40eb608f7a3380beb5f7efb329a5c5c0", "fetched_at": "2026-08-29T11:27:48.568319+00:00", "kind": "homepage", "missing": false, "url": "https://arxiv.org/abs/2408.05109"}, {"content_hash": "cca9c3a11c56b1212864e03fb8a5511a3bdb6df53398ba4dd2ed778f931607dd", "fetched_at": "2026-08-29T11:27:48.577373+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/donate.html"}, {"content_hash": "47cbc55ff1deaca3f36b463373de863a7053d91cacf9f95725618e11610209ae", "fetched_at": "2026-08-29T11:27:48.581128+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/ourmembers.html"}, {"content_hash": "a1f16f915a9ad89ee57c3e929a1b6577d481f52c05f8015fc720b16ee8014f19", "fetched_at": "2026-08-29T11:27:48.583051+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about"}, {"content_hash": "b14a8d05a0ec337409ab63bffd91306b5317b16fac358aa6d1fe6afbaf3c8628", "fetched_at": "2026-08-29T11:27:48.579283+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/labs/index.html"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:05:05.742560+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:05:05.742560+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:05:05.742560+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T03:57:34.590788+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "dd24310a073394990450b2720104fb9d8b825effb98ac9943199686968688e73", "fetched_at": "2026-08-28T04:05:05.742560+00:00", "kind": "readme", "missing": false, "url": "https://github.com/HKUSTDial/NL2SQL_Handbook"}, {"content_hash": "faa70b90ca3c045bc724a2523fdbdbaf40eb608f7a3380beb5f7efb329a5c5c0", "fetched_at": "2026-08-29T11:27:48.568319+00:00", "kind": "homepage", "missing": false, "url": "https://arxiv.org/abs/2408.05109"}, {"content_hash": "cca9c3a11c56b1212864e03fb8a5511a3bdb6df53398ba4dd2ed778f931607dd", "fetched_at": "2026-08-29T11:27:48.577373+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/donate.html"}, {"content_hash": "47cbc55ff1deaca3f36b463373de863a7053d91cacf9f95725618e11610209ae", "fetched_at": "2026-08-29T11:27:48.581128+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/ourmembers.html"}, {"content_hash": "a1f16f915a9ad89ee57c3e929a1b6577d481f52c05f8015fc720b16ee8014f19", "fetched_at": "2026-08-29T11:27:48.583051+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about"}, {"content_hash": "b14a8d05a0ec337409ab63bffd91306b5317b16fac358aa6d1fe6afbaf3c8628", "fetched_at": "2026-08-29T11:27:48.579283+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/labs/index.html"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:05:05.742560+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:05:05.742560+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T03:57:34.590788+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "dd24310a073394990450b2720104fb9d8b825effb98ac9943199686968688e73", "fetched_at": "2026-08-28T04:05:05.742560+00:00", "kind": "readme", "missing": false, "url": "https://github.com/HKUSTDial/NL2SQL_Handbook"}, {"content_hash": "faa70b90ca3c045bc724a2523fdbdbaf40eb608f7a3380beb5f7efb329a5c5c0", "fetched_at": "2026-08-29T11:27:48.568319+00:00", "kind": "homepage", "missing": false, "url": "https://arxiv.org/abs/2408.05109"}, {"content_hash": "cca9c3a11c56b1212864e03fb8a5511a3bdb6df53398ba4dd2ed778f931607dd", "fetched_at": "2026-08-29T11:27:48.577373+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/donate.html"}, {"content_hash": "47cbc55ff1deaca3f36b463373de863a7053d91cacf9f95725618e11610209ae", "fetched_at": "2026-08-29T11:27:48.581128+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/ourmembers.html"}, {"content_hash": "a1f16f915a9ad89ee57c3e929a1b6577d481f52c05f8015fc720b16ee8014f19", "fetched_at": "2026-08-29T11:27:48.583051+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about"}, {"content_hash": "b14a8d05a0ec337409ab63bffd91306b5317b16fac358aa6d1fe6afbaf3c8628", "fetched_at": "2026-08-29T11:27:48.579283+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/labs/index.html"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T03:57:34.590788+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "dd24310a073394990450b2720104fb9d8b825effb98ac9943199686968688e73", "fetched_at": "2026-08-28T04:05:05.742560+00:00", "kind": "readme", "missing": false, "url": "https://github.com/HKUSTDial/NL2SQL_Handbook"}, {"content_hash": "faa70b90ca3c045bc724a2523fdbdbaf40eb608f7a3380beb5f7efb329a5c5c0", "fetched_at": "2026-08-29T11:27:48.568319+00:00", "kind": "homepage", "missing": false, "url": "https://arxiv.org/abs/2408.05109"}, {"content_hash": "cca9c3a11c56b1212864e03fb8a5511a3bdb6df53398ba4dd2ed778f931607dd", "fetched_at": "2026-08-29T11:27:48.577373+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/donate.html"}, {"content_hash": "47cbc55ff1deaca3f36b463373de863a7053d91cacf9f95725618e11610209ae", "fetched_at": "2026-08-29T11:27:48.581128+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/ourmembers.html"}, {"content_hash": "a1f16f915a9ad89ee57c3e929a1b6577d481f52c05f8015fc720b16ee8014f19", "fetched_at": "2026-08-29T11:27:48.583051+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about"}, {"content_hash": "b14a8d05a0ec337409ab63bffd91306b5317b16fac358aa6d1fe6afbaf3c8628", "fetched_at": "2026-08-29T11:27:48.579283+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/labs/index.html"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T03:57:34.590788+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "dd24310a073394990450b2720104fb9d8b825effb98ac9943199686968688e73", "fetched_at": "2026-08-28T04:05:05.742560+00:00", "kind": "readme", "missing": false, "url": "https://github.com/HKUSTDial/NL2SQL_Handbook"}, {"content_hash": "faa70b90ca3c045bc724a2523fdbdbaf40eb608f7a3380beb5f7efb329a5c5c0", "fetched_at": "2026-08-29T11:27:48.568319+00:00", "kind": "homepage", "missing": false, "url": "https://arxiv.org/abs/2408.05109"}, {"content_hash": "cca9c3a11c56b1212864e03fb8a5511a3bdb6df53398ba4dd2ed778f931607dd", "fetched_at": "2026-08-29T11:27:48.577373+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/donate.html"}, {"content_hash": "47cbc55ff1deaca3f36b463373de863a7053d91cacf9f95725618e11610209ae", "fetched_at": "2026-08-29T11:27:48.581128+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/ourmembers.html"}, {"content_hash": "a1f16f915a9ad89ee57c3e929a1b6577d481f52c05f8015fc720b16ee8014f19", "fetched_at": "2026-08-29T11:27:48.583051+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about"}, {"content_hash": "b14a8d05a0ec337409ab63bffd91306b5317b16fac358aa6d1fe6afbaf3c8628", "fetched_at": "2026-08-29T11:27:48.579283+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/labs/index.html"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T03:57:34.590788+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "dd24310a073394990450b2720104fb9d8b825effb98ac9943199686968688e73", "fetched_at": "2026-08-28T04:05:05.742560+00:00", "kind": "readme", "missing": false, "url": "https://github.com/HKUSTDial/NL2SQL_Handbook"}, {"content_hash": "faa70b90ca3c045bc724a2523fdbdbaf40eb608f7a3380beb5f7efb329a5c5c0", "fetched_at": "2026-08-29T11:27:48.568319+00:00", "kind": "homepage", "missing": false, "url": "https://arxiv.org/abs/2408.05109"}, {"content_hash": "cca9c3a11c56b1212864e03fb8a5511a3bdb6df53398ba4dd2ed778f931607dd", "fetched_at": "2026-08-29T11:27:48.577373+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/donate.html"}, {"content_hash": "47cbc55ff1deaca3f36b463373de863a7053d91cacf9f95725618e11610209ae", "fetched_at": "2026-08-29T11:27:48.581128+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about/ourmembers.html"}, {"content_hash": "a1f16f915a9ad89ee57c3e929a1b6577d481f52c05f8015fc720b16ee8014f19", "fetched_at": "2026-08-29T11:27:48.583051+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/about"}, {"content_hash": "b14a8d05a0ec337409ab63bffd91306b5317b16fac358aa6d1fe6afbaf3c8628", "fetched_at": "2026-08-29T11:27:48.579283+00:00", "kind": "site_page", "missing": false, "url": "https://info.arxiv.org/labs/index.html"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 94, "longevity": 59, "rhythm": 35}, "computed_at": "2026-09-02T17:46:02.011165+00:00", "flags": ["no_releases", "no_license"], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 834, "days_push": 36, "days_rel": null, "gap_med": null, "n_releases_24m": 0}, "score": 66, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}