Postgres.js

连接 Postgres.js #

🌐 Connecting with Postgres.js

Postgres.js 是一个适用于 Node.js 和 Deno 的全功能 Postgres 客户端。

Install

安装 Postgres.js 和相关依赖。

1
npm i postgres

Connect

创建一个包含连接详情的 db.js 文件。

要获取你的连接详情，请前往连接面板。如果你使用的是暂时连接的平台（例如无服务器函数），请选择事务池；如果你有长期连接，则请选择会话池。复制 URI 并将其保存为环境变量 DATABASE_URL。

postgres.js 默认会对查询进行流水线处理。结合共享连接池事务模式，这可能会导致查询挂起或返回不匹配的行。postgres.js 没有直接关闭流水线处理的可行选项：max_pipeline: 0 反而会破坏 sql.begin() 的事务，这是一个已知的上游 bug。

想了解更多关于使用 postgres.js 的流水线信息，请联系支持。

1
// db.js
2
import postgres from 'postgres'
3
4
const connectionString = process.env.DATABASE_URL
5
const sql = postgres(connectionString, { prepare: false })
6
7
export default sql

Execute commands

使用这个连接来执行命令。

1
import sql from './db.js'
2
3
async function getUsersOver(age) {
4
  const users = await sql`
5
    select name, age
6
    from users
7
    where age > ${ age }
8
  `
9
  // users = Result [{ name: "Walter", age: 80 }, { name: 'Murray', age: 68 }, ...]
10
  return users
11
}