将元组字典插入PostgreSQL表时的NameError问题求助

你遇到的NameError完全是因为错误使用了eval(k)导致的——eval会把字典的键（比如字符串'replicate_group_id'）当成变量名去查找，但你根本没有定义过这个变量，自然会报错。而且eval是非常危险的函数，绝对不要用在处理SQL的场景里，很容易引发安全问题。

下面分两种场景给你解决方案：

场景1：确实需要逐个列插入值（每条记录仅填充一个字段） #

如果你的需求就是给每个列单独插入一批值（其他字段留空），那只需要去掉eval，改用字符串格式化拼接列名即可（你的列名都是合法的SQL标识符，不需要额外引号）：

samples_data_dict = {'replicate_group_id': replicate_group_id_values_tuple, 'sample_id': sample_id_values_tuple, 'chip_type': chip_type_values_tuple, 'dataset_id': dataset_id_values_tuple}

for col_name, values_tuple in samples_data_dict.items():
    # 用字符串格式化拼接列名，值用参数化占位符%s
    insert_sql = f"INSERT INTO samples ({col_name}) VALUES (%s);"
    # 循环元组中的每个值，逐个插入
    for val in values_tuple:
        cursor.execute(insert_sql, (val,))

conn.commit()

场景2：插入完整的多条记录（更常见的需求） #

从你的表结构来看，大概率你是想插入包含多个字段的完整记录（比如把replicate_group_id、sample_id等字段的对应值组合成一条记录），那原有的循环逻辑就不合理了。推荐用批量插入的方式，效率更高：

samples_data_dict = {'replicate_group_id': replicate_group_id_values_tuple, 'sample_id': sample_id_values_tuple, 'chip_type': chip_type_values_tuple, 'dataset_id': dataset_id_values_tuple}

# 1. 拼接所有列名
columns = ', '.join(samples_data_dict.keys())
# 2. 生成对应数量的参数占位符（比如4个字段就生成%s, %s, %s, %s）
placeholders = ', '.join(['%s'] * len(samples_data_dict))
# 3. 构造完整的插入语句
insert_sql = f"INSERT INTO samples ({columns}) VALUES ({placeholders});"

# 4. 把各个字段的元组按位置组合成完整记录（zip会将每个元组的第i个元素拼成一条记录）
records = list(zip(*samples_data_dict.values()))

# 5. 用executemany批量插入，比循环execute性能提升很多
cursor.executemany(insert_sql, records)

conn.commit()

举个例子：如果replicate_group_id_values_tuple=(1,2,3)，sample_id_values_tuple=(10,20,30)，zip后会生成(1,10), (2,20), (3,30)，每个元组就是一条完整的记录。

关键注意事项 #

• 永远不要用eval处理SQL相关字符串，既不安全又没必要。
• SQL的列名属于结构部分，不能用参数化（参数化是用来处理值的），所以用字符串格式化拼接即可（确保列名来源是你自己控制的，无注入风险）。
• 批量插入优先用executemany，避免循环调用execute，能大幅提升插入效率。

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