跳转到主要内容
一个托管的 PostgreSQL 实例:使用客户端证书的 TLS 连接、属于你自己的数据库和角色、随时可启用的常用扩展,以及用于定时任务的 pg_cron。所有引擎共有的信息(限制、snapshot、Insights)请参阅数据库概览。

连接

从控制台中该数据库的页面复制连接 URL。它的形式如下,其中 squarecloud 用户和 squarecloud 数据库已为你创建好:
除了密码之外,PostgreSQL 还要求 SSL/TLS 和客户端证书。在 连接 → SSL/TLS 证书 中下载 .pem,并让客户端指向它:
Go 客户端在使用此证书时会拒绝 sslmode=verify-full(x509: certificate relies on legacy Common Name field):该证书只在 Common Name 中写明主机名,而 Go 已不再检查这一字段。请使用 sslmode=verify-ca,它仍会校验证书。
ORM 和其他客户端(Prisma、Drizzle、JDBC、图形界面工具)的配置请参阅数据库连接错误。

连接数

每个数据库最多接受 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。
没有其他可用的扩展,也无法按需添加。例如,PostGIS 不可用。

使用 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。

常见错误

联系我们

如果你仍然遇到技术问题,我们的专业支持团队可以为你提供帮助。联系我们,我们很乐意协助你解决任何问题,支持质量正是开发者给予 Square Cloud 4.9/5 评分(共 402 条评价)(Google 与 Trustpilot)的重要原因之一。