灵析表格

Appearance

mysql_Connect_pro函数 ​

函数名：mysql_Connect_pro / mysql_Connect_pro

函数功能 ​

建立MySQL数据库连接并返回连接状态信息，支持自动保存连接配置供程序启动时使用

参数规范 ​

参数名类型必填示例特殊说明
connectionStringString是"server=localhost;user=root;password=123"MySQL连接字符串
auto_connectBoolean否TRUE默认为TRUE，启动时自动连接

连接字符串格式： Server=127.0.0.1;Port=3306;Database=dbname;Uid=root;Pwd=mypass;ConnectionTimeout=3;SslMode=None;

使用案例 ​

数据库连接测试 ​

问题描述：测试MySQL服务器连接状态
公式演示：

excel
=mysql_Connect_pro("server=localhost;database=test;user=root;password=123456;")

输出效果：

text
连接成功! ✓
服务器版本: 8.0.33
当前数据库: test
连接超时: 30秒
实际连接时间: 15ms
SSL模式: Preferred

禁用自动连接 ​

问题描述：临时连接但不保存配置
公式演示：

excel
=mysql_Connect_pro("server=192.168.1.100;user=admin;", FALSE)

输出效果：返回连接成功信息但不保存连接配置,进本次生效，重启Excel重启后失效

技术说明 ​

连接机制 ​

  • 使用MySqlConnectionStringBuilder解析连接字符串
  • 支持SSL加密连接模式
  • 自动测量实际连接耗时

配置管理 ​

  • TRUE：将连接字符串保存到"mysql_info"文件
  • FALSE：删除已保存的连接配置
  • 支持程序启动时自动重连

异常处理 ​

错误场景返回值
连接超时超时错误信息
认证失败认证错误详情
服务器不可达网络连接错误

扩展应用 ​

多环境连接管理 ​

excel
=mysql_Connect_pro("server=dev_db;user=dev;")  // 开发环境
=mysql_Connect_pro("server=prod_db;user=prod;")  // 生产环境

连接性能监控 ​

excel
=INDEX(mysql_Connect_pro(conn_str), 5, 1)  // 提取连接时间指标

注：本函数需要MySQL数据库连接支持，在WPS 2019+和Excel 365中测试通过