mysql_select函数
函数名:mysql_select / mysql_select
函数功能
执行MySQL SELECT查询并返回结果集,支持字段选择、条件过滤、排序和标题显示控制
参数规范
| 参数名 | 类型 | 必填 | 示例 | 特殊说明 |
|---|---|---|---|---|
tableName | String | 是 | "users" | 要查询的表名称 |
fields | String | 否 | "id,name,age" | 查询字段,默认为* |
whereCondition | String | 否 | "age > 18" | WHERE条件语句 |
orderBy | String | 否 | "id DESC" | ORDER BY排序语句 |
showHeaders | Boolean | 否 | TRUE | 是否显示字段标题,默认为TRUE |
connectionString | String | 否 | "server=localhost;" | MySQL连接字符串 |
使用案例
基础数据查询
问题描述:查询用户表所有数据
公式演示:
excel
=mysql_select("users")输出效果:返回用户表所有字段和数据的二维数组
条件筛选查询
问题描述:查询年龄大于18的用户姓名
公式演示:
excel
=mysql_select("users", "name,age", "age > 18", "age DESC", TRUE)输出效果:返回符合条件的用户名和年龄,按年龄降序排列
技术说明
SQL构建机制
- 自动构建完整的SELECT语句
- 支持WHERE条件参数化防止SQL注入
- 灵活的组合查询条件
结果处理
- 自动处理NULL值转换为空值
- 支持动态字段列表解析
- 返回标准的Excel二维数组格式
异常处理
| 错误场景 | 返回值 |
|---|---|
| 表不存在 | 查询错误信息 |
| 语法错误 | SQL语法错误详情 |
| 连接失败 | 连接异常提示 |
扩展应用
动态报表生成
excel
=mysql_select("sales", "*", "date='2023-12-01'", "amount DESC")数据导出分析
excel
=mysql_select("products", "name,price,category", "price>100", "category, price")注:本函数需要MySQL数据库连接支持,在WPS 2019+和Excel 365中测试通过