Xata 与 Astro

Xata 是一个 Serverless 数据平台，它通过公开单一的连续性 REST API 来结合了关系数据库、搜索引擎和分析引擎等功能。

通过 Xata 添加一个数据库

前期准备

一个 Xata 账户，并且通过该账户创建了一个数据库（你可以使用来自于 Web 界面的样例数据）；
一个可访问的令牌（XATA_TOKEN_API）；
你的数据库连接。

在你更新并初始化 Xata 命令行之后，你将在 .env 文件中拥有自己的 API 令牌以及数据库 URL。

一切设置妥当之后，你应该拥有以下内容：

XATA_API_KEY=hash_key

# 如果在你的 git 分支中不存在同名的 xata 分支情况下，该 xata 分支会被使用
XATA_BRANCH=main

以及创建好的 databaseURL：

{
  "databaseUrl": "https://your-database-url"
}

环境配置

为了让你的环境变量开启 IntelliSense 以及拥有类型安全，请在你的 src/ 目录下编辑或创建一个 env.d.ts 文件

interface ImportMetaEnv {
  readonly XATA_API_KEY: string;
  readonly XATA_BRANCH?: string;
}

interface ImportMeta {
  readonly env: ImportMetaEnv;
}

使用 Xata 命令行工具的代码生成功能，然后选择 TypeScripts 选项并创建一个 SDK 实例，当中的类型与会与你的数据库模式相匹配。除此之外，@xata.io/client 也会添加到你的 package.json 文件中。

你的 Xata 环境变量和数据库链接会自动被 SDK 实例拉取，所以就再也不需要其他额外的设置操作。

现在，你的项目应该具有以下结构：

目录src/
- xata.ts
- env.d.ts
.env
astro.config.mjs
package.json
.xatarc

创建你的查询

为了查询你的博文，请在一个 .astro 文件中导入并使用 XataClient 类。以下例子将从 Xata 的样例博客数据库中请求前 50 篇文章。

---
import { XataClient } from '../../xata';

const xata = new XataClient({
  apiKey: import.meta.env.XATA_API_KEY,
  branch: import.meta.env.XATA_BRANCH
});

const { records } = await xata.db.Posts.getPaginated({
  pagination: {
    size: 50
  }
})
---

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