mysql_Connect函数
函数名:mysql_Connect
函数功能
通过填写服务器地址、数据库名、账号密码等基础参数快速连接MySQL数据库,自动生成连接字符串并完成连通性检测,返回连接状态与服务器详情。
参数规范
| 参数名 | 类型 | 必填 | 示例 | 特殊说明 |
|---|---|---|---|---|
server | String | 否 | "127.0.0.1" | 可选参数,默认127.0.0.1,MySQL服务器IP或域名 |
database | String | 是 | "test" | 需填写要连接的数据库名称 |
uid | String | 否 | "root" | 可选参数,默认root,数据库登录用户名 |
pwd | String | 否 | "123456" | 可选参数,默认root,数据库登录密码 |
port | Int | 否 | 3306 | 可选参数,默认3306,MySQL服务端口号 |
connectionTimeout | Int | 否 | 5 | 可选参数,默认3秒,连接超时时间 |
sslMode | String | 否 | "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中测试通过