Адаптеры баз данных для Payload CMS 17

Официальные адаптеры Postgres, MongoDB и SQLite, включая Cloudflare D1. Адаптеры сообщества добавляют MySQL, Convex, DynamoDB и встраиваемый PGlite.

Адаптер базы данных, который запускает Payload на SurrealDB через его интерфейс SQL, совместимый с PostgreSQL

Хранит данные Payload в PostgreSQL с миграциями и поддержкой реплик для чтения

Адаптер базы данных для Payload, который хранит коллекции и глобальные настройки в Vercel Postgres

Хранит данные Payload в базах Cloudflare D1 (SQLite) из Workers

Хранит коллекции и глобальные данные Payload в базе MongoDB

Официальный адаптер базы данных SQLite для Payload, который хранит коллекции и глобалы в файле SQLite

Адаптер базы данных, который связывает коллекции Payload с существующей схемой Prisma

Хранит данные Payload в MySQL или MariaDB вместо базы по умолчанию

Хранит эмбеддинги Payload в индексе Cloudflare Vectorize для семантического поиска

Хранит и ищет эмбеддинги Payload в MongoDB Atlas с помощью векторного поиска

Хранит эмбеддинги в векторных столбцах PostgreSQL с поддержкой pgvector и выполняет по ним поиск для RAG в Payload

Хранит коллекции, глобальные объекты и версии Payload в Amazon DynamoDB

Хранит коллекции и глобальные настройки Payload в SurrealDB как документы без схемы

Встроенная база PGlite (Postgres в процессе Node.js) для Payload без отдельного сервера БД

Хранит коллекции и глобальные настройки Payload в Convex с синхронизацией в реальном времени

Хранит данные Payload в ClickHouse с доступом по HTTP и локальным режимом

Адаптер базы данных, который направляет чтение и запись между локальной и удалённой базой

Об этих пакетах

Адаптер базы данных подключает Payload к базе, где лежат коллекции, globals и версии. Адаптер в проекте всегда один, его указывают в опции db в payload.config. Сменить его потом можно только вместе с переносом данных.

Что входит в категорию

  • Официальные адаптеры Postgres на Drizzle ORM, включая Vercel Postgres
  • Официальный адаптер MongoDB на Mongoose
  • Официальные адаптеры SQLite для libSQL и Cloudflare D1
  • Адаптеры сообщества для MySQL и MariaDB, Convex, DynamoDB, ClickHouse и SurrealDB
  • Встраиваемый PGlite, Prisma и DB Composite с синхронизацией двух баз
  • Векторные хранилища эмбеддингов в pgvector, MongoDB и Cloudflare Vectorize

Как выбрать адаптер базы данных

Берите Postgres, если нужны SQL и генерируемые миграции. MongoDB выбирайте, если ваша команда уже с ней работает. D1 подходит проектам на Cloudflare Workers, Vercel Postgres проектам на Vercel. Для локальной разработки без отдельного сервера базы хватит SQLite или PGlite. Адаптеры сообщества сильно различаются, поэтому перед выбором проверьте историю релизов и поддерживаемую версию Payload. Адаптер DynamoDB, например, рассчитан на бету Payload 4. Для переноса контента из другой CMS используйте инструменты миграции данных.

Частые вопросы

Что выбрать для Payload CMS: Postgres или MongoDB?

Оба адаптера поддерживает команда Payload. Postgres работает через Drizzle ORM и генерирует миграции, когда меняется конфиг. MongoDB хранит документы в структуре, близкой к собственной модели данных Payload. Выбирайте ту базу, которую ваша команда умеет обслуживать и восстанавливать из резервных копий.

Можно ли запустить Payload на SQLite?

Да. Официальный адаптер SQLite работает на libSQL, а адаптер D1 хранит данные в Cloudflare D1. SQLite хорошо подходит для небольших сайтов, локальной разработки и проектов на Cloudflare.

Зачем нужны векторные адаптеры?

Они хранят эмбеддинги для семантического поиска в pgvector, MongoDB или индексе Cloudflare Vectorize. Работают они рядом с основным адаптером базы данных, а коллекции по-прежнему лежат в нём.