Пропустить до содержимого

Xata и Astro

Xata - это Бессерверная Платформа Данных, которая сочетает в себе возможности реляционной базы данных, поисковой системы и аналитического механизма, предоставляя единый согласованный REST API.

  • Xata аккаунт с созданной базой данных. (Вы можете использовать пример базы данных из веб-интерфейса.)
  • Токен доступа (XATA_TOKEN_API).
  • URL вашей базы данных.

После обновления и инициализации Xata CLI у вас будет токен API в файле .env и определен URL базы данных.

По окончании настройки у вас должны быть:

.env
XATA_API_KEY=hash_key
# Ветка Xata, которая будет использоваться
# если не существует ветки xata с
# тем же именем, что и ваша ветка git
XATA_BRANCH=main

И определен databaseURL:

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

Чтобы получить IntelliSense и безопасность типов для переменных окружения, отредактируйте или создайте файл env.d.ts в каталоге src/:

src/env.d.ts
interface ImportMetaEnv {
readonly XATA_API_KEY: string;
readonly XATA_BRANCH?: string;
}
interface ImportMeta {
readonly env: ImportMetaEnv;
}

Используя генерацию кода из Xata CLI и выбрав опцию TypeScript, вы сгенерировали экземпляр SDK с типами, адаптированными под схему вашей базы данных. Кроме того, @xata.io/client был добавлен в ваш package.json.

Ваши переменные окружения Xata и url базы данных были автоматически подтянуты экземпляром SDK, так что больше никакой работы по настройке не требуется.

Теперь ваш проект должен иметь следующую структуру:

  • Directorysrc/
    • xata.ts
    • env.d.ts
  • .env
  • astro.config.mjs
  • package.json
  • .xatarc

Чтобы запросить записи, импортируйте и используйте класс XataClient в файле .astro. Пример ниже запрашивает первые 50 постов из базы данных примеров блога Xata.

src/pages/blog/index.astro
---
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>

Важно отметить, что SDK необходимо перегенерировать каждый раз, когда меняется схема. Поэтому избегайте внесения изменений в сгенерированные файлы, созданные Xata CLI, поскольку после обновления схемы ваши изменения будут перезаписаны.

Дополнительные руководства по бэкенд-сервисам