Become a Gold Sponsor

Drizzle <> Xata

This guide assumes familiarity with:

根据他们的 官方网站,Xata 是一个专注于可靠性、可扩展性和开发者体验的 Postgres 数据平台。Xata Postgres 服务目前处于测试阶段,请查看 Xata 文档 了解如何在您的帐户中启用它。

Drizzle ORM 本质上支持 drizzle-orm/xata 包的 xata 驱动和 postgrespg 驱动,用于访问 Xata Postgres 数据库。

第一步 - 安装包

npm
yarn
pnpm
bun
npm i drizzle-orm @xata.io/client
npm i -D drizzle-kit

您可以通过 HTTP 客户端或 TCP 客户端将 Drizzle 与 Xata 一起使用。HTTP 客户端不会建立到 Xata 服务器的持久连接,而 TCP 客户端会,并可以用于更高请求数的更好性能。HTTP 客户端通常建议来自无服务器环境,例如 Cloudflare Workers 或 Vercel Edge Functions。TCP 客户端通常用于长时间运行的服务器,例如 Express.js 或 Fastify。

以下示例使用 Xata 生成的客户端,您可以通过运行 xata init CLI 命令获得。

HTTP
TCP
TCP (池)
import { drizzle } from 'drizzle-orm/xata-http';
import { getXataClient } from './xata'; // 生成的客户端

const xata = getXataClient();
const db = drizzle(xata);

const result = await db.select().from(...);

如果您不想使用生成的 Xata 客户端,也可以使用 postgrespg 驱动,这种情况下,您可以从 Xata 数据库的设置页面复制连接字符串。有关更多信息,请查看我们的 PostgreSQL 连接部分

有关使用 Drizzle 与 Xata 的更多详细信息,请参阅官方 Xata 文档

下一步是什么?