mysql_select函数

函数名：mysql_select / mysql_select

功能描述

可视化执行 MySQL 数据库 SELECT 查询，无需编写完整 SQL 语句，通过表名、字段、条件、排序参数快速查询数据，支持自定义标题行显示。

会员等级：🟢 免费版（Free）

语法

=mysql_select(表名, [字段列表], [条件], [排序], [显示标题], [连接字符串])

参数

参数名	类型	必填	默认值	说明
表名	String	是	-	要查询的表名称
字段列表	String	否	"*"	要查询的字段，用逗号分隔，* 表示所有字段
条件	String	否	""	WHERE 条件，如 age > 18 AND name = 'John'
排序	String	否	""	ORDER BY 排序，如 id DESC, name ASC
显示标题	Boolean	否	true	是否显示字段名称作为标题行
连接字符串	String	否	""	MySQL 连接字符串；为空时使用已保存的默认连接

返回值

Object[,] - 二维数组。包含字段标题行（显示标题 为 true 时）与数据行；查询无结果时返回空数组。查询过程中单元格暂显 "Waiting..."。

使用示例

基础全表查询

公式：

=mysql_select("user")

结果：

id    name    age
1     张三    20
2     李四    25

条件筛选 + 排序（隐藏标题）

公式：

=mysql_select("user","id,name","age>18","id DESC",FALSE)

结果：

2     李四
1     张三

自定义连接查询

公式：

=mysql_select("product","*","price>100","price ASC",TRUE,"Server=127.0.0.1;Database=shop;Uid=root;Pwd=root;SslMode=None;")

结果：

pro_id    pro_name    price
1001      笔记本       199
1002      手机         299

技术说明

• 自动根据参数拼接 SELECT <字段> FROM <表名> [WHERE <条件>] [ORDER BY <排序>] 语句。
• 通过 ExcelAsyncUtil.Run 异步执行，处理期间返回 "Waiting..."。
• 连接字符串 为空时回退到全局默认连接 connStr；经 build_connectstring 处理默认超时与 SSL 模式。
• 结果中 DBNull 值自动转换为 null；无数据时返回 object[0,0] 空数组。
• 注意：条件 与 排序 参数会直接拼接到 SQL 中，请勿拼接不受信任的输入以防 SQL 注入。

错误处理

错误场景	返回值
表不存在	查询错误: <异常信息>
条件/排序语法错误	查询错误: <异常信息>
连接字符串无效/连接失败	查询错误: <异常信息>
查询无结果	空数组