灵析表格

Appearance

mysql_Connect_pro函数 ​

函数名：mysql_Connect_pro

函数功能 ​

通过指定连接字符串测试MySQL数据库连接状态，返回服务器版本、当前数据库、连接超时等详细信息，支持设置程序启动自动连接。

参数规范 ​

参数名类型必填示例特殊说明
connectionStringString是"Server=localhost;Database=test;Uid=root;Pwd=123456;"完整的MySQL数据库连接字符串
auto_connectBoolean否false可选参数，默认true，true为启动程序自动连接，false为取消自动连接

使用案例 ​

基础连接测试 ​

问题描述：测试MySQL数据库连接是否正常 公式演示：

excel
=mysql_Connect_pro("Server=localhost;Database=test;Uid=root;Pwd=123456;")

输出效果：

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

关闭自动连接 ​

问题描述：测试数据库连接并关闭程序启动自动连接功能 公式演示：

excel
=mysql_Connect_pro("Server=127.0.0.1;Database=shop;Uid=root;Pwd=root;",false)

输出效果：

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

连接异常测试 ​

问题描述：使用错误密码测试连接，查看异常信息 公式演示：

excel
=mysql_Connect_pro("Server=localhost;Database=test;Uid=root;Pwd=wrong;")

输出效果：

text
MySQL错误 (1045)
Access denied for user 'root'@'localhost'
服务器: localhost

技术说明 ​

连接检测规则 ​

  • 自动解析连接字符串，验证数据库连通性
  • 精准返回服务器版本、数据库名称、连接耗时等核心信息
  • 支持自动连接配置，自动保存/删除连接配置文件
  • 异步执行检测，等待过程中返回Waiting...

异常处理 ​

错误场景返回值
连接字符串为空#N/A
账号/密码错误MySQL错误+异常信息
服务器地址错误MySQL错误+异常信息
数据库不存在MySQL错误+异常信息

注：本函数为免费功能，在WPS 2019+和Excel 365中测试通过