连接 萨塔 适用于 Excel、Google Sheets、AI 和 REST

数据库字段是路由，而不是名称。

在其他所有 Postgres 连接器中，“数据库”字段都包含一个标识符，而 Query Streams 会在传输过程中将其转换为小写，因为 Postgres 对未加引号的名称的处理方式就是如此。但在 Xata 上，这样做是错误的，因此该规则在 Xata 上被禁用。

• 该值是一个数据库:分支对。 — mydb:main — Xata 将其解析为路由。它不是 Postgres 标识符，也不符合标识符折叠规则。
• 一个名为 Feature-X 的分支保留了它的大写 F 和大写 X。如果将其转换为小写 feature-x，则无法解析，这就是为什么 Xata 是唯一一个免于规范化的连接器。
• 去掉冒号，连接仍然有效。 ——它落到了默认分支上。这张卡片会指出这一点，而不是默默地让它过去，因为当你想选择功能分支却落到了主分支上时，会根据错误的数据生成看起来正确的数字。
• 除此之外，不会检查名称的其他任何信息。查询流会按您输入的方式传递路由信息，并由 Xata 决定是否解析。

代理对 Xata 主机执行的操作

有两个行为与 .sql.xata.sh 后缀相关联，但这两个行为都不是您可以配置的。

• TLS 是必需的，而非可选的。无论是否勾选“使用 SSL”选项，所有 .sql.xata.sh 主机都会默认启用加密连接，因此即使剪贴板中的字符串丢失了 SSL 模式，传输过程中仍然会以加密形式进行。
• 连接已加密，但证书链未经验证。这就是它的真实情况，Query Streams 识别的每个托管服务提供商都是如此。
• 路径中没有连接池。某些无服务器 Postgres 服务会在前端放置一个事务模式连接池，并且需要预先配置语句才能处理；Xata 不需要，因此代理直接连接并跳过所有这些步骤。
• 连接保存为 PostgreSQL 类型，徽章保留为 Xata。实际上并不存在名为 Xata 的连接类型。 — 这也意味着，您之前与同一主机建立的普通 Postgres 连接将立即识别出 Xata 品牌。

粘贴而不是重新输入。

需要输入四条凭证，其中两条容易混淆，一条又长又容易输错。这张卡片的设计理念是粘贴字符串，然后自动识别其余部分。

• 控制台中显示的 postgresql:// URI 格式正确。libpq host= 关键字格式也能解析。
• 任何不是 Postgres 连接字符串的内容都会被拒绝，并显示一条消息告诉你正确的连接字符串在哪里，而不是被部分解析到错误的字段中。
• API 密钥开头或结尾带有空格会被标记。这是剪贴板残留信息，会被当作普通的身份验证错误处理，导致用户误判问题所在。
• 工作区 ID 填写在用户名栏，API 密钥填写在密码栏。卡片上这样标注是为了避免直接写“用户名”和“密码”让用户自行猜测。

-- 普通的 Postgres 只读查询，针对您指定的任何分支 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;