数据层

什么是 TinaCMS 数据层？

TinaCMS 数据层提供了一个 GraphQL API，用于服务由数据库支持的 Markdown 和 JSON 文件。你可以将数据库视为一种临时缓存，因为你的内容的唯一真实来源实际上是你的 Markdown/JSON 文件。

Figure: TinaCMS 数据层

TinaCMS 在 TinaCMS GraphQL API 和底层 Git 仓库之间实现了这个数据库层。这个数据层缓冲了 TinaCloud 和 GitHub 之间的请求，从而提高了使用 TinaCMS 的编辑性能。

数据层的主要优点包括：

简化的身份验证：数据层抽象了与 GitHub 进行身份验证的复杂性，为编辑者提供了无缝的体验。
本地缓冲：数据层直接提供内容，这意味着编辑者可以在不需要等待与 GitHub 往返的情况下处理他们的内容。这避免了 GitHub API 速率限制的问题，并带来了更快速的编辑体验。
性能：数据层为快速查询索引了你的内容，因此即使在大型仓库中，搜索、分页和引用等功能也能高效运行。
可扩展性：通过将 GraphQL API 与直接文件访问分离，数据层允许 TinaCMS 在不降低性能的情况下扩展到更大的网站和团队。

它还支持其他功能，例如：

你的 Markdown 文件是事实的来源，但 TinaCMS 仍然需要数据层来启用搜索、分页和 Markdown 文件之间的引用等功能。没有它，每个查询都需要直接从文件系统或 Git 读取和解析文件，这无法扩展。

由于数据层提供了一个 API，你可以像使用传统的无头 CMS 一样获取你的内容。

在底层，数据层有两个关键组件：

当一个 GraphQL 查询进入时，TinaCMS 从索引的数据库中读取，而不是从原始文件中读取。这使得排序、过滤和分页变得快速。

当你运行 tinacms dev 时，数据层会自动启动，无需配置。它使用内存数据库并直接从你的文件系统读取文件。文件监视器在你编辑时保持索引的更新，因此更改会立即显示。

TinaCloud 为你提供了一个完全托管的服务的数据层。

它通过 webhooks 与你的 GitHub 仓库同步，并自动维护索引。每个项目都有自己的 GraphQL 端点。

你也可以选择自托管数据层作为替代方案。

索引是扫描你的内容文件并将它们存储在数据库中以便查询的过程。索引包括：

TinaCloud： 每次推送到你的 GitHub 仓库时（通过 webhooks），索引会增量更新。只有更改的文件会被重新索引，因此速度很快。以下情况会触发完整重新索引：

自托管： 索引在你的网站构建时发生。通过 TinaCMS 进行的内容更新会立即反映出来，但直接在 GitHub 上进行的编辑不会在下次构建前出现。

本地开发： 文件监视器在文件在磁盘上更改时立即重新索引。

Git 提供者 — 连接到你的仓库（例如 GitHub）
数据库适配器 — 存储索引。支持的选项有：
- MongoDB (mongodb-level) — 用于传统数据库部署
- Upstash Redis (upstash-redis-level) — 用于无服务器部署（例如 Vercel KV）

数据库适配器是可插拔的，因此可以实现自定义实现。

自托管的常见原因包括：