mysql_Connect函数

函数名：mysql_Connect / mysql_Connect

功能描述

通过填写服务器地址、数据库名、账号密码等基础参数快速连接 MySQL 数据库，自动拼接标准连接字符串并完成连通性检测，返回连接状态与服务器详情。

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

语法

=mysql_Connect([服务器地址], [数据库名], [用户名], [密码], [端口号], [连接超时], [SSL模式])

参数

参数名	类型	必填	默认值	说明
服务器地址	String	否	"127.0.0.1"	MySQL 服务器 IP 或域名
数据库名	String	否	""	要连接的数据库名称，为空时不指定数据库
用户名	String	否	"root"	数据库登录用户名
密码	String	否	"root"	数据库登录密码
端口号	Int	否	3306	MySQL 服务端口
连接超时	Int	否	3	连接超时时间（秒）
SSL模式	String	否	"None"	SSL 连接模式

返回值

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

使用示例

快速本地数据库连接

公式：

=mysql_Connect(,"test")

结果：

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

自定义远程数据库连接

公式：

=mysql_Connect("192.168.1.100","shop","admin","123456",3307,5,"None")

结果：

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

数据库不存在

公式：

=mysql_Connect(,"test123")

结果：

MySQL错误 (1049)
Unknown database 'test123'
服务器: 127.0.0.1

技术说明

• 内部将各参数拼接为 Server=...;Database=...;Uid=...;Pwd=...;Port=...;ConnectionTimeout=...;SslMode=... 形式的连接字符串，再委托 mysql_Connect_pro 执行（启动程序自动连接 默认为 true）。
• 拼接后的连接字符串会保存到全局 connStr，供其他 MySQL 函数回退使用。
• 经 build_connectstring 处理默认超时与 SSL 模式，并关闭连接池（Pooling=false）。
• 本函数为同步执行，无 "Waiting..." 中间态。

错误处理

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