SQLite3 可使用 sqlite3 模塊與 Python 進行集成.sqlite3 模塊是由 Gerhard Haring 編寫的.它提供了一個與 PEP 249 描述的 DB-API 2.0 規(guī)范兼容的 SQL 接口.您不必要單獨安裝該模塊,因為 Python 2.5.x 以上版本默認自帶了該模塊.

為了使用 sqlite3 模塊,您首先必須創(chuàng)建一個表示數(shù)據(jù)庫的連接對象,然后您可以有選擇地創(chuàng)建光標對象,這將贊助您執(zhí)行所有的 SQL 語句.

Python sqlite3 模塊 API

以下是重要的 sqlite3 模塊程序,可以滿足您在 Python 程序中使用 SQLite 數(shù)據(jù)庫的需求.如果您必要了解更多細節(jié),請查看 Python sqlite3 模塊的官方文檔.

1)sqlite3.connect(database [,timeout ,other optional arguments])

該 API 打開一個到 SQLite 數(shù)據(jù)庫文件 database 的鏈接.您可以使用 ":memory:" 來在 RAM 中打開一個到 database 的數(shù)據(jù)庫連接,而不是在磁盤上打開.如果數(shù)據(jù)庫成功打開,則返回一個連接對象.

當一個數(shù)據(jù)庫被多個連接拜訪,且其中一個修改了數(shù)據(jù)庫,此時 SQLite 數(shù)據(jù)庫被鎖定,直到事務提交.timeout 參數(shù)表示連接等待鎖定的持續(xù)時間,直到發(fā)生異常斷開連接.timeout 參數(shù)默認是 5.0(5 秒).

如果給定的數(shù)據(jù)庫名稱 filename 不存在,則該調用將創(chuàng)建一個數(shù)據(jù)庫.如果您不想在當前目錄中創(chuàng)建數(shù)據(jù)庫,那么您可以指定帶有路徑的文件名,這樣您就能在任意地方創(chuàng)建數(shù)據(jù)庫.

2)connection.cursor([cursorClass])

該例程創(chuàng)建一個 cursor,將在 Python 數(shù)據(jù)庫編程中用到.該辦法接受一個單一的可選的參數(shù) cursorClass.如果提供了該參數(shù),則它必須是一個擴展自 sqlite3.Cursor 的自定義的 cursor 類.

3)cursor.execute(sql [, optional parameters])

該例程執(zhí)行一個 SQL 語句.該 SQL 語句可以被參數(shù)化(即使用占位符代替 SQL 文本).sqlite3 模塊支持兩種類型的占位符：問號和命名占位符(命名樣式).

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

4)connection.execute(sql [, optional parameters])

該例程是上面執(zhí)行的由光標(cursor)對象提供的辦法的快捷方式,它通過調用光標(cursor)辦法創(chuàng)建了一個中間的光標對象,然后通過給定的參數(shù)調用光標的 execute 辦法.

5)cursor.executemany(sql, seq_of_parameters)

該例程對 seq_of_parameters 中的所有參數(shù)或映射執(zhí)行一個 SQL 命令.

6)connection.executemany(sql[, parameters])

該例程是一個由調用光標(cursor)辦法創(chuàng)建的中間的光標對象的快捷方式,然后通過給定的參數(shù)調用光標的 executemany 辦法.

7)cursor.executescript(sql_script)

該例程一旦接收到腳本,會執(zhí)行多個 SQL 語句.它首先執(zhí)行 COMMIT 語句,然后執(zhí)行作為參數(shù)傳入的 SQL 腳本.所有的 SQL 語句應該用分號(;)分隔.

8)connection.executescript(sql_script)

該例程是一個由調用光標(cursor)辦法創(chuàng)建的中間的光標對象的快捷方式,然后通過給定的參數(shù)調用光標的 executescript 辦法.

9)connection.total_changes()

該例程返回自數(shù)據(jù)庫連接打開以來被修改、插入或刪除的數(shù)據(jù)庫總行數(shù).

10)connection.commit()

該辦法提交當前的事務.如果您未調用該辦法,那么自您上一次調用 commit() 以來所做的任何動作對其他數(shù)據(jù)庫連接來說是不可見的.

11)connection.rollback()

該辦法回滾自上一次調用 commit() 以來對數(shù)據(jù)庫所做的更改.

12)connection.close()

該辦法關閉數(shù)據(jù)庫連接.請注意,這不會自動調用 commit().如果您之前未調用 commit() 辦法,就直接關閉數(shù)據(jù)庫連接,您所做的所有更改將全部丟失!

13)cursor.fetchone()

該辦法獲取查詢結果集中的下一行,返回一個單一的序列,當沒有更多可用的數(shù)據(jù)時,則返回 None.

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

該辦法獲取查詢結果集中的下一行組,返回一個列表.當沒有更多的可用的行時,則返回一個空的列表.該辦法嘗試獲取由 size 參數(shù)指定的盡可能多的行.

15)cursor.fetchall()

該例程獲取查詢結果集中所有(剩余)的行,返回一個列表.當沒有可用的行時,則返回一個空的列表.

連接數(shù)據(jù)庫

下面的 Python 代碼顯示了如何連接到一個現(xiàn)有的數(shù)據(jù)庫.如果數(shù)據(jù)庫不存在,那么它就會被創(chuàng)建,最后將返回一個數(shù)據(jù)庫對象.在這里,您也可以把數(shù)據(jù)庫名稱復制為特定的名稱 :memory:,這樣就會在 RAM 中創(chuàng)建一個數(shù)據(jù)庫.現(xiàn)在,讓我們來運行上面的程序,在當前目錄中創(chuàng)建我們的數(shù)據(jù)庫 test.db.您可以根據(jù)需要改變路徑.保留上面代碼到 sqlite.py 文件中,并按如下所示執(zhí)行.如果數(shù)據(jù)庫成功創(chuàng)建,那么會顯示下面所示的消息：

創(chuàng)建表

下面的 Python 代碼段將用于在先前創(chuàng)建的數(shù)據(jù)庫中創(chuàng)建一個表：

上述程序執(zhí)行時,它會在 test.db 中創(chuàng)建 COMPANY 表,并顯示下面所示的消息：

INSERT 操作

下面的 Python 程序顯示了如安在上面創(chuàng)建的 COMPANY 表中創(chuàng)建記錄：

上述程序執(zhí)行時,它會在 COMPANY 表中創(chuàng)建給定記錄,并會顯示以下兩行：

SELECT 操作

下面的 Python 程序顯示了如何從前面創(chuàng)建的 COMPANY 表中獲取并顯示記錄：

上述程序執(zhí)行時,它會發(fā)生以下結果：

UPDATE 操作

下面的 Python 代碼顯示了如何使用 UPDATE 語句來更新任何記錄,然后從 COMPANY 表中獲取并顯示更新的記錄：

上述程序執(zhí)行時,它會發(fā)生以下結果：

DELETE 操作

下面的 Python 代碼顯示了如何使用 DELETE 語句刪除任何記錄,然后從 COMPANY 表中獲取并顯示剩余的記錄：

上述程序執(zhí)行時,它會發(fā)生以下結果：