Xata 与 Astro

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

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

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

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

XATA_API_KEY=hash_key

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

以及创建好的 databaseURL：

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

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

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

interface ImportMeta {
  readonly env: ImportMetaEnv;
}

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

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

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

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

---
import { getXataClient } from "../xata.codegen";

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

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

需要注意的是，每当你的模式发生变化时，需要重新生成 SDK。因此，请避免对 Xata 命令行工具所创建的生成文件进行更改，因为一旦模式更新，你的更改将被覆盖。

• Xata Astro Starter
• Xata Docs: Quick Start Guide

更多后端服务指南