SQLite - Python



在本章中,您将学习如何在 Python 程序中使用 SQLite。

安装

SQLite3 可以使用 sqlite3 模块与 Python 集成,该模块由 Gerhard Haring 编写。它提供了一个符合 PEP 249 中描述的 DB-API 2.0 规范的 SQL 接口。您无需单独安装此模块,因为它默认随 Python 2.5.x 及更高版本一起提供。

要使用 sqlite3 模块,您必须首先创建一个表示数据库的连接对象,然后可以选择创建一个游标对象,这将帮助您执行所有 SQL 语句。

Python sqlite3 模块 API

以下是重要的 sqlite3 模块例程,可以满足您从 Python 程序中使用 SQLite 数据库的要求。如果您正在寻找更复杂的应用程序,那么您可以查看 Python sqlite3 模块的官方文档。

序号 API & 描述
1

sqlite3.connect(database [,timeout ,其他可选参数])

此 API 打开到 SQLite 数据库文件的连接。您可以使用 ":memory:" 打开到驻留在 RAM 而不是磁盘上的数据库的数据库连接。如果数据库成功打开,则返回一个连接对象。

当多个连接访问数据库,并且其中一个进程修改了数据库时,SQLite 数据库将被锁定,直到该事务提交。timeout 参数指定连接应等待锁消失多长时间,然后再引发异常。timeout 参数的默认值为 5.0(五秒)。

如果给定的数据库名称不存在,则此调用将创建数据库。如果您希望在当前目录之外的任何其他位置创建数据库,则也可以指定带有所需路径的文件名。

2

connection.cursor([cursorClass])

此例程创建一个游标,它将在您使用 Python 进行数据库编程的整个过程中使用。此方法接受一个可选参数 cursorClass。如果提供,则它必须是一个扩展 sqlite3.Cursor 的自定义游标类。

3

cursor.execute(sql [, 可选参数])

此例程执行 SQL 语句。SQL 语句可以是参数化的(即使用占位符而不是 SQL 字面量)。sqlite3 模块支持两种占位符:问号和命名占位符(命名样式)。

例如 − cursor.execute("insert into people values (?, ?)", (who, age))

4

connection.execute(sql [, 可选参数])

此例程是游标对象提供的上述 execute 方法的快捷方式,它通过调用 cursor 方法创建一个中间游标对象,然后使用给定的参数调用游标的 execute 方法。

5

cursor.executemany(sql, seq_of_parameters)

此例程对序列 sql 中找到的所有参数序列或映射执行 SQL 命令。

6

connection.executemany(sql[, parameters])

此例程是一个快捷方式,它通过调用 cursor 方法创建一个中间游标对象,然后使用给定的参数调用 cursor.s executemany 方法。

7

cursor.executescript(sql_script)

此例程一次执行多个 SQL 语句,这些语句以脚本的形式提供。它首先发出 COMMIT 语句,然后执行它作为参数获取的 SQL 脚本。所有 SQL 语句都应以分号 (;) 分隔。

8

connection.executescript(sql_script)

此例程是一个快捷方式,它通过调用 cursor 方法创建一个中间游标对象,然后使用给定的参数调用游标的 executescript 方法。

9

connection.total_changes()

此例程返回自数据库连接打开以来已修改、插入或删除的数据库行的总数。

10

connection.commit()

此方法提交当前事务。如果您不调用此方法,则自上次调用 commit() 以来所做的任何操作都无法从其他数据库连接中看到。

11

connection.rollback()

此方法回滚自上次调用 commit() 以来对数据库所做的任何更改。

12

connection.close()

此方法关闭数据库连接。请注意,这不会自动调用 commit()。如果您在不首先调用 commit() 的情况下关闭数据库连接,则您的更改将丢失!

13

cursor.fetchone()

此方法获取查询结果集的下一行,返回单个序列,或者当没有更多数据可用时返回 None。

14

cursor.fetchmany([size = cursor.arraysize])

此例程获取查询结果的下一组行,返回一个列表。当没有更多行可用时,将返回一个空列表。该方法尝试获取与 size 参数指示的相同数量的行。

15

cursor.fetchall()

此例程获取查询结果的所有(剩余)行,返回一个列表。当没有行可用时,将返回一个空列表。

连接到数据库

以下 Python 代码显示了如何连接到现有数据库。如果数据库不存在,则将创建它,最后将返回一个数据库对象。

#!/usr/bin/python

import sqlite3

conn = sqlite3.connect('test.db')

print "Opened database successfully";

在这里,您还可以将数据库名称作为特殊名称:memory:提供,以在 RAM 中创建数据库。现在,让我们运行上述程序以在当前目录中创建我们的数据库test.db。您可以根据需要更改路径。将上述代码保存在 sqlite.py 文件中并按如下所示执行它。如果数据库成功创建,则它将显示以下消息。

