连接 PlanetScale Postgres 适用于 Excel、Google Sheets、AI 和 REST

这是 PlanetScale Postgres，不是 PlanetScale MySQL。

PlanetScale 曾是 Vitess 公司的一部分，所以有必要坦诚地说明这张卡连接的是哪款产品。

• 此连接器适用于 PlanetScale Postgres。 — 托管在 .horizon.psdb.cloud 上的 Postgres 服务。它使用 Postgres 网络协议，代理通过 Npgsql 连接到它。
• 它不适用于 Vitess 支持的 MySQL 服务。没有针对该服务的预设，而且 PlanetScale 提供的 MySQL 连接字符串也不适用于这张网卡。
• 连接以 PostgreSQL 格式保存，并保留 PlanetScale 作为连接标识。实际上并没有名为 PlanetScale 的连接类型。 — 这也意味着，您之前与 .horizon.psdb.cloud 主机建立的普通 Postgres 连接将立即识别出品牌标识。
• 下游的一切都是普通的 Postgres：模式、类型，以及作为跨源引用的默认模式的 public。

PSBouncer 是默认程序，端口号决定程序的运行方式。

PlanetScale 的池化器运行在与直接端点相同的主机名上，只是端口不同。网卡默认会将您连接到池化后的端点，因为 PlanetScale 会将您指向那里。

• Direct 端口为 5432。PSBouncer PlanetScale 的交易池使用同一主机上的 6432 端口。除此之外，它们之间没有任何区别。
• 在 6432 端口，代理会关闭预编译语句，并且停止在会话关闭时重置会话。事务池可能会在语句之间提供不同的后端，而假定后端服务不同的驱动程序可能会以看似随机的方式失败。
• 触发此问题的是端口，而不是下拉菜单。下拉菜单的存在是为了让显卡能够阻止两种设置不一致的情况发生：选择错误的端口组连接，或者直接连接到 6432 端口。它会在保存之前提示你，而不是在第一次出现异常错误之后。
• 无需记住单独的池化主机名，也无需第二套凭据。只需更改端口，整个交换机就切换完毕了。

用户名里有个点，这很重要。

四个字段中有两个很容易出错，所以这张卡片会检查这两个字段。

• PlanetScale 的用户名格式为 postgres.<数据库 ID>。如果粘贴时省略了点号，系统会阻止您操作，因为点号后面的部分用于选择数据库。
• 密码开头或结尾带有空格会被标记出来。这是剪贴板操作导致的，会被当作普通的身份验证错误处理，从而误导用户去查找错误的问题。
• 任何不是 Postgres 连接字符串的内容都会被拒绝，并显示一条消息，指出正确的连接字符串在哪里，而不是被部分解析到错误的字段中。
• 粘贴的字符串不会被存储。它只在填写表单时读取一次，然后就被丢弃，因此密码只存在于一个地方，而不是两个地方。

-- 普通 Postgres，只读，通过 PSBouncer 或直接 SELECT c.name, COUNT(o.id) AS orders, SUM(o.amount) AS revenue FROM public.customers AS c JOIN public.orders AS o ON o.customer_id = c.id WHERE o.placed_at >= now() - interval '30 days' GROUP BY c.name ORDER BY revenue DESC;