SQLite - Python

  • 简述

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

    SQLite3 可以使用由 Gerhard Haring 编写的 sqlite3 模块与 Python 集成。它提供了一个符合 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 ,other optional arguments])
    此 API 打开与 SQLite 数据库文件的连接。您可以使用 ":memory:" 来打开到驻留在 RAM 中而不是磁盘上的数据库的数据库连接。如果数据库打开成功,它返回一个连接对象。
    当一个数据库被多个连接访问,并且其中一个进程修改了该数据库时,SQLite 数据库将被锁定,直到该事务被提交。timeout 参数指定连接应该等待锁定消失的时间,直到引发异常。timeout 参数的默认值为 5.0(五秒)。
    如果给定的数据库名称不存在,则此调用将创建数据库。如果要在当前目录以外的任何其他位置创建数据库,也可以使用所需路径指定文件名。
    2
    connection.cursor([cursorClass])
    此例程创建一个 cursor它将在您使用 Python 进行数据库编程的整个过程中使用。此方法接受单个可选参数 cursorClass。如果提供,这必须是扩展 sqlite3.Cursor 的自定义游标类。
    3
    cursor.execute(sql [, optional parameters])
    该例程执行 SQL 语句。SQL 语句可以参数化(即占位符而不是 SQL 文字)。sqlite3 模块支持两种占位符:问号和命名占位符(命名样式)。
    For example − cursor.execute("插入人值(?, ?)", (who, age))
    4
    connection.execute(sql [, optional parameters])
    该例程是游标对象提供的上述execute方法的快捷方式,它通过调用游标方法创建一个中间游标对象,然后使用给定的参数调用游标的execute方法。
    5
    cursor.executemany(sql, seq_of_parameters)
    此例程针对在序列 sql 中找到的所有参数序列或映射执行 SQL 命令。
    6
    connection.executemany(sql[, parameters])
    这个例程是一个快捷方式,它通过调用游标方法创建一个中间游标对象,然后使用给定的参数调用 cursor.s executemany 方法。
    7
    cursor.executescript(sql_script)
    该例程一次执行多个以脚本形式提供的 SQL 语句。它首先发出 COMMIT 语句,然后执行它作为参数获取的 SQL 脚本。所有的 SQL 语句都应该用分号 (;) 分隔。
    8
    connection.executescript(sql_script)
    这个例程是一个快捷方式,它通过调用游标方法创建一个中间游标对象,然后使用给定的参数调用游标的 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()
    
    当上面的程序被执行时,它会在你的目录中创建 COMPANY 表 test.db 它将显示以下消息 -
    
    Opened database successfully
    Table created successfully
    
  • 插入操作

    下面的 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
    
  • 选择操作

    以下 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
    
  • 更新操作

    以下 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
    
  • 删除操作

    以下 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