Python传递字符串参数过滤数据库行返回空DataFrame的问题

你碰到的空DataFrame问题很明确——你的SQL语句里并没有真正使用函数参数machineid的值，而是把字符串'machineid'当成了查询条件，数据库自然找不到匹配的记录，所以返回空结果。

问题代码的核心错误 #

看你这段代码：

def summaryTable(machineid):
    df=pd.read_sql(""" SELECT fld_ATM FROM [003_tbl_ATM_Tables] WHERE (LINK <> 1) AND (fld_ATM =('machineid')) ; """,connection)
    connection.close()
    return df

这里的('machineid')是一个硬编码的字符串常量，不是引用函数传入的machineid变量。数据库会去查找fld_ATM等于字符串"machineid"的记录，而不是你传入的实际机器ID，所以返回空。

正确的解决方法（推荐参数化查询） #

为了安全且正确地传递参数，强烈推荐使用pandas的参数化查询功能，它能避免SQL注入风险，还能自动处理数据类型转义：

def summaryTable(machineid):
    # 定义带占位符的SQL查询语句
    query = """
        SELECT fld_ATM 
        FROM [003_tbl_ATM_Tables] 
        WHERE (LINK <> 1) AND (fld_ATM = %s)
    """
    # 通过params参数传递变量值
    df = pd.read_sql(query, connection, params=[machineid])
    connection.close()
    return df

如果你的数据库（比如SQL Server）习惯用命名占位符，也可以用字典传递参数：

def summaryTable(machineid):
    query = """
        SELECT fld_ATM 
        FROM [003_tbl_ATM_Tables] 
        WHERE (LINK <> 1) AND (fld_ATM = :machine_id)
    """
    df = pd.read_sql(query, connection, params={"machine_id": machineid})
    connection.close()
    return df

不推荐的字符串格式化方式（仅作参考） #

如果你只是测试场景，也可以用字符串格式化传递参数，但这种方式存在SQL注入风险，不建议在生产环境使用：

def summaryTable(machineid):
    query = f"""
        SELECT fld_ATM 
        FROM [003_tbl_ATM_Tables] 
        WHERE (LINK <> 1) AND (fld_ATM = '{machineid}')
    """
    df = pd.read_sql(query, connection)
    connection.close()
    return df

总结 #

核心就是要让SQL语句使用machineid变量的实际值，而不是把变量名当成字符串常量。参数化查询是最安全可靠的方式，能帮你避免很多潜在问题。

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