Drizzle <> Turso

本指南假定您熟悉

Drizzle 数据库连接基础知识
Turso 数据库 - 官网
LibSQL 驱动 - 官网和 GitHub

根据官网，Turso 是一个由 libSQL 支持的边缘 SQLite 数据库服务。

Drizzle ORM 原生支持 libSQL 驱动，我们支持 SQL 方言以及特定方言的驱动和语法，并镜像了大多数流行的类似 SQLite 的 all、get、values 和 run 查询方法语法。

步骤 1 - 安装包

npm

yarn

pnpm

bun

npm i drizzle-orm @libsql/client
npm i -D drizzle-kit

yarn add drizzle-orm @libsql/client
yarn add -D drizzle-kit

pnpm add drizzle-orm @libsql/client
pnpm add -D drizzle-kit

bun add drizzle-orm @libsql/client
bun add -D drizzle-kit

第 2 步 - 初始化驱动

Drizzle 原生支持所有 @libsql/client 驱动变体


`@libsql/client`	默认为 `node` 导入，如果为打包器设置了 `target` 或 `platform`（例如 `esbuild --platform=browser`），则自动更改为 `web`
`@libsql/client/node`	`node` 兼容模块，支持 `:memory:`、`file`、`wss`、`http` 和 `turso` 连接协议
`@libsql/client/web`	用于 `next`、`nuxt`、`astro` 等全栈 Web 框架的模块
`@libsql/client/http`	用于 `http` 和 `https` 连接协议的模块
`@libsql/client/ws`	用于 `ws` 和 `wss` 连接协议的模块
`@libsql/client/sqlite3`	用于 `:memory:` 和 `file` 连接协议的模块
`@libsql/client-wasm`	用于 WASM 的独立实验包

默认

node

web

http

WebSocket

wasm

import { drizzle } from 'drizzle-orm/libsql';

const db = drizzle({ connection: {
  url: process.env.DATABASE_URL, 
  authToken: process.env.DATABASE_AUTH_TOKEN 
}});

import { drizzle } from 'drizzle-orm/libsql/node';

const db = drizzle({ connection: {
  url: process.env.DATABASE_URL, 
  authToken: process.env.DATABASE_AUTH_TOKEN 
}});

import { drizzle } from 'drizzle-orm/libsql/web';

const db = drizzle({ connection: {
  url: process.env.DATABASE_URL, 
  authToken: process.env.DATABASE_AUTH_TOKEN 
}});

import { drizzle } from 'drizzle-orm/libsql/http';

const db = drizzle({ connection: {
  url: process.env.DATABASE_URL, 
  authToken: process.env.DATABASE_AUTH_TOKEN 
}});

import { drizzle } from 'drizzle-orm/libsql/ws';

const db = drizzle({ connection: {
  url: process.env.DATABASE_URL, 
  authToken: process.env.DATABASE_AUTH_TOKEN 
}});

import { drizzle } from 'drizzle-orm/libsql/wasm';

const db = drizzle({ connection: {
  url: process.env.DATABASE_URL, 
  authToken: process.env.DATABASE_AUTH_TOKEN 
}});

如果您需要提供现有驱动程序

默认

web

import { drizzle } from 'drizzle-orm/libsql';
import { createClient } from '@libsql/client';

const client = createClient({ 
  url: process.env.DATABASE_URL,
  authToken: process.env.DATABASE_AUTH_TOKEN
});

const db = drizzle({ client });

const result = await db.select().from(users).all()

import { drizzle } from 'drizzle-orm/libsql/web';
import { createClient } from '@libsql/client/web';

const client = createClient({ 
  url: process.env.DATABASE_URL,
  authToken: process.env.DATABASE_AUTH_TOKEN
});

const db = drizzle({ client });

const result = await db.select().from(users).all()

第 3 步 - 执行查询

import { drizzle } from 'drizzle-orm/libsql';
import * as s from 'drizzle-orm/sqlite-core';

const db = drizzle({ connection: {
  url: process.env.DATABASE_URL, 
  authToken: process.env.DATABASE_AUTH_TOKEN 
}});

const users = s.sqliteTable("users", {
  id: s.integer(),
  name: s.text(),
})

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

接下来是什么？

管理 Schema

Drizzle 架构 PostgreSQL 数据类型索引和约束数据库视图数据库模式序列扩展

查询数据

关系型查询选择插入更新删除筛选器连接 sql`` 操作符