如何将Python列表以Variant类型插入Snowflake单个字段？

问题根源 #

你的代码存在两个关键错误：

1. 参数传递时，(python_list) 并非元组结构，Python会直接展开列表，导致Snowflake接收到5个独立值，误判为要插入5列。必须写成 (python_list,) 明确这是包含单个列表元素的元组。
2. 重复调用了无参数的 cursor.execute(insert_query)，属于冗余操作，会导致执行错误。

Snowflake的Python连接器原生支持将Python列表映射为Variant类型，无需转成字符串。

修正后的代码 #

python_list = [1, 2, 3, 4, 5]
cursor = conn.cursor()

insert_query = """
    INSERT INTO table (python_list)
    VALUES (%s)
"""
# 用带逗号的元组传递参数，确保列表作为单个字段值提交
cursor.execute(insert_query, (python_list,))
conn.commit()  # 务必提交事务，否则数据不会持久化到数据库
cursor.close()

验证存储结果 #

插入完成后，可通过以下SQL验证数据类型：

SELECT python_list, TYPEOF(python_list) FROM table;

返回结果中类型应为ARRAY，说明列表已正确以Variant类型存储，而非字符串。

额外提示 #

• 使用snowflake-connector-python时，Python的列表、字典等复杂类型会自动映射为Snowflake的Variant类型，无需手动转换。
• 始终使用参数绑定（%s占位符+参数元组）的方式传递SQL参数，避免用f-string拼接，防止SQL注入风险。

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