mysql_Query函数
函数名：mysql_Query / mysql_Query
函数功能
执行MySQL查询语句并返回结果集，支持自定义连接字符串和标题显示控制 支持执行任意sql语句，返回查询结果集。
参数规范
| 参数名 | 类型 | 必填 | 示例 | 特殊说明 |
|---|---|---|---|---|
sqlQuery | String | 是 | "SELECT * FROM users" | 有效的SELECT查询语句 |
showHeaders | Boolean | 否 | TRUE | 默认为TRUE，显示字段标题行 1：显示标题行 0：不显示标题行 |
connectionString | String | 否 | "server=localhost;user=root;" | 数据库连接字符串，可选 |
使用案例
基础数据查询
问题描述：查询用户表数据并显示标题
公式演示：
excel
=mysql_Query("SELECT id, name FROM users WHERE age > 18", TRUE, "server=localhost;database=test;")输出效果：返回包含字段标题和查询结果的二维数组
无标题数据获取
问题描述：仅获取数据内容不显示字段名
公式演示：
excel
=mysql_Query("SELECT COUNT(*) FROM orders", FALSE)输出效果：返回单行单列的计数结果数组
技术说明
执行机制
- 采用异步执行模式避免界面卡顿
- 自动处理连接池管理
- 支持参数化查询防止SQL注入
异常处理
| 错误场景 | 返回值 |
|---|---|
| SQL语法错误 | 异常信息字符串 |
| 连接失败 | 连接异常提示 |
| 空查询语句 | #N/A |
扩展应用
动态数据报表
excel
=mysql_Query("SELECT * FROM sales WHERE date='" & TEXT(TODAY(),"yyyy-mm-dd") & "'", TRUE)参数化条件查询
excel
=mysql_Query("SELECT * FROM products WHERE category='电子' AND price>1000")注：本函数需要MySQL数据库连接支持，在WPS 2019+和Excel 365中测试通过