Python SQLite3数据库操作保姆级指南:零基础入门数据库管理

Python SQLite3 保姆级教程:从零开始学数据库操作

本文适合纯新手!无需任何数据库基础,跟着步骤操作即可掌握 SQLite3 的核心用法。
目标:让你像用记事本一样轻松操作数据库!


目录

  1. 什么是 SQLite3?
  2. 环境准备
  3. 连接数据库
  4. 创建表
  5. 增删改查(CRUD)
  6. 事务与错误处理
  7. 高级技巧
  8. 常见问题
  9. 总结

1. 什么是 SQLite3?

SQLite3 是一个轻量级的 嵌入式数据库,无需安装独立服务,所有数据存储在一个文件中。

  • 无需配置:像操作普通文件一样使用。
  • 跨平台:数据库文件可在 Windows/macOS/Linux 共享。
  • 适合小型项目:APP 配置、本地缓存、小型网站等。

  • 2. 环境准备

    2.1 确认 Python 环境

    确保已安装 Python(建议 3.6+)。打开终端输入以下命令:

    python --version
    

    若显示版本号(如 Python 3.8.5)则正常。若报错,需先 安装 Python。

    2.2 导入 SQLite3 模块

    无需额外安装!Python 自带 sqlite3 库,直接在代码中导入:

    import sqlite3
    

    3. 连接数据库

    3.1 连接到磁盘数据库(持久化)

    # 连接到当前目录下的 test.db 文件(不存在则自动创建)
    conn = sqlite3.connect('test.db')
    
  • 文件路径规则
  • 'test.db':当前目录下的 test.db 文件。
  • '/home/user/data.db':绝对路径指定位置。
  • 注意:关闭程序后文件依然存在,下次可重新连接。
  • 3.2 连接到内存数据库(临时使用)

    conn = sqlite3.connect(':memory:')  # 程序关闭后数据消失
    

    3.3 创建游标(操作数据库的“手”)

    cursor = conn.cursor()  # 所有 SQL 操作通过游标执行
    

    4. 创建表

    4.1 基本语法

    # 创建 users 表(如果不存在)
    cursor.execute('''
        CREATE TABLE IF NOT EXISTS users (
            id INTEGER PRIMARY KEY AUTOINCREMENT,  # 自增主键
            name TEXT NOT NULL,                    # 文本类型,不能为空
            age INTEGER,                           # 整数类型
            email TEXT UNIQUE                      # 唯一约束(邮箱不可重复)
        )
    ''')
    conn.commit()  # 提交事务(创建表需要提交)
    

    4.2 字段类型

    类型 说明
    INTEGER 整数(如 1, -5, 100)
    TEXT 字符串(如 “Hello”)
    REAL 浮点数(如 3.14)
    BLOB 二进制数据(如图片)

    4.3 验证表是否创建成功

    # 查询数据库中所有表名
    cursor.execute("SELECT name FROM sqlite_master WHERE type='table'")
    print(cursor.fetchall())  # 输出:[('users',)]
    

    5. 增删改查(CRUD)

    5.1 插入数据(Create)

    插入单条数据
    # 使用 ? 占位符避免 SQL 注入
    cursor.execute('''
        INSERT INTO users (name, age, email)
        VALUES (?, ?, ?)
    ''', ('Alice', 30, 'alice@example.com'))
    conn.commit()  # 提交!
    
    批量插入数据
    users = [
        ('Bob', 25, 'bob@example.com'),
        ('Charlie', 35, 'charlie@example.com')
    ]
    cursor.executemany('''
        INSERT INTO users (name, age, email) VALUES (?, ?, ?)
    ''', users)
    conn.commit()
    

    5.2 查询数据(Read)

    查询所有记录
    cursor.execute('SELECT * FROM users')
    rows = cursor.fetchall()  # 获取全部结果
    for row in rows:
        print(row)  # 输出:(1, 'Alice', 30, 'alice@example.com')
    
    条件查询
    # 查找年龄大于 28 的用户
    cursor.execute('SELECT * FROM users WHERE age > ?', (28,))
    results = cursor.fetchall()
    for row in results:
        print(f"ID: {row[0]}, 姓名: {row[1]}, 年龄: {row[2]}")
    
    查询单条记录
    cursor.execute('SELECT * FROM users WHERE id = ?', (1,))
    user = cursor.fetchone()  # 只获取第一条
    print(user)  # 输出:(1, 'Alice', 30, 'alice@example.com')
    

    5.3 更新数据(Update)

    # 将 Alice 的邮箱更新为 new_email@example.com
    cursor.execute('''
        UPDATE users
        SET email = ?
        WHERE name = ?
    ''', ('new_email@example.com', 'Alice'))
    conn.commit()
    

    5.4 删除数据(Delete)

    # 删除 ID 为 2 的用户
    cursor.execute('DELETE FROM users WHERE id = ?', (2,))
    conn.commit()
    

    6. 事务与错误处理

    6.1 什么是事务?

  • 事务:一组原子性的操作,要么全部成功,要么全部失败。
  • 示例:转账操作(A 扣款,B 加款必须同时成功)。
  • 6.2 手动提交与回滚

    try:
        cursor.execute("INSERT INTO users (name) VALUES ('David')")
        cursor.execute("INSERT INTO users (name) VALUES ('Eve')")
        conn.commit()  # 成功则提交
    except sqlite3.Error as e:
        print("出错啦:", e)
        conn.rollback()  # 失败则回滚(撤销所有操作)
    

    6.3 自动提交(推荐)

    使用 with 上下文管理器:

    with sqlite3.connect('test.db') as conn:
        cursor = conn.cursor()
        cursor.execute("INSERT INTO users (name) VALUES ('Frank')")
        # 无需 commit,退出 with 块时自动提交
    

    7. 高级技巧

    7.1 以字典形式返回结果

    默认返回元组,可通过 row_factory 改为字典:

    def dict_factory(cursor, row):
        return {col[0]: row[idx] for idx, col in enumerate(cursor.description)}
    
    conn.row_factory = dict_factory
    cursor = conn.cursor()
    cursor.execute('SELECT * FROM users WHERE id = 1')
    print(cursor.fetchone())  # 输出:{'id': 1, 'name': 'Alice', ...}
    

    7.2 使用 SQLite 浏览器查看数据

    推荐工具:DB Browser for SQLite

  • 可视化查看表结构、数据。
  • 直接执行 SQL 语句。

  • 8. 常见问题

    Q1:代码运行后找不到数据库文件?

  • 检查当前目录:在代码中添加:
    import os
    print(os.getcwd())  # 查看文件实际保存路径
    
  • 使用绝对路径:如 sqlite3.connect('/User/name/data.db')
  • Q2:插入数据后查询不到?

  • 忘记提交事务:确保执行 conn.commit()
  • 查询条件错误:检查 WHERE 子句是否拼写正确。
  • Q3:如何备份数据库?

    直接复制 .db 文件即可!SQLite 数据库是单一文件。


    9. 总结

    通过本教程,你已经学会了:

    1. 连接数据库(文件 vs 内存)
    2. 创建表(字段类型与约束)
    3. 增删改查(参数化查询防注入)
    4. 事务管理(提交与回滚)
    5. 高级技巧(字典结果、可视化工具)

    下一步建议

  • 尝试为本地的通讯录、笔记应用添加数据库支持。
  • 学习更复杂的 SQL 语法(如 JOIN 查询)。
  • 遇到问题? 随时查阅本文代码示例,或使用 SQLite 浏览器调试!

    作者:老哥不老

    物联沃分享整理
    物联沃-IOTWORD物联网 » Python SQLite3数据库操作保姆级指南:零基础入门数据库管理

    发表回复