连接
从控制台中该数据库的页面复制连接 URL。它的形式如下,其中squarecloud 用户和 squarecloud 数据库已为你创建好:
ssl-mode=REQUIRED,或者使用 VERIFY_CA 并以 连接 → SSL/TLS 证书 中的 .pem 作为 CA,以同时校验服务器。
服务器只接受 caching_sha2_password 身份验证。缺少这一支持的旧驱动(例如 npm 的 mysql 包)无法登录:在 Node.js 上请使用 mysql2,或使用最新的连接器。
- Node.js
- Python
- mysql CLI
'%'。
ORM 和图形界面工具(Prisma、MySQL Workbench、DBeaver、HeidiSQL)的配置请参阅数据库连接错误。
连接数
每个数据库最多接受 256 个同时连接;超过之后,新连接会失败并提示Too many connections。请在启动时为每个进程创建一个连接池并重复使用,连接池的大小要保证所有应用、worker 和分片加在一起都低于上限。Insights 选项卡会显示是谁占用着这些打开的连接。
你的用户与权限
squarecloud@'%' 用户拥有除管理类权限之外的所有权限,并带有 GRANT OPTION。你可以创建数据库、用户和授权,创建例程、触发器和事件,还可以使用 SET GLOBAL 和 SET PERSIST 修改全局变量。
管理类权限所允许的操作不可用:
- 服务器端文件:
LOAD DATA INFILE和SELECT ... INTO OUTFILE; FLUSH PRIVILEGES,会返回ERROR 1227。它并不需要:GRANT、CREATE USER和ALTER USER会立即生效;SHOW ENGINE INNODB STATUS;- 复制。
导入转储
从其他服务器导出的转储,其视图、例程、触发器和事件上经常带有DEFINER=root@localhost(或其他管理账户)。导入这类转储会失败并提示 ERROR 1227 (42000): Access denied; you need (at least one of) the ... privilege(s)。请在导入前删除这些子句,或将其设置为你自己的用户:
配置
- 没有二进制日志。 复制、变更数据捕获(Debezium 等)和时间点恢复均不可用。
- Buffer pool:
innodb_buffer_pool_size保持 MySQL 默认的 128 MB;它不会随数据库的 RAM 增长。你可以在已分配的 RAM 范围内调高它,同时为连接和服务器本身留出空间(RAM 的一半左右是一个稳妥的起点):从 snapshot 恢复数据库或升级数据库后,持久化的值会丢失:之后请重新设置。 max_allowed_packet为 64 MB,即服务器接受的单条语句或单行的最大大小。- 其余服务器配置在每个数据库上都相同。
慢查询
Insights 选项卡按平均耗时列出语句(任何一次运行达到 100 ms 或以上的语句)。如需原始的慢查询日志,请将其开启:它会以同样的 100 ms 阈值写入mysql.slow_log 表,永不过期并占用数据库的存储,因此用完后请清空它:
Snapshot
MySQL 的 snapshot 包含你的 schema、例程、触发器、事件和用户,在单个事务中导出:对 InnoDB 表是一致的,对 MyISAM 表则不作保证。除了通用情况之外,当你自己的LOCK TABLES 阻塞它超过 5 分钟时,snapshot 也会失败。导出内容是纯 SQL 文本,因此接近 10 GB 存储上限的数据库可能无法放进一个 snapshot。
常见错误
强制停止后,MySQL 会在下次启动时执行崩溃恢复,数据库越大耗时越长:请等待它完成。

