Datenbankadapter für Payload CMS 17

Offizielle Adapter für Postgres, MongoDB und SQLite, auch für Cloudflare D1. Community-Adapter ergänzen MySQL, Convex, DynamoDB und eingebettetes PGlite.

Datenbank-Adapter, mit dem Payload über die PostgreSQL-kompatible SQL-Schnittstelle von SurrealDB betrieben wird

Speichert Payload-Daten in einer PostgreSQL-Datenbank, mit Migrationen und Unterstützung für Read-Replicas

Datenbank-Adapter, der Payload mit Vercel Postgres betreibt

Speichert Payload-Daten in Cloudflare-D1-SQLite-Datenbanken aus Workers heraus

Speichert Payload-Collections und Globals in einer MongoDB-Datenbank

Offizieller SQLite-Datenbank-Adapter, der Collections und Globals von Payload in SQLite speichert

Datenbank-Adapter, der Payload-Collections auf ein bestehendes Prisma-Schema abbildet

Speichert Payload-Vektoreinbettungen in einem Cloudflare-Vectorize-Index für die semantische Suche

Speichert und durchsucht Payload-Embeddings mit der Vektorsuche von MongoDB Atlas

Speichert Payload-Collections und Globals in SurrealDB als schemalose Dokumente

Eingebettete PGlite-Postgres-Datenbank für Payload, ohne separaten Datenbankserver

Speichert Payload-Collections und Globals in Convex als Datenbank, mit Echtzeit-Synchronisation

Speichert Payload-Daten in ClickHouse, mit HTTP-Zugriff für Edge-Laufzeiten und einem eingebetteten lokalen Modus

Datenbank-Adapter, der Lese- und Schreibzugriffe zwischen einer lokalen und einer entfernten Datenbank verteilt

Über diese Pakete

Ein Datenbankadapter verbindet Payload mit der Datenbank, in der Ihre Collections, Globals und Versionen liegen. Jedes Projekt nutzt genau einen, den Sie in der payload.config an die Option db übergeben. Ein späterer Wechsel bedeutet eine Datenmigration.

Was diese Adapter abdecken

  • Offizielle Postgres-Adapter auf Basis von Drizzle ORM, auch für Vercel Postgres
  • Der offizielle MongoDB-Adapter auf Basis von Mongoose
  • Offizielle SQLite-Adapter für libSQL und Cloudflare D1
  • Community-Adapter für MySQL und MariaDB, Convex, DynamoDB, ClickHouse und SurrealDB
  • Eingebettetes PGlite, Prisma und DB Composite für zwei synchronisierte Datenbanken
  • Vektorspeicher für Embeddings in pgvector, MongoDB und Cloudflare Vectorize

Einen Datenbankadapter wählen

Nehmen Sie Postgres, wenn Sie SQL und generierte Migrationen möchten. MongoDB passt, wenn Ihr Team es bereits betreibt. D1 eignet sich für Projekte auf Cloudflare Workers, Vercel Postgres für Projekte auf Vercel. Für die lokale Entwicklung ohne eigenen Datenbankserver reichen SQLite oder PGlite. Community-Adapter unterscheiden sich stark, prüfen Sie also Release-Historie und unterstützte Payload-Version, bevor Sie sich festlegen. Der DynamoDB-Adapter etwa zielt auf die Beta von Payload 4. Für den Import aus einem anderen CMS nutzen Sie die Datenmigrations-Tools.

Häufig gestellte Fragen

Sollte ich Postgres oder MongoDB mit Payload CMS nutzen?

Das Payload-Team pflegt beide. Postgres läuft über Drizzle ORM und erzeugt Migrationen, wenn sich Ihre Konfiguration ändert. MongoDB speichert Dokumente in einer Struktur, die der von Payload selbst nahekommt. Nehmen Sie die Datenbank, deren Betrieb und Backups Ihr Team sicher beherrscht.

Kann ich Payload mit SQLite betreiben?

Ja. Der offizielle SQLite-Adapter läuft auf libSQL, der D1-Adapter speichert Daten in Cloudflare D1. SQLite eignet sich gut für kleine Websites, lokale Entwicklung und Projekte auf Cloudflare.

Wofür sind die Vektoradapter gedacht?

Sie speichern Embeddings für die semantische Suche in pgvector, MongoDB oder einem Cloudflare-Vectorize-Index. Ihr Haupt-Datenbankadapter bleibt daneben bestehen und hält weiterhin Ihre Collections.