ZetCode

Python sqlite3.sqlite_version 属性

上次修改时间：2025 年 4 月 15 日

本完整指南探讨了 Python 的 sqlite3.sqlite_version 属性，该属性提供底层 SQLite 库的版本。我们将介绍它的用法、重要性以及实际示例。

基本定义

sqlite3.sqlite_version 是一个字符串属性，包含 SQLite 库的运行时版本。它与 Python sqlite3 模块本身的版本不同。

此属性是只读的，无需建立数据库连接即可使用。 它对于检查功能可用性和兼容性非常有用。

基本版本检查

这是使用 sqlite3.sqlite_version 检查 Python 使用的 SQLite 库的最简单方法。

basic_version.py 
import sqlite3

# Print the SQLite library version
print(f"SQLite version: {sqlite3.sqlite_version}")

# Compare with compile-time version
print(f"Compile-time version: {sqlite3.sqlite_version_info}")

此示例显示了如何访问字符串版本和版本信息元组。 该元组使代码中的版本比较更加容易。

该版本遵循 "X.Y.Z" 格式，其中 X 是主版本，Y 是次版本，Z 是补丁级别。 信息元组将这些作为整数包含。

检查功能可用性

您可以使用该版本来检查特定 SQLite 功能是否可用，然后再使用它们。

feature_check.py 
import sqlite3
from packaging import version

def supports_window_functions():
    return version.parse(sqlite3.sqlite_version) >= version.parse("3.25.0")

if supports_window_functions():
    print("Window functions are supported")
else:
    print("Window functions not supported - upgrade SQLite")

此示例检查窗口函数（在 SQLite 3.25.0 中引入）是否可用。 packaging.version 模块有助于进行版本比较。

在编写可能在具有不同 SQLite 版本的不同系统上运行的代码时，请始终验证功能支持。

带版本检查的数据库连接

您可以在执行数据库操作之前验证 SQLite 版本是否符合您的要求。

connection_version.py 
import sqlite3

MIN_VERSION = (3, 35, 0)  # Requires SQLite 3.35.0 or higher

if sqlite3.sqlite_version_info < MIN_VERSION:
    raise RuntimeError(
        f"SQLite {'.'.join(map(str, MIN_VERSION))} or higher required"
    )

with sqlite3.connect(":memory:") as conn:
    cursor = conn.cursor()
    cursor.execute("CREATE TABLE test (id INTEGER PRIMARY KEY)")
    print("Database operations successful")

此示例在继续执行数据库操作之前强制执行最低 SQLite 版本。 版本检查发生在建立任何连接之前。

当您的应用程序依赖于某些版本中引入的特定 SQLite 功能时，此模式很有用。

特定于版本的 SQL 执行

您可以编写 SQL 以适应可用的 SQLite 版本。

version_specific_sql.py 
import sqlite3

with sqlite3.connect(":memory:") as conn:
    cursor = conn.cursor()
    
    # Use STRICT tables if available (SQLite 3.37.0+)
    if sqlite3.sqlite_version_info >= (3, 37, 0):
        cursor.execute("CREATE TABLE data (id INTEGER, name TEXT) STRICT")
    else:
        cursor.execute("CREATE TABLE data (id INTEGER, name TEXT)")
    
    print("Table created with appropriate schema")

此示例在可用时以 STRICT 模式创建一个表，否则回退到常规表。 STRICT 表提供更好的类型检查。

使您的 SQL 适应可用的版本有助于在使用较新功能的同时保持兼容性。

与 sqlite_version 比较

sqlite3.sqlite_version 与 sqlite3.version 和 sqlite3.version_info 不同。 以下是如何比较它们。

version_comparison.py 
import sqlite3

print(f"SQLite library version (runtime): {sqlite3.sqlite_version}")
print(f"SQLite library version info: {sqlite3.sqlite_version_info}")
print(f"sqlite3 module version: {sqlite3.version}")
print(f"sqlite3 module version info: {sqlite3.version_info}")

with sqlite3.connect(":memory:") as conn:
    cursor = conn.cursor()
    cursor.execute("SELECT sqlite_version()")
    print(f"SQLite version from database: {cursor.fetchone()[0]}")

此示例显示了所有与版本相关的属性以及数据库查询。 sqlite_version 函数返回与属性相同的内容。

模块版本是指 Python sqlite3 接口，而 sqlite_version 是指底层 C 库。

记录 SQLite 版本

出于调试和支持目的，最好记录 SQLite 版本。

version_logging.py 
import sqlite3
import logging

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

def init_database():
    logger.info(f"Using SQLite version {sqlite3.sqlite_version}")
    
    with sqlite3.connect("app.db") as conn:
        cursor = conn.cursor()
        # Database initialization code here
        logger.info("Database initialized successfully")

if __name__ == "__main__":
    init_database()

此示例演示了在应用程序启动期间记录 SQLite 版本。 此信息对于解决兼容性问题很有价值。

在日志中包含 SQLite 版本有助于用户报告问题，因为不同版本的行为可能不同。

最佳实践

资料来源

作者

我叫 Jan Bodnar，是一位充满热情的程序员，拥有丰富的编程经验。 自 2007 年以来，我一直在撰写编程文章。 迄今为止，我已经撰写了 1,400 多篇文章和 8 本电子书。 我拥有超过十年的编程教学经验。

列出所有 Python 教程。