SQLite中的自增关键字：AUTO_INCREMENT、INTEGER PRIMARY KEY与AUTOINCREMENT

1、SQLite不支持关键字AUTO_INCREMENT

1）AUTO_INCREMENT不生效的问题

SQL语句：

CREATE TABLE todo
(
    id INTEGER AUTO_INCREMENT,
    title TEXT,
    PRIMARY KEY (id)
);

问题描述：按照上述SQL语句创建表todo，用INSERT INTO todo (title) VALUES ('xxx')插入记录，但查询该记录后得到的id为NULL（即Python中的None）

实验脚本：

#!/usr/bin/python
# -*- encoding: utf-8 -*-

import sqlite3
con = sqlite3.connect(":memory:")

# 创建表
con.execute("""
CREATE TABLE todo
(
    id INTEGER AUTO_INCREMENT,
    title TEXT,
    PRIMARY KEY (id)
);""")

# 插入记录
con.execute("INSERT INTO todo (title) VALUES ('shopping');")

# 查询记录
for row in con.execute("SELECT * FROM todo"):
    print row

运行结果：

$ python auto_increment_null.py 
(None, u'shopping')

2）AUTO_INCREMENT导致语法错误的问题

SQL语句：

CREATE TABLE todo
(
    id INTEGER PRIMARY KEY AUTO_INCREMENT,
    title TEXT
);

问题描述：根据SQL的语法，按理说上述SQL语句应该与1）中的SQL语句等效，但运行结果却是语法错误

实验脚本：

#!/usr/bin/python
# -*- encoding: utf-8 -*-

import sqlite3
con = sqlite3.connect(":memory:")

# 创建表
con.execute("""
CREATE TABLE todo
(
    id INTEGER PRIMARY KEY AUTO_INCREMENT,
    title TEXT
);""")

# 插入记录
con.execute("INSERT INTO todo (title) VALUES ('shopping');")

# 查询记录
for row in con.execute("SELECT * FROM todo"):
    print row

运行结果：

$ python auto_increment_error.py 
Traceback (most recent call last):
  File "auto_increment_error.py", line 14, in <module>
    );""")
sqlite3.OperationalError: near "AUTO_INCREMENT": syntax error

上述两个问题在《AUTO_INCREMENT in sqlite problem with python》中得到了解释和解答：在SQLite中，自增字段需要使用关键字INTEGER PRIMARY KEY。

2、自增关键字INTEGER PRIMARY KEY

SQL语句：

CREATE TABLE todo
(
    id INTEGER PRIMARY KEY,
    title TEXT
);

或者

CREATE TABLE todo
(
    id INTEGER PRIMARY KEY NOT NULL,
    title TEXT
);

按照上述SQL语句创建表todo，用INSERT INTO todo (title) VALUES ('xxx')或者INSERT INTO todo (id, title) VALUES (NULL, 'xxx')插入记录，查询记录后得到的id为自增的整型值。

实验脚本：

#!/usr/bin/python
# -*- encoding: utf-8 -*-

import sqlite3
con = sqlite3.connect(":memory:")

# 创建表
con.execute("""
CREATE TABLE todo
(
    id INTEGER PRIMARY KEY,
    title TEXT
);""")

# 创建表：效果相同
'''
con.execute("""
CREATE TABLE todo
(
    id INTEGER PRIMARY KEY NOT NULL,
    title TEXT
);""")
'''

# 插入记录：shopping
con.execute("INSERT INTO todo (title) VALUES ('shopping');")

# 插入记录：working
con.execute("INSERT INTO todo (id, title) VALUES (NULL, 'working');")

# 查询记录
for row in con.execute("SELECT * FROM todo"):
    print row

运行结果：

$ python integer_primary_key_ok.py 
(1, u'shopping')
(2, u'working')

注意：之前看《No autoincrement for Integer Primary key in sqlite3》中有提到“SQLite的自增字段定义为NULL或NOT NULL是有区别的”，根据上面的实验，这个问题好像已经不存在了。

3、关键字AUTOINCREMENT与内部表sqlite_sequence

SQLite中，在INTEGER PRIMARY KEY的基础上添加AUTOINCREMENT后（即INTEGER PRIMARY KEY AUTOINCREMENT），可以在表的整个生命周期内保证“自增字段”的唯一性（create keys that are unique over the lifetime of the table）。

SQLite内部用一个叫作sqlite_sequence的表来保存所有表的自增字段的取值基准（the largest ROWID），如果清空sqlite_sequence的记录，可以实现将所有表的自增字段的取值归零的效果（这种行为具有破坏性，请谨慎使用）。

关于这一主题，更详细的介绍可以参考《How do I create an AUTOINCREMENT field》和《SQLite Autoincrement》

实验脚本：

#!/usr/bin/python
# -*- encoding: utf-8 -*-

import sqlite3
con = sqlite3.connect(":memory:")

def new_and_show(tbl_name):
    """插入并显示记录"""
    # 插入记录到表
    con.execute("INSERT INTO " + tbl_name + " (title) VALUES ('shopping');")
    # 查询表记录
    for row in con.execute("SELECT * FROM " + tbl_name):
        print row

def clr(tbl_name):
    """清除表记录"""
    con.execute("DELETE FROM " + tbl_name)

print "--表todo--"
# 1. 创建表
con.execute("""
CREATE TABLE todo
(
    id INTEGER PRIMARY KEY,
    title TEXT
);""")
# 2. 插入并显示记录
new_and_show("todo")
# 3. 清除表记录
clr("todo")
# 4. 插入并显示记录
new_and_show("todo")
# 5. 清除表记录
clr("todo")
# 6. 插入并显示记录
new_and_show("todo")


print "--表todo_auto--"
# 1. 创建表
con.execute("""
CREATE TABLE todo_auto
(
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    title TEXT
);""")
# 2. 插入并显示记录
new_and_show("todo_auto")
# 3. 清除表记录
clr("todo_auto")
# 4. 插入并显示记录
new_and_show("todo_auto")

# 将所有表的自增列都归零
#clr("sqlite_sequence")

# 5. 清除表记录
clr("todo_auto")
# 6. 插入并显示记录
new_and_show("todo_auto")

运行结果：

$ python autoincrement_diff.py 
--表todo--
(1, u'shopping')
(1, u'shopping')
(1, u'shopping')
--表todo_auto--
(1, u'shopping')
(2, u'shopping')
(3, u'shopping')

如果去掉clr("sqlite_sequence")这一行的注释，则运行结果会变成：

$ python autoincrement_diff.py 
--表todo--
(1, u'shopping')
(1, u'shopping')
(1, u'shopping')
--表todo_auto--
(1, u'shopping')
(2, u'shopping')
(1, u'shopping')    ## 由于clr("sqlite_sequence")将表todo_auto的自增字段的取值归零，因此这一行又变成了1

另外，SQLite不支持SQL标准语句“TRUNCATE TABLE tbl_name”，只能使用“DELETE FROM tbl_name”来删除表记录，具体可以参考《SQLite清空表并将自增列归零》 。