$chmod +x sqlite.py
$./sqlite.py
Open database successfully

创建表

以下 Python 程序将用于在先前创建的数据库中创建表。

#!/usr/bin/python

import sqlite3

conn = sqlite3.connect('test.db')
print "Opened database successfully";

conn.execute('''CREATE TABLE COMPANY
         (ID INT PRIMARY KEY     NOT NULL,
         NAME           TEXT    NOT NULL,
         AGE            INT     NOT NULL,
         ADDRESS        CHAR(50),
         SALARY         REAL);''')
print "Table created successfully";

conn.close()

执行上述程序时,它将在您的test.db中创建 COMPANY 表,并显示以下消息:

Opened database successfully
Table created successfully

INSERT 操作

以下 Python 程序显示了如何在上面示例中创建的 COMPANY 表中创建记录。

#!/usr/bin/python

import sqlite3

conn = sqlite3.connect('test.db')
print "Opened database successfully";

conn.execute("INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY) \
      VALUES (1, 'Paul', 32, 'California', 20000.00 )");

conn.execute("INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY) \
      VALUES (2, 'Allen', 25, 'Texas', 15000.00 )");

conn.execute("INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY) \
      VALUES (3, 'Teddy', 23, 'Norway', 20000.00 )");

conn.execute("INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY) \
      VALUES (4, 'Mark', 25, 'Rich-Mond ', 65000.00 )");

conn.commit()
print "Records created successfully";
conn.close()

执行上述程序时,它将在 COMPANY 表中创建给定的记录,并显示以下两行:

Opened database successfully
Records created successfully

SELECT 操作

以下 Python 程序显示了如何从上面示例中创建的 COMPANY 表中获取和显示记录。

#!/usr/bin/python

import sqlite3

conn = sqlite3.connect('test.db')
print "Opened database successfully";

cursor = conn.execute("SELECT id, name, address, salary from COMPANY")
for row in cursor:
   print "ID = ", row[0]
   print "NAME = ", row[1]
   print "ADDRESS = ", row[2]
   print "SALARY = ", row[3], "\n"

print "Operation done successfully";
conn.close()

执行上述程序时,将产生以下结果。

Opened database successfully
ID = 1
NAME = Paul
ADDRESS = California
SALARY = 20000.0

ID = 2
NAME = Allen
ADDRESS = Texas
SALARY = 15000.0

ID = 3
NAME = Teddy
ADDRESS = Norway
SALARY = 20000.0

ID = 4
NAME = Mark
ADDRESS = Rich-Mond
SALARY = 65000.0

Operation done successfully

UPDATE 操作

以下 Python 代码显示了如何使用 UPDATE 语句更新任何记录,然后从 COMPANY 表中获取和显示更新后的记录。

#!/usr/bin/python

import sqlite3

conn = sqlite3.connect('test.db')
print "Opened database successfully";

conn.execute("UPDATE COMPANY set SALARY = 25000.00 where ID = 1")
conn.commit()
print "Total number of rows updated :", conn.total_changes

cursor = conn.execute("SELECT id, name, address, salary from COMPANY")
for row in cursor:
   print "ID = ", row[0]
   print "NAME = ", row[1]
   print "ADDRESS = ", row[2]
   print "SALARY = ", row[3], "\n"

print "Operation done successfully";
conn.close()

执行上述程序时,将产生以下结果。

Opened database successfully
Total number of rows updated : 1
ID = 1
NAME = Paul
ADDRESS = California
SALARY = 25000.0

ID = 2
NAME = Allen
ADDRESS = Texas
SALARY = 15000.0

ID = 3
NAME = Teddy
ADDRESS = Norway
SALARY = 20000.0

ID = 4
NAME = Mark
ADDRESS = Rich-Mond
SALARY = 65000.0

Operation done successfully

DELETE 操作

以下 Python 代码显示了如何使用 DELETE 语句删除任何记录,然后从 COMPANY 表中获取和显示剩余的记录。

#!/usr/bin/python

import sqlite3

conn = sqlite3.connect('test.db')
print "Opened database successfully";

conn.execute("DELETE from COMPANY where ID = 2;")
conn.commit()
print "Total number of rows deleted :", conn.total_changes

cursor = conn.execute("SELECT id, name, address, salary from COMPANY")
for row in cursor:
   print "ID = ", row[0]
   print "NAME = ", row[1]
   print "ADDRESS = ", row[2]
   print "SALARY = ", row[3], "\n"

print "Operation done successfully";
conn.close()

执行上述程序时,将产生以下结果。

Opened database successfully
Total number of rows deleted : 1
ID = 1
NAME = Paul
ADDRESS = California
SALARY = 20000.0

ID = 3
NAME = Teddy
ADDRESS = Norway
SALARY = 20000.0

ID = 4
NAME = Mark
ADDRESS = Rich-Mond
SALARY = 65000.0

Operation done successfully
广告