如何在Python中识别SQLite数据库的外键列及关联指向？

刚好处理过类似的需求，给你分享两种实用的方法，都是基于Python自带的sqlite3库，不用额外装第三方工具，直接就能搞定。

方法一：通过PRAGMA指令查询外键信息 #

SQLite提供了PRAGMA foreign_key_list('表名')这个专用指令，能直接返回指定表的所有外键详细信息，包括关联的表和列，这是最可靠的方式。

1. 获取所有表的外键及关联指向 #

下面的函数会遍历数据库中所有用户自定义表（排除SQLite系统表），输出每个表的外键列，以及它们关联的目标表和列：

import sqlite3

def get_all_foreign_keys(db_path):
    # 连接数据库
    conn = sqlite3.connect(db_path)
    cursor = conn.cursor()
    
    # 获取所有非系统表的名称
    cursor.execute("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'")
    tables = [row[0] for row in cursor.fetchall()]
    
    foreign_key_info = {}
    for table in tables:
        # 查询当前表的外键列表
        cursor.execute(f"PRAGMA foreign_key_list('{table}')")
        fk_records = cursor.fetchall()
        
        if fk_records:
            foreign_key_info[table] = []
            # 解析每条外键记录的字段：id, seq, table, from, to, on_update, on_delete, match
            for record in fk_records:
                foreign_key_info[table].append({
                    '外键列': record[3],
                    '关联表': record[2],
                    '关联列': record[4],
                    '更新触发动作': record[5],
                    '删除触发动作': record[6]
                })
    
    conn.close()
    return foreign_key_info

# 使用示例
db_file = 'your_database.db'  # 替换成你的SQLite文件路径
all_fks = get_all_foreign_keys(db_file)
for table, fks in all_fks.items():
    print(f"📋 表 {table} 的外键信息：")
    for fk in fks:
        print(f"  - 列 {fk['外键列']} → 关联到 {fk['关联表']}.{fk['关联列']}")
        if fk['更新触发动作']:
            print(f"    更新时触发：{fk['更新触发动作']}")
        if fk['删除触发动作']:
            print(f"    删除时触发：{fk['删除触发动作']}")
    print("---")

2. 判断指定列是否为外键 #

如果只需要检查某个表的某一列是不是外键，可以写一个更精简的函数：

def is_column_foreign_key(db_path, table_name, column_name):
    conn = sqlite3.connect(db_path)
    cursor = conn.cursor()
    
    # 查询目标表的外键
    cursor.execute(f"PRAGMA foreign_key_list('{table_name}')")
    fk_records = cursor.fetchall()
    
    conn.close()
    # 检查是否有匹配的列名
    return any(record[3] == column_name for record in fk_records)

# 使用示例
if is_column_foreign_key(db_file, 'orders', 'customer_id'):
    print("✅ customer_id 是外键")
else:
    print("❌ customer_id 不是外键")

方法二：用字典形式返回结果（可读性更强） #

如果觉得元组形式的返回结果不够直观，可以设置sqlite3.Row作为行工厂，让查询结果以字典形式返回，字段名对应PRAGMA指令的输出列：

def get_all_foreign_keys_as_dict(db_path):
    conn = sqlite3.connect(db_path)
    # 设置行工厂，让结果返回字典
    conn.row_factory = sqlite3.Row
    cursor = conn.cursor()
    
    cursor.execute("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'")
    tables = [row['name'] for row in cursor.fetchall()]
    
    foreign_key_info = {}
    for table in tables:
        cursor.execute(f"PRAGMA foreign_key_list('{table}')")
        fk_records = cursor.fetchall()
        
        if fk_records:
            foreign_key_info[table] = []
            for record in fk_records:
                foreign_key_info[table].append({
                    '外键列': record['from'],
                    '关联表': record['table'],
                    '关联列': record['to'],
                    '更新触发动作': record['on_update'],
                    '删除触发动作': record['on_delete']
                })
    
    conn.close()
    return foreign_key_info

一些注意事项 #

• SQLite默认是关闭外键约束的，但这不影响外键信息的存储，只要你创建表时定义了外键，PRAGMA foreign_key_list()就能查到这些信息。
• 不要尝试解析sqlite_master表中的sql字段来提取外键——如果表是通过某些工具创建的，或者原始SQL被清空，这个字段可能为空或不完整，远不如PRAGMA指令可靠。
• 如果需要找反向关联（比如哪些表的外键指向当前表的某列），可以遍历所有表的外键信息，然后反向整理数据即可。

内容的提问来源于stack exchange，提问作者user442920