Skip to content

mysql_Connect函数

函数名:mysql_Connect

函数功能

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

参数规范

参数名类型必填示例特殊说明
serverString"127.0.0.1"可选参数,默认127.0.0.1,MySQL服务器IP或域名
databaseString"test"需填写要连接的数据库名称
uidString"root"可选参数,默认root,数据库登录用户名
pwdString"123456"可选参数,默认root,数据库登录密码
portInt3306可选参数,默认3306,MySQL服务端口号
connectionTimeoutInt5可选参数,默认3秒,连接超时时间
sslModeString"Preferred"可选参数,默认None,SSL连接模式

使用案例

快速本地数据库连接

问题描述:使用默认参数快速连接本地MySQL数据库 公式演示

excel
=mysql_Connect(,"test")

输出效果

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

自定义远程数据库连接

问题描述:连接远程MySQL数据库,自定义端口与超时时间 公式演示

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

输出效果

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

错误参数连接测试

问题描述:使用错误数据库名测试连接,查看异常结果 公式演示

excel
=mysql_Connect(,"test123")

输出效果

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

技术说明

连接规则

  • 无需手动编写连接字符串,自动拼接标准MySQL连接参数
  • 内置默认参数,简化本地数据库连接操作
  • 底层调用mysql_Connect_pro实现连接检测与状态返回
  • 异步执行连接测试,等待过程中返回Waiting...

异常处理

错误场景返回值
数据库名为空#N/A
服务器地址不可达MySQL错误+异常信息
用户名/密码错误MySQL错误+异常信息
端口号错误MySQL错误+异常信息

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