Node.js 在连接到 PostgreSQL 时提供了很大的灵活性,但它也使整个过程变得简单。
大多数现实世界的应用程序以一种或另一种方式与数据库交互。数据库使持久化、分析数据和与数据交互变得容易。
大多数编程语言都支持将应用程序连接到 PostgreSQL 等数据库。本文了解如何使用 node-postgres 模块将 Node 应用程序连接到 PostgreSQL。
如何开始
要开始连接到本地数据库,您需要安装 PostgreSQL 服务器。
PostgresSQL因其灵活性和强大功能而成为最常见的关系数据库系统之一。如果您的项目很复杂,或者您正在寻找包含开源精神的解决方案,您可能会考虑使用它作为 MySQL 的替代品。
创建 Node 应用程序
第一步是创建一个 Node 应用程序,您将使用它来测试连接代码。在您的首选文件夹中,创建一个新文件夹。
mkdir postgres-node
导航到您创建的文件夹并初始化 npm。
cd postgres-node
npm init -y
此命令应生成一个package.json文件。
接下来,创建一个新文件并将其命名为index.js。您将在此文件中将 Node 连接到 PostgreSQL。
使用 node-postgres 模块
node-postgres模块是一个 npm 包,它允许您连接到 PostgreSQL 数据库并与之交互。使用 node-postgres 模块可以使用两个选项将 Node 与 PostgreSQL 连接:单个客户端或连接池。那么你应该使用什么?
如果一次只需要一个静态连接,请使用单个客户端。但是,如果您需要使用并发和多个请求,请使用连接池。
安装 node-postgres
在终端中运行以下命令以安装 node-postgres。
npm install pg
如果您使用 node >= 14.x,则需要稍后安装 pg@8.2.xo。您可以通过像这样将其添加到安装命令后缀来指定版本号。
npm install pg=8.7.3
连接到 PostgreSQL
node-postgres 模块需要以下值才能连接到 PostgreSQL 数据库:
- PGUSER – 要连接的 PostgreSQL 用户名。
- PGHOST – 要连接的服务器主机的名称。
- PGPASSWORD – PostgreSQL 服务器的密码。
- PGDATABASE – 您要连接的数据库的名称。
- PGPORT – 在服务器主机上连接的端口号。
创建一个 .env 文件并添加这些变量,替换数据库中的相应值:
PGUSER=<PGUSER>
PGHOST=<PGHOST>
PGPASSWORD=<PGPASSWORD>
PGDATABASE=<PGDATABASE>
PGPORT=<PGPORT>
安装 dotenv 包以访问 .env 文件:
npm install dotenv
在index.js中,导入并配置 dotenv:
const dotenv = require("dotenv")
dotenv.config()
使用单个客户端连接到 PostgreSQL 数据库
下面的代码展示了如何使用单个客户端将 Node 连接到 PostgreSQL 服务器:
const { Client } = require("pg")
const dotenv = require("dotenv")
dotenv.config()
const connectDb = async () => {
try {
const client = new Client({
user: process.env.PGUSER,
host: process.env.PGHOST,
database: process.env.PGDATABASE,
password: process.env.PGPASSWORD,
port: process.env.PGPORT
})
await client.connect()
const res = await client.query('SELECT * FROM some_table')
console.log(res)
await client.end()
} catch (error) {
console.log(error)
}
}
connectDb()
使用连接池
如前所述,连接池允许您向服务器发出多个连接请求:
const { Pool } = require("pg");
const dotenv = require("dotenv");
dotenv.config();
const connectDb = async () => {
try {
const pool = new Pool({
user: process.env.PGUSER,
host: process.env.PGHOST,
database: process.env.PGDATABASE,
password: process.env.PGPASSWORD,
port: process.env.PGPORT,
});
await pool.connect()
const res = await pool.query('SELECT * FROM clients')
console.log(res)
await pool.end()
} catch (error) {
console.log(error)
}
}
connectDb()
上面的示例让您可以通过 .env 文件控制数据库配置。但是,您也可以使用标准环境变量提供这些配置值。这种方法使您可以在启动时轻松更改配置。
考虑以下连接代码:
const connectDb = async () => {
try {
const pool = new Pool();
const res = await pool.query('SELECT * FROM clients')
console.log(res)
await pool.end()
} catch (error) {
console.log(error)
}
}
在这个程序中,初始化 Pool 时,您没有将连接对象作为参数传递。相反,您必须在调用程序时指定连接详细信息,如下所示:
PGUSER=<PGUSER> \
PGHOST=<PGHOST> \
PGPASSWORD=<PGPASSWORD> \
PGDATABASE=<PGDATABASE> \
PGPORT=<PGPORT> \
node index.js
像这样将 Node 连接到 PostgreSQL 可以让您编写更可重用的程序。
使用 PostgreSQL 做更多事情
要创建与数据库交互的应用程序,您必须先将其连接到数据库。在本文中,您学习了如何使用 node-Postgres 模块将 Node 连接到 PostgreSQL 数据库。
除了 PostgreSQL,您还可以在应用程序中使用其他数据库管理系统,例如 MySQL。您选择的数据库工具应该与您的数据需求最兼容。