Question

Turso 是一个基于 libSQL（一个 SQLite 的分支）的分布式数据库。它针对低查询延迟进行了优化，适用于全球范围内的应用程序。

在 Astro 中初始化 Turso

先决条件

• 已安装并登录 Turso CLI
• 一个创建 Schema 的 Turso 数据库
• 你的数据库 URL
• 一个访问令牌

配置环境变量

使用以下命令获取你的数据库 URL：

turso db show <database-name> --url

为数据库创建一个认证令牌：

turso db tokens create <database-name>

将上面两个命令的输出添加到项目根目录下的 .env 文件中。如果这个文件不存在，请创建一个。

.env

TURSO_DATABASE_URL=libsql://...
TURSO_AUTH_TOKEN=

警告

创建这些私有 环境变量 时，请不要使用 PUBLIC_ 前缀，这会在客户端暴露这些值。

安装 LibSQL 客户端

安装 @libsql/client 以将 Turso 连接到 Astro：

• npm
• pnpm
• Yarn

npm install @libsql/client

pnpm add @libsql/client

yarn add @libsql/client

初始化一个新客户端

在 src 文件夹中创建一个名为 turso.ts 的文件，并调用 createClient，传递 TURSO_DATABASE_URL 和 TURSO_AUTH_TOKEN：

src/turso.ts

import { createClient } from "@libsql/client/web";


export const turso = createClient({
  url: import.meta.env.TURSO_DATABASE_URL,
  authToken: import.meta.env.TURSO_AUTH_TOKEN,
});

查询你的数据库

要从数据库中访问信息，请在任何 .astro 组件中导入 turso 并执行 SQL 查询。

以下示例从你的表中获取所有 posts，然后在 <BlogIndex /> 组件中显示标题列表：

src/components/BlogIndex.astro

---
import { turso } from '../turso'


const { rows } = await turso.execute('SELECT * FROM posts')
---


<ul>
  {rows.map((post) => (
    <li>{post.title}</li>
  ))}
</ul>

SQL 占位符

execute() 方法可以传递一个对象来将变量传递给 SQL 语句，例如 slug 或分页。

以下示例从 posts 表中获取 WHERE 的 slug 值从 Astro.params 检索的单个条目，然后显示帖子的标题。

src/pages/index.astro

---
import { turso } from '../turso'


const { slug } = Astro.params


const { rows } = await turso.execute({
  sql: 'SELECT * FROM posts WHERE slug = ?',
  args: [slug!]
})
---


<h1>{rows[0].title}</h1>

Turso 资源

• Turso 文档
• Turso 在 GitHub 上
• 使用 Turso 提供服务端渲染的 Astro 博客的内容

更多后端服务指南

• 

  Firebase

• 

  Supabase

• 

  Turso

• 

  Xata

• 

  Appwrite

Recipes