mysql_Connect_pro函数

函数名：mysql_Connect_pro / mysql_Connect_pro

功能描述

通过指定连接字符串测试并建立 MySQL 数据库连接，返回服务器版本、当前数据库、连接超时、实际连接耗时、SSL 模式等详细信息，并支持设置程序启动时自动连接。

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

语法

=mysql_Connect_pro(连接字符串, [启动程序自动连接,默认:自动])

参数

参数名	类型	必填	默认值	说明
连接字符串	String	是	-	完整的 MySQL 数据库连接字符串
启动程序自动连接,默认:自动	Boolean	否	true	为 true 时将连接字符串写入 mysql_info 文件，程序启动自动连接；为 false 时删除该文件，取消自动连接

返回值

Object[,] - 二维数组（单列多行）。连接成功时返回 6 行信息（连接状态、服务器版本、当前数据库、连接超时、实际连接时间、SSL 模式）；连接失败时返回错误信息数组。

使用示例

基础连接测试

公式：

=mysql_Connect_pro("Server=127.0.0.1;Database=test;Uid=root;Pwd=123456;ConnectionTimeout=10;SslMode=None;")

结果：

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

关闭自动连接

公式：

=mysql_Connect_pro("Server=127.0.0.1;Database=shop;Uid=root;Pwd=root;SslMode=None;",FALSE)

结果：

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

账号密码错误

公式：

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

结果：

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

技术说明

• 将传入的连接字符串保存到全局变量 connStr，供其他 MySQL 函数（连接字符串为空时）回退使用。
• 经 build_connectstring 处理：未设置连接超时时默认 3 秒，未设置 SSL 模式时默认 None，并关闭连接池（Pooling=false）。
• 连接成功后立即关闭并释放连接，仅返回连通性信息，不保持长连接。
• 启动程序自动连接 为 true 时写入 mysql_info 文件，为 false 时删除该文件。
• 本函数为同步执行，无 "Waiting..." 中间态。

错误处理

错误场景	返回值
MySQL 异常（账号密码/服务器/数据库错误）	三行数组：MySQL错误 (编号)、异常信息、服务器: <地址>
其他异常	两行数组：连接错误、异常信息