Michael JohnsonTeams die content opslaan in Cloudflare D1 kunnen nu geselecteerde records aan AI Search doorgeven zonder die eerst apart te exporteren. Op 12 november 2026 voegde Cloudflare D1 als gegevensbron toe aan de bètaversie van de dienst: de ontwikkelaar stelt een alleen-lezenquery in, waarna AI Search elke geretourneerde rij omzet in een document en de index volgens een schema bijwerkt.
Wat is er veranderd?
AI Search bood eerder andere soorten gegevensbronnen, zoals R2-objecten of webcontent. Nu kan D1 rechtstreeks gegevens uit tabellen aan de index leveren, bijvoorbeeld gepubliceerde artikelen, een productcatalogus of records uit een kennisbank. Cloudflare beschreef de wijziging in de changelogvermelding van 12 november; een instantie met D1 als bron kan worden aangemaakt via het dashboard, de REST API of een Workers-binding.
De database-eigenaar bepaalt met een SQL-query welke records in de index komen en welke velden de titel, inhoud en metadata van het document vormen. Voor een artikelendatabase kan de query bijvoorbeeld alleen gepubliceerde stukken selecteren en de kolommen de rollen id, title, content en meta_category geven. Zo wordt de zoekweergave opgebouwd uit de selectie die de ontwikkelaar heeft opgegeven.
Zo werkt de koppeling
Bij het instellen van een D1-bron voert AI Search de opgegeven query uit, indexeert het de rijen afzonderlijk en synchroniseert het de index volgens een schema. Voor de REST API en een Workers-binding zijn de ID van de D1-database in hetzelfde Cloudflare-account, de ID van een servicetoken en een query die een kolom id retourneert vereist. In het dashboard kun je een database kiezen, een query opstellen en het resultaat voor één rij controleren voordat je een instantie aanmaakt; deze stappen staan in de documentatie over de D1-bron.
De kolomnamen geven hun functie aan: title wordt de documenttitel, content de hoofdtekst en kolommen met het voorvoegsel meta_ worden als metadata opgeslagen. Afhankelijk van de documentsjabloon kunnen andere kolommen als benoemde velden worden weergegeven. Zo kun je in SQL de categorieën en velden selecteren die voor zoeken relevant zijn.
Welke queries accepteert de dienst?
De query moet bestaan uit één leesbewerking die begint met SELECT of WITH. De query moet een niet-lege uitkomst opleveren met unieke, niet-lege waarden in id; het maximum is 100.000 rijen en de query mag maximaal 10.000 tekens bevatten. De documentatie verbiedt ook bindparameters, commentaar en meerdere SQL-constructies, waaronder schrijfbewerkingen en beheeropdrachten. ORDER BY en LIMIT zijn niet toegestaan: AI Search leest de resultaten in pagina’s en sorteert op id.
Als de waarde van id van een rij verandert, verwijdert AI Search het oude document en maakt het een nieuw document aan. Kies daarom een stabiele identificatie. Elke kolom in het resultaat moet bovendien een unieke naam hebben; indien nodig kun je die met AS opgeven. Omdat de synchronisatie het volledige resultaat van de query leest, telt deze mee voor het aantal D1-reads. Met voorwaarden in WHERE kun je de selectie die wordt geïndexeerd beperken.
Voor wie is dit nuttig?
De nieuwe koppeling is geschikt voor teams die gestructureerde content al in D1 opslaan. Met een query op de database kunnen ze records voor de zoekcollectie selecteren en de index vervolgens synchroniseren wanneer rijen worden toegevoegd, gewijzigd of verwijderd. Een catalogus kan bijvoorbeeld alleen producten bevatten die te koop zijn, en een helpcentrum alleen gepubliceerde artikelen en hun categorieën. Elke rij wordt een afzonderlijk document.
De integratie is voorlopig in bèta. Controleer voordat je aan de slag gaat of id-waarden uniek en stabiel zijn, selecteer alleen de benodigde kolommen en beoordeel hoe de omvang van de resultaten en het synchronisatieschema het D1-gebruik beïnvloeden. De index wordt met het gekozen interval bijgewerkt; bij elke synchronisatie wordt het volledige resultaat gelezen, wat D1-reads verbruikt.
De kern van de wijziging is dat D1 nu als bron voor AI Search kan dienen en dat de SQL-query bepaalt welke databaserijen zoekdocumenten worden. Voor teams met content in D1 biedt dit een rechtstreekse manier om gegevens aan een index te koppelen. Houd bij de planning rekening met de rijlimiet en de database-reads die de synchronisatie verbruikt.
