Michael JohnsonTeams, die Inhalte in Cloudflare D1 speichern, können ausgewählte Datensätze jetzt ohne separaten Zwischenschritt an AI Search übergeben. Am 12. November 2026 hat Cloudflare D1 als Datenquelle in die Beta-Version des Dienstes aufgenommen: Entwickler legen eine schreibgeschützte Abfrage fest, und AI Search wandelt jede zurückgegebene Zeile in ein Dokument um und aktualisiert den Index nach Zeitplan.
Was sich geändert hat
Bisher bot AI Search andere Datenquellen an, etwa R2-Objekte oder Webinhalte. Nun kann D1 Daten direkt aus Tabellen in den Index übertragen, zum Beispiel veröffentlichte Artikel, einen Produktkatalog oder Einträge einer Wissensdatenbank. Cloudflare beschrieb die Neuerung im Changelog-Eintrag vom 12. November; eine Instanz mit D1 als Quelle lässt sich über das Dashboard, die REST API oder ein Workers Binding erstellen.
Der Datenbankbesitzer legt per SQL-Abfrage fest, welche Datensätze in den Index gelangen und welche Felder als Titel, Inhalt und Metadaten des Dokuments dienen. Bei einer Artikeldatenbank kann eine Abfrage beispielsweise nur veröffentlichte Beiträge auswählen und den Spalten die Rollen id, title, content und meta_category zuweisen. So entsteht die Suchansicht aus einer vom Entwickler festgelegten Abfrage.
So funktioniert die Anbindung
Beim Einrichten einer D1-Datenquelle führt AI Search die festgelegte Abfrage aus, indexiert die Zeilen einzeln und synchronisiert den Index nach Zeitplan. Für die REST API und das Workers Binding werden die ID einer D1-Datenbank im selben Cloudflare-Konto, die ID eines Servicetokens und eine Abfrage benötigt, die eine Spalte id zurückgibt. Im Dashboard können Nutzer eine Datenbank auswählen, eine Abfrage erstellen und das Ergebnis anhand einer Zeile prüfen, bevor sie die Instanz anlegen – diese Schritte beschreibt die Dokumentation zur D1-Datenquelle.
Die Spaltennamen legen ihre Funktion fest: title wird zum Dokumenttitel, content zum Haupttext und Spalten mit dem Präfix meta_ werden als Metadaten gespeichert. Je nach Dokumentvorlage können weitere Spalten als beschriftete Felder erscheinen. So lassen sich in SQL die benötigten Suchkategorien und Felder auswählen.
Welche Abfragen der Dienst akzeptiert
Die Abfrage muss aus einer einzelnen Leseanweisung bestehen, die mit SELECT oder WITH beginnt. Sie muss ein nicht leeres Ergebnis mit eindeutigen, nicht leeren id-Werten liefern. Die Obergrenze liegt bei 100.000 Zeilen, die Abfrage darf höchstens 10.000 Zeichen lang sein. Die Dokumentation untersagt außerdem Bindungsparameter, Kommentare und mehrere SQL-Konstrukte, darunter Schreiboperationen und Verwaltungsbefehle. ORDER BY und LIMIT sind nicht zulässig: AI Search liest die Ergebnisse seitenweise und sortiert nach id.
Ändert sich der Wert einer Zeile in id, löscht AI Search das bisherige Dokument und erstellt ein neues. Für die Synchronisierung sollte deshalb eine stabile Kennung verwendet werden. Außerdem muss jede Ergebnisspalte einen eindeutigen Namen haben; bei Bedarf lässt sich dieser mit AS festlegen. Da die Synchronisierung das vollständige Abfrageergebnis liest, wird sie auf den Verbrauch der D1-Lesevorgänge angerechnet. Mit WHERE-Bedingungen lässt sich die zu indexierende Auswahl eingrenzen.
Für wen ist das nützlich?
Die neue Integration eignet sich für Teams, die strukturierte Inhalte bereits in D1 speichern. Sie können die Datensätze für den Suchindex per Datenbankabfrage auswählen und den Index anschließend aktualisieren, wenn Zeilen hinzugefügt, geändert oder gelöscht werden. Ein Katalog kann beispielsweise nur verfügbare Produkte enthalten, ein Helpcenter nur veröffentlichte Artikel und ihre Kategorien. Jede Zeile wird zu einem eigenen Dokument.
Die Integration befindet sich noch in der Beta. Vor dem Start sollten Teams prüfen, ob die id-Werte eindeutig und stabil sind, nur die benötigten Spalten auswählen und abschätzen, wie sich Ergebnisgröße und Synchronisierungszeitplan auf die D1-Nutzung auswirken. Der Index wird in festgelegten Intervallen aktualisiert; das Lesen des vollständigen Ergebnisses bei jeder Synchronisierung verbraucht D1-Lesevorgänge.
Die wichtigste Neuerung: D1 kann nun als Quelle für AI Search dienen, und die SQL-Abfrage bestimmt, welche Datenbankzeilen zu Suchdokumenten werden. Für Teams mit Inhalten in D1 bietet das eine direkte Verbindung zwischen Daten und Index. Bei der Planung müssen sie das Zeilenlimit und die Datenbanklesevorgänge während der Synchronisierung berücksichtigen.
