mysql_Query函数
函数名:mysql_Query
函数功能
执行MySQL数据库SELECT查询语句并返回查询结果,支持自定义标题显示、数据库连接配置,可直接在表格中获取MySQL数据。
参数规范
| 参数名 | 类型 | 必填 | 示例 | 特殊说明 |
|---|---|---|---|---|
sqlQuery | String | 是 | "SELECT * FROM user" | 支持标准的Sql语句 |
showHeaders | Boolean | 否 | false | 可选参数,默认true,true显示字段名称作为标题 |
connectionString | String | 否 | "Server=localhost;Database=test;Uid=root;Pwd=123456;" | 可选参数,为空时使用默认连接配置 |
使用案例
基础数据查询
问题描述:查询MySQL数据库中用户表全部数据 公式演示:
excel
=mysql_Query("SELECT id,name,age FROM user")输出效果:
text
id name age
1 张三 25
2 李四 30隐藏标题查询
问题描述:执行查询且不返回字段标题行 公式演示:
excel
=mysql_Query("SELECT * FROM product",false)输出效果:
text
1001 笔记本 5999
1002 手机 2999自定义数据库连接
问题描述:连接指定MySQL数据库执行查询语句 公式演示:
excel
=mysql_Query("SELECT * FROM orders",true,"Server=127.0.0.1;Database=shop;Uid=root;Pwd=root;")输出效果:
text
order_id user_id price
1 1 199
2 2 299技术说明
执行规则
- 仅支持SELECT查询语句,不支持增删改操作
- 支持异步执行,等待期间返回Waiting...
- 可使用默认连接字符串或自定义连接字符串
异常处理
| 错误场景 | 返回值 |
|---|---|
| SQL语句为空 | #N/A |
| 无执行权限 | 权限错误提示 |
| 数据库连接失败 | 异常:连接失败信息 |
| SQL语法错误 | 异常:语法错误信息 |
扩展应用
结合筛选函数使用
excel
=FILTER(mysql_Query("SELECT * FROM user"),mysql_Query("SELECT age FROM user")>25)批量查询数据
excel
=mysql_Query("SELECT * FROM sales WHERE date='"&A1&"'")注:本函数为Pro会员专属功能,在WPS 2019+和Excel 365中测试通过