Python argparse构建动态SQL时如何传递日期范围参数适配BETWEEN子句
适配日期范围查询的调整方案
一、argparse 参数定义调整
调整时要完全向后兼容原有脚本的调用习惯,不破坏老用户的使用流程:
- 保留原有
--date、--Name、--country参数,其中--date继续支持单日期等值查询场景,另外两个参数的逻辑完全不变 - 新增两个独立的可选参数
--start-date、--end-date,专门承接日期范围查询的传参 - 增加参数合法性校验:如果用户只传了
--start-date或--end-date中的一个,直接抛出参数错误提示,避免生成逻辑有问题的SQL
参考参数定义的代码实现:
import argparse parser = argparse.ArgumentParser(description="动态生成SQL查询脚本") # 原有保留参数 parser.add_argument("--date", help="单日期等值查询,例如 --date=20240101") parser.add_argument("--Name", help="按名称等值筛选") parser.add_argument("--country", help="按国家等值筛选") # 新增范围查询参数 parser.add_argument("--start-date", help="范围查询起始日期,需和--end-date搭配使用") parser.add_argument("--end-date", help="范围查询结束日期,需和--start-date搭配使用") args = parser.parse_args() # 参数校验:两个范围参数必须成对出现 if bool(args.start_date) ^ bool(args.end_date): parser.error("--start-date 和 --end-date 必须同时传入,无法仅传单个范围参数")
二、SQL 拼接逻辑调整
原有逻辑是遍历所有非空的等值参数,按字段名=%s格式拼接条件,现在只需要把日期类条件的分支单独处理,其余逻辑完全复用:
- 初始化两个独立的存储结构:一个存SQL条件片段,一个存对应占位符的参数值,全程不直接把用户输入拼进SQL字符串,保留参数化查询的防注入能力
- 优先判断日期范围场景:如果用户同时传入了
--start-date和--end-date,就往条件列表追加date BETWEEN %s AND %s片段,按顺序把起始日期、结束日期加入参数列表,此时原有--date单值参数自动忽略,避免条件冲突 - 如果用户没有传完整的范围参数,就走原有老逻辑:判断
--date是否非空,非空则追加date = %s等值条件 - 其余
--Name、--country参数按原有逻辑判断非空后追加等值条件,最后用AND把所有条件片段连接成完整WHERE子句
参考拼接逻辑的代码实现:
conditions = [] sql_params = [] # 处理日期类条件 if args.start_date and args.end_date: conditions.append("date BETWEEN %s AND %s") sql_params.extend([args.start_date, args.end_date]) # 没有完整范围参数时,走原有单值等值逻辑 elif args.date: conditions.append("date = %s") sql_params.append(args.date) # 其余等值参数逻辑完全保留 if args.Name: conditions.append("Name = %s") sql_params.append(args.Name) if args.country: conditions.append("country = %s") sql_params.append(args.country) # 拼接最终SQL base_sql = "SELECT * FROM TABLE" if conditions: full_sql = f"{base_sql} WHERE {' AND '.join(conditions)}" else: full_sql = base_sql # 后续执行逻辑完全不变,直接调用cursor.execute(full_sql, sql_params)即可
实际调用效果参考
- 老版本原有调用方式:
script.py --date=20240101 --Name=张三
生成SQL:SELECT * FROM TABLE WHERE date = %s AND Name = %s,和原有行为完全一致 - 新增范围查询调用方式:
script.py --start-date=20240101 --end-date=20240131 --Name=张三
生成SQL:SELECT * FROM TABLE WHERE date BETWEEN %s AND %s AND Name = %s,完全匹配需求
注意事项
- 保留参数化查询的模式,不要把用户传入的日期值直接拼接到SQL字符串中,防止SQL注入风险
- BETWEEN 后的参数顺序严格按照「起始日期、结束日期」排列,顺序颠倒会导致查询结果不符合预期
- 如果不想新增独立参数,也可以把原有
--date参数调整为支持传2个值的模式,但这种方式没有明确的参数语义,容易让用户传参顺序搞混,维护成本更高,不推荐
内容的提问来源于stack exchange,提问作者Flora8832
相关产品推荐
相关产品推荐

