Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Latest commit e1dc593 Jul 1, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
data update data structure Jun 10, 2019
img update readme Jun 10, 2019
saved_model init Jun 10, 2019
sqlnet update ex calculation Jul 1, 2019
LICENSE init Jun 10, 2019 update readme Jun 28, 2019 init Jun 10, 2019 init Jun 10, 2019 support execution accuracy Jun 18, 2019 support execution accuracy Jun 18, 2019

***** New June 28st, 2019 *****

Fix the execution accuracy calculation, covering all correct cases, for example


Another example is

SELECT COL_1 ... WHERE COL_2 == 1 OR COL_3 == 1
SELECT COL_1 ... WHERE COL_3 == 1 OR COL_2 == 1

Now we assume these SQL pairs have the same execution result.

***** New June 18st, 2019 *****

This version of release supports execution accuracy, which gets the execution result of predicted SQL. This requires records==0.5.3 before running.


This baseline method is developed and refined based on code of SQLNet, which is a baseline model in WikiSQL.

The model decouples the task of generating a whole SQL into several sub-tasks, including select-number, select-column, select-aggregation, condition-number, condition-column and so on.

Simple model structure shows here, implementation details could refer to the origin paper.

The difference between SQLNet and this baseline model is, Select-Number and Where-Relationship sub-tasks are added to adapt this Chinese NL2SQL dataset better.


  • Python 2.7
  • torch 1.0.1
  • records 0.5.3
  • tqdm

Start to train

Firstly, download the provided datasets at ~/data_nl2sql/, which should include train.json, train.tables.json, val.json, val.tables.json and char_embedding, and divide them in following structure.

├── data_nl2sql
│ ├── train
│ │ ├── train.db
│ │ ├── train.json
│ │ ├── train.tables.json
│ ├── val
│ │ ├── val.db
│ │ ├── val.json
│ │ ├── val.tables.json
│ ├── test
│ │ ├── test.db
│ │ ├── test.json
│ │ ├── test.tables.json
│ ├── char_embedding

and then

mkdir ~/nl2sql
cd ~/nl2sql/
git clone

cp -r ~/data_nl2sql/* ~/nl2sql/nl2sql_baseline/data/
cd ~/nl2sql/nl2sql_baseline/

sh ./ 0 128

while the first parameter 0 means gpu number, the second parameter means batch size.

Start to evaluate

To evaluate on val.json or test.json, make sure trained model is ready, then run

cd ~/nl2sql/nl2sql_baseline/
sh ./ 0 pred_example

while the first parameter 0 means gpu number, the second parameter means the output path of prediction.

Experiment result

We have run experiments several times, achiving avegrage 27.5% logic form accuracy on the val dataset, with 128 batch size.

Experiment analysis

We found the main challenges of this datasets containing poor condition value prediction, select column and condition column not mentioned in NL question, inconsistent condition relationship representation between NL question and SQL, etc. All these challenges could not be solved by existing baseline and SOTA models.

Correspondingly, this baseline model achieves only 77% accuracy on condition column and 62% accuracy on condition value respectively even on the training set, and the overall logic form is only around 50% as well, indicating these problems are challenging for contestants to solve.

Related resources:

Semantic Parsing with Syntax- and Table-Aware SQL Generation

You can’t perform that action at this time.