{"about":{"non_affiliation":"Code with Papers and Syntology are not affiliated with, endorsed by, or sponsored by Papers with Code, Meta, or the pwc-archive mirror.","site":"https://codewithpapers.app","licence":"CC BY-SA 4.0","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","attribution":"https://codewithpapers.app/attribution","modified":"archive material modified by Syntology; see the attribution page","syntology":{"site":"https://syntology.ai","developers":"https://syntology.ai/developers","mcp":{"server":"https://syntology.ai/mcp","transport":"streamable-http","server_card":"https://syntology.ai/.well-known/mcp/server-card.json","auth":{"type":"trial token, no account","trial_token":"https://syntology.ai/api/oauth/trial/token","method":"POST","docs":"https://syntology.ai/developers"}},"have":"https://syntology.ai/api/graph/have?x=<method, arXiv id or title> (free, answers coverage only)","paper_base":"https://syntology.ai/paper/","atlas_base":"https://app.syntology.ai/?focus="},"machine_readable":[{"url":"https://codewithpapers.app/llms.txt","what":"the machine catalog: every machine-readable file, counted"},{"url":"https://codewithpapers.app/index/manifest.json","what":"paper-to-code index by arXiv id, with Syntology's counts"},{"url":"https://codewithpapers.app/search/manifest.json","what":"site search index (titles, authors) and its files"},{"url":"https://codewithpapers.app/download","what":"bulk files: Syntology's layer, described there"},{"url":"https://codewithpapers.app/build_manifest.json","what":"the build record: inputs, counts, exclusions, probes"}]},"url":"/paper/benchmarking-and-improving-text-to-sql","title":"Benchmarking and Improving Text-to-SQL Generation under Ambiguity","arxiv_id":"2310.13659","date":"2023-10-20","proceeding":null,"authors":["Adithya Bhaskar","Tushar Tomar","Ashutosh Sathe","Sunita Sarawagi"],"abstract":"Research in Text-to-SQL conversion has been largely benchmarked against datasets where each text query corresponds to one correct SQL. However, natural language queries over real-life databases frequently involve significant ambiguity about the intended SQL due to overlapping schema names and multiple confusing relationship paths. To bridge this gap, we develop a novel benchmark called AmbiQT with over 3000 examples where each text is interpretable as two plausible SQLs due to lexical and/or structural ambiguity. When faced with ambiguity, an ideal top-$k$ decoder should generate all valid interpretations for possible disambiguation by the user. We evaluate several Text-to-SQL systems and decoding algorithms, including those employing state-of-the-art LLMs, and find them to be far from this ideal. The primary reason is that the prevalent beam search algorithm and its variants, treat SQL queries as a string and produce unhelpful token-level diversity in the top-$k$. We propose LogicalBeam, a new decoding algorithm that navigates the SQL logic space using a blend of plan-based template generation and constrained infilling. Counterfactually generated plans diversify templates while in-filling with a beam-search that branches solely on schema names provides value diversity. LogicalBeam is up to $2.5$ times more effective than state-of-the-art models at generating all candidate SQLs in the top-$k$ ranked outputs. It also enhances the top-$5$ Exact and Execution Match Accuracies on SPIDER and Kaggle DBQA.","url_abs":"https://arxiv.org/abs/2310.13659v1","url_pdf":"https://arxiv.org/pdf/2310.13659v1.pdf","source":{"archive":"pwc-archive (Hugging Face), CC BY-SA 4.0","snapshot":"2025-07-28","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","row_kind":"abstracts"},"code_links":[{"paper_slug":"benchmarking-and-improving-text-to-sql","repo_url":"https://github.com/testzer0/ambiqt","is_official":1,"mentioned_in_paper":1,"mentioned_in_github":0,"framework":"none","reach":{"status":"ok","spdx":"MIT"}}],"tasks":[{"task_slug":"benchmarking","task_name":"Benchmarking"},{"task_slug":"diversity","task_name":"Diversity"},{"task_slug":"natural-language-queries","task_name":"Natural Language Queries"},{"task_slug":"text-to-sql","task_name":"Text to SQL"},{"task_slug":"text-to-sql","task_name":"Text-To-SQL"},{"task_slug":null,"task_name":"valid"}],"methods":[],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"syntology_url":"https://syntology.ai/paper/2310.13659","atlas_url":"https://app.syntology.ai/?focus=2310.13659","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2310.13659"},"calls":[{"tool":"get_harvested_code_for_paper","arguments":{"arxiv_id":"2310.13659"},"returns":"the samples harvested from this paper, each with its run record; it does not verify the paper"},{"tool":"get_code","arguments_in":"samples[].code_sha256","returns":"one stored sample by its code_sha256; not shown on this site"}]},"developers":"https://syntology.ai/developers","held":true,"reason":"in_graph_layer","checked_against":null,"agent_calls":[{"tool":"get_harvested_code_for_paper","arguments":{"arxiv_id":"2310.13659"},"call":"get_harvested_code_for_paper(arxiv_id=\"2310.13659\")"},{"tool":"get_code","arguments_in":{"code_sha256":"syntology.samples[].code_sha256"},"call":"get_code(code_sha256=\"…\")"},{"tool":"get_citation_path","arguments":{"paper_1":"2310.13659"},"arguments_in":{"paper_2":"another paper's arXiv id or title"},"call":"get_citation_path(paper_1=\"2310.13659\", paper_2=\"…\")"},{"tool":"get_concepts_for_paper","arguments":{"arxiv_id":"2310.13659"},"call":"get_concepts_for_paper(arxiv_id=\"2310.13659\")"}],"by_repo":[{"repo":"testzer0/ambiqt","kind":"official","samples":17,"ran":12,"instrument":0,"unverified":5}],"by_repo_is":"one row per repository in the archive's code links, Syntology's graph links or the samples; samples 0 means no sample is linked to this paper, a statement about Syntology's coverage, not about the repository: with harvested_for_other_papers present, Syntology harvested the repository for that many other papers, and without it, Syntology harvested nothing from it; placed_by_identical_code counts samples whose link records no repository, placed here because identical code was harvested from this repository for another paper; ran counts executions on a synthesized input and instrument counts failures of Syntology's instrument, not of the code","read_at":"2026-10-05T00:36:11+00:00","read_at_is":"when the build read Syntology's graph, not when any sample ran","ran_record":{"url":"https://syntology.ai/api/ran/2310.13659.json","schema":"syntology.ran_record/1","counts_crosswalk":{"n_samples":"syntology.counts.lifted","n_ran":"syntology.counts.executed","n_ran_checked":"syntology.counts.checked","n_instrument":"syntology.counts.instrument_failures","n_unverified":"syntology.counts.no_recorded_run"},"note":"live record, measured at request time; may be newer than this page's graph read","badge":"https://syntology.ai/api/ran/2310.13659.svg"},"claim":"Per-sample execution status on synthesized fixtures; not a correctness claim about the paper. Samples come from repositories linked to the paper, official or community; repo_kind says which.","repos":[{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/testzer0/ambiqt","reach":{"status":"ok","spdx":"MIT"}},{"provenance":"deterministic:regex_extraction","url":"https://github.com/testzer0/AmbiQT","reach":{"status":"ok","spdx":"MIT"}}],"summary":{"ran":9,"ran_violates":3,"unverified":5},"n_samples":17,"n_ran":12,"n_constructed":0,"n_ran_checked":12,"n_instrument":0,"n_unverified":5,"n_instrument_is":"failures of Syntology's instrument, not of the code","every_run_is_an_instrument_failure":false,"key_notes":{"n_ran_checked":"legacy name, kept unchanged so existing readers do not break: it counts the samples that ran with no instrument failure (honoured, violated, and ran with no contract checked); it does not mean a contract was checked, and the pages print it as 'K with no instrument failure', not 'K checked'","n_constructed":"a sub-count of the samples that ran, never subtracted from them and never a failure: an executed sample whose run returned an instance of its own class (fixture_out_type equals the entry name): the run built an object and did not compute a result (Syntology's RAN record, counts.constructed)"},"by_repo_kind":{"official":{"samples":17,"ran":12,"n_ran_checked":12,"n_instrument":0,"repositories":1}},"repo_kind_vocabulary":{"official":"The archive marks this repository official for the paper","named_in_paper":"The archive records that the paper mentions this repository; it is not marked official","listed":"In the archive's code links for this paper, not marked official and not recorded as mentioned in the paper","found_in_text":"Syntology found this repository in the paper's own text; whether it is the authors' implementation is not asserted","community":"Not in the archive's code links for this paper; a community repository Syntology harvested"},"n_pointer_only_for_licence":0,"inline_ok_is":"inline_ok is true only when both licence gates allow Syntology to serve this code's text: this paper's link (inline_ok_link, from the licence of this paper's copy) and the stored copy of the same code that Syntology serves, which may have been first harvested from another repository. withheld_clause is Syntology's own wording of which gate keeps the text a pointer and why, and is null when inline_ok is true. This site shows no code text either way; n_pointer_only_for_licence counts samples with inline_ok false (both gates), n_pointer_only_link_allows those of them whose inline_ok_link is true","n_pointer_only_link_allows":0,"fixture_fields_is":{"signature_and_fixture_out_type":"the arguments Syntology's fixture called the sample with, each as name:type/rank/element kind (? where none was recorded), and the type of what the fixture's run returned, exactly as the harness recorded them; the arguments and the returned type were recorded by two separate runs of the same fixture. No output value is shown, and a returned type says nothing about whether the output was right","level_recorded_at":"when Syntology's graph wrote the sample's verification level, not when the code executed; absent where the level was written before the date was kept, and never filled in with the build date","present_on":"samples that ran only; a key is absent, never empty, where the graph records nothing"},"n_ran_with_level_date":12,"n_ran_without_level_date":0,"n_ran_signature_not_shown":0,"levels_written_between":{"first":"2026-09-24","last":"2026-09-24","is":"the first and last UTC dates on which Syntology's graph wrote a verification level for a sample on this page that ran, not when the code executed"},"code_page_min_papers":5,"code_page_is":"a page for the entry name across every paper's harvested code; the name is a string, not an identity","samples":[{"code_sha256":"0ca547f553ddb65d","code_sha256_prefix":"0ca547f553ddb65d","entry":"disallowed","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/logicalbeam/ablation_direct.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/logicalbeam/ablation_direct.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"tokens:Tensor/1/int, allowed_tokens:set/0/?","fixture_out_type":"Tensor","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":null,"census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"0ca547f553ddb65d"}},{"code_sha256":"d3bdc5e617b7e466","code_sha256_prefix":"d3bdc5e617b7e466","entry":"extract_tables_and_columns","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/logicalbeam/ablation_direct.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/logicalbeam/ablation_direct.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"schema:str/0/str","fixture_out_type":"tuple","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":null,"census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"d3bdc5e617b7e466"}},{"code_sha256":"180f6cfb0b94cda6","code_sha256_prefix":"180f6cfb0b94cda6","entry":"get_col_mappings","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/utils/data.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/utils/data.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"tinfo:list/1/dict, original:bool/0/bool","fixture_out_type":"dict","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":null,"census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"180f6cfb0b94cda6"}},{"code_sha256":"a29ff82a4708e5c7","code_sha256_prefix":"a29ff82a4708e5c7","entry":"get_output_with_prefix","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/logicalbeam/template_gen.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/logicalbeam/template_gen.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"model:callable/0/?, tokenizer:callable/0/?, model_input:str/0/str, prefix:str/0/str, beam_width:int/0/int, num_outputs:int/0/int, device:device/0/?","fixture_out_type":"list","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":null,"census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"a29ff82a4708e5c7"}},{"code_sha256":"b0dc867bb550c2d7","code_sha256_prefix":"b0dc867bb550c2d7","entry":"get_selections","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/collate.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/collate.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"selections:list/1/list, k:int/0/int","fixture_out_type":"list","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":null,"census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"b0dc867bb550c2d7"}},{"code_sha256":"b724cc2d4066a429","code_sha256_prefix":"b724cc2d4066a429","entry":"is_commonword","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/utils/content.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/utils/content.py","link_basis":"harvester_set","language":"python","status":"ran_violates","verification_level":1,"contract_check":"VIOLATES","metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"s:str/0/str","fixture_out_type":"bool","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":"/code/is-commonword","census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"b724cc2d4066a429"}},{"code_sha256":"f39fdc1ce6cffe08","code_sha256_prefix":"f39fdc1ce6cffe08","entry":"is_number","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/utils/content.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/utils/content.py","link_basis":"harvester_set","language":"python","status":"ran_violates","verification_level":1,"contract_check":"VIOLATES","metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"s:str/0/str","fixture_out_type":"bool","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":"/code/is-number","census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"f39fdc1ce6cffe08"}},{"code_sha256":"d56a1f9221823a48","code_sha256_prefix":"d56a1f9221823a48","entry":"is_stopword","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/utils/content.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/utils/content.py","link_basis":"harvester_set","language":"python","status":"ran_violates","verification_level":1,"contract_check":"VIOLATES","metamorphic_tier":null,"behaviour_fingerprint":false,"signature":"s:str/0/str","fixture_out_type":"bool","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","code_page":"/code/is-stopword","census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"d56a1f9221823a48"}},{"code_sha256":"83fb78ab0d26fa54","code_sha256_prefix":"83fb78ab0d26fa54","entry":"lower","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/collate.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/collate.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"signature":"s:str/0/str","fixture_out_type":"str","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","retrieve_with":{"tool":"get_code","code_sha256":"83fb78ab0d26fa54"},"code_page":null,"census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"83fb78ab0d26fa54"}},{"code_sha256":"56def8190912ab3f","code_sha256_prefix":"56def8190912ab3f","entry":"normalize_spaces","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/utils/sql.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/utils/sql.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"signature":"text:str/0/str","fixture_out_type":"str","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","retrieve_with":{"tool":"get_code","code_sha256":"56def8190912ab3f"},"code_page":null,"census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"56def8190912ab3f"}},{"code_sha256":"f146bec5afa35b8d","code_sha256_prefix":"f146bec5afa35b8d","entry":"normalize_sql","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/collate.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/collate.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"signature":"sql:str/0/str","fixture_out_type":"str","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","retrieve_with":{"tool":"get_code","code_sha256":"f146bec5afa35b8d"},"code_page":null,"census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"f146bec5afa35b8d"}},{"code_sha256":"4ff91e232c45be1a","code_sha256_prefix":"4ff91e232c45be1a","entry":"try_extract_json","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/chatgpt/prompter.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/chatgpt/prompter.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"signature":"string:str/0/str, check:bool/0/bool","fixture_out_type":"dict","level_recorded_at":"2026-09-24T15:16:18.137819+00:00","retrieve_with":{"tool":"get_code","code_sha256":"4ff91e232c45be1a"},"code_page":null,"census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"4ff91e232c45be1a"}},{"code_sha256":"b90b6e1db0a2c350","code_sha256_prefix":"b90b6e1db0a2c350","entry":"get_model_picard","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/utils/model_utils.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/utils/model_utils.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"code_page":null,"census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"b90b6e1db0a2c350"}},{"code_sha256":"f988bbea8a36c875","code_sha256_prefix":"f988bbea8a36c875","entry":"get_reply","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/chatgpt/helper.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/chatgpt/helper.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"code_page":null,"census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"f988bbea8a36c875"}},{"code_sha256":"73bf0aed972d0f6c","code_sha256_prefix":"73bf0aed972d0f6c","entry":"get_reply_with_retries","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/chatgpt/helper.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/chatgpt/helper.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"code_page":null,"census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"73bf0aed972d0f6c"}},{"code_sha256":"b2cd044e4edcf9d1","code_sha256_prefix":"b2cd044e4edcf9d1","entry":"load_spider","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/utils/data.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/utils/data.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"code_page":null,"census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"b2cd044e4edcf9d1"}},{"code_sha256":"7b30094e3a706d3f","code_sha256_prefix":"7b30094e3a706d3f","entry":"to_device_multiple","repo":"testzer0/AmbiQT","repo_kind":"official","path":"src/utils/model_utils.py","file_url":"https://github.com/testzer0/AmbiQT/blob/HEAD/src/utils/model_utils.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"code_page":null,"census":null,"licence":"MIT","inline_ok":true,"inline_ok_link":true,"withheld_clause":null,"mcp_get_code":{"code_sha256":"7b30094e3a706d3f"}}]},"code_links_note":null,"arxiv_metadata":null,"syntology_extracted_results":null,"record_sha256":"7ea3d01d36329477b36452c4328201230ff29471ba11dd5c62dbad622a6c13c2","record_changed_at":"2026-10-04","record_changed_at_basis":"changed"}