pg_cron。所有引擎共有的信息(限制、snapshot、Insights)请参阅数据库概览。
连接
从控制台中该数据库的页面复制连接 URL。它的形式如下,其中squarecloud 用户和 squarecloud 数据库已为你创建好:
.pem,并让客户端指向它:
- Node.js
- Python
- psql
Go 客户端在使用此证书时会拒绝
sslmode=verify-full(x509: certificate relies on legacy Common Name field):该证书只在 Common Name 中写明主机名,而 Go 已不再检查这一字段。请使用 sslmode=verify-ca,它仍会校验证书。连接数
每个数据库最多接受 256 个同时连接,其中 253 个可供你的客户端使用。超过之后,新连接会失败并提示remaining connection slots are reserved for roles with the SUPERUSER attribute(或 sorry, too many clients already)。请在启动时为每个进程创建一个连接池并重复使用,连接池的大小要保证所有应用、worker 和分片加在一起都低于上限。每个请求或每次查询都新建连接,会很快耗尽上限。Insights 选项卡会显示是谁占用着这些打开的连接。
你的用户与权限
squarecloud 角色拥有 LOGIN、CREATEDB、CREATEROLE 和 BYPASSRLS,并且是 squarecloud 数据库的所有者。你可以创建数据库、schema、角色和授权,也可以修改普通用户允许修改的设置,作用于单个会话或作为默认值:
ALTER SYSTEM以及仅限超级用户的设置;- 服务器端的
COPY ... TO/FROM 'file'(请改用psql中的\copy,它在你的机器上读写文件); - 不受信任的语言,例如
plpython3u; - 逻辑复制,以及依赖它的变更数据捕获工具。
扩展
已安装:plpgsql,以及 postgres 数据库中的 pg_cron 和 pg_stat_statements。
你可以在任意数据库中使用 CREATE EXTENSION 启用以下扩展,请在要使用它们的数据库中执行:
vector(pgvector)、pg_trgm、pgcrypto、uuid-ossp、citext、hstore、unaccent、ltree、btree_gin、btree_gist、cube、dict_int、fuzzystrmatch、intarray、isn、lo、seg、tablefunc、tcn、tsm_system_rows、tsm_system_time。
使用 pg_cron 运行定时任务
pg_cron 位于 postgres 数据库中。连接到 postgres(同一个 URL,以 /postgres 结尾),然后安排任务在你的数据库中运行。计划时间使用 UTC:
cron.job_run_details 中的运行历史永远不会被自动清理。请安排一个任务来清理你的旧记录:
内存与配置
shared_buffers为数据库 RAM 的 25%(至少 128 MB)。修改 RAM 会重启数据库以使其生效。- 其余部分 PostgreSQL 依赖操作系统的文件缓存,因此控制台中显示的 RAM 会先上升然后保持在高位。这是正常现象,不是内存泄漏。
- 单个查询最多可以写入 1 GB 的临时文件(排序、哈希)。超过后查询会失败并提示
temporary file size exceeds temp_file_limit:请添加索引或分批处理数据。 - 预写日志(write-ahead log)占用数据库存储中的 256 到 512 MB。
- 服务器配置在每个数据库上都相同,无法针对单个数据库修改。
慢查询
耗时 100 ms 或以上的语句会被记录,Insights 选项卡会列出它们及其平均耗时。如需自行分析,请连接到postgres 数据库查询 pg_stat_statements,并对语句使用 EXPLAIN ANALYZE:
Snapshot
PostgreSQL 的 snapshot 包含实例中的所有数据库和角色。除了通用情况之外,当某个数据库设置了ALLOW_CONNECTIONS false,或者你自己的锁(LOCK TABLE、耗时较长的 ALTER TABLE)阻塞它超过 5 分钟时,snapshot 也会失败。导出内容是纯 SQL 文本,因此接近 10 GB 存储上限的数据库可能无法放进一个 snapshot。

