Michael JohnsonTeam som lagrer innhold i Cloudflare D1, kan nå sende utvalgte poster til AI Search uten en separat mellomliggende eksport. 12. november 2026 la Cloudflare til D1 som datakilde i en betaversjon av tjenesten: Utvikleren angir en skrivebeskyttet spørring, og AI Search gjør hver returnerte rad om til et dokument og oppdaterer indeksen etter en tidsplan.
Hva er endret
Tidligere tilbød AI Search andre kategorier av datakilder, for eksempel R2-objekter eller nettinnhold. Nå kan D1 sende data fra tabeller direkte til indeksen, for eksempel publiserte artikler, en produktkatalog eller poster fra en kunnskapsbase. Cloudflare beskrev nyheten i endringsloggen for 12. november; en instans med D1 som datakilde kan opprettes via kontrollpanelet, REST API eller Workers binding.
Databaseeieren bestemmer med en SQL-spørring hvilke poster som skal indekseres, og hvilke felt som skal være dokumentets tittel, innhold og metadata. For en artikkeldatabase kan spørringen for eksempel velge bare publiserte tekster og tilordne kolonnene rollene id, title, content og meta_category. Slik bygges søkevisningen ut fra et utvalg som utvikleren definerer.
Slik fungerer tilkoblingen
Når en D1-datakilde konfigureres, kjører AI Search den angitte spørringen, indekserer radene én etter én og synkroniserer indeksen etter en tidsplan. REST API og Workers binding krever en D1-database-ID i samme Cloudflare-konto, en ID for et tjenestetoken og en spørring som returnerer kolonnen id. I kontrollpanelet kan du velge en database, skrive en spørring og kontrollere resultatet på én rad før du oppretter en instans – fremgangsmåten står i dokumentasjonen for D1-datakilden.
Kolonnenavn angir hvilken funksjon de har: title blir dokumentets tittel, content blir hovedteksten, og kolonner med prefikset meta_ lagres som metadata. Andre kolonner kan vises som navngitte felt, avhengig av dokumentmalen. Dermed kan du velge kategoriene og feltene som søket trenger, i SQL.
Hvilke spørringer godtar tjenesten
Spørringen må være én lesekommando som begynner med SELECT eller WITH. Den må returnere et ikke-tomt resultat med unike, ikke-tomme id-verdier; maksimum er 100 000 rader, og spørringen kan være opptil 10 000 tegn. Dokumentasjonen forbyr også bind-variabler, kommentarer og flere SQL-konstruksjoner, blant annet skriveoperasjoner og administrative kommandoer. ORDER BY og LIMIT kan ikke brukes: AI Search leser resultatet sidevis og sorterer etter id.
Hvis en rads id-verdi endres, sletter AI Search det gamle dokumentet og oppretter et nytt. Derfor bør du velge en stabil identifikator for synkronisering. Hver resultatkolonne må også ha et unikt navn; om nødvendig kan det angis med AS. Siden synkroniseringen leser hele resultatet av spørringen, teller den med i D1-lesingene, og WHERE-vilkår kan begrense utvalget som indekseres.
Hvem har nytte av dette
Den nye koblingen passer for team som allerede lagrer strukturert innhold i D1. De kan velge poster til søkeindeksen med en databaseforespørsel og deretter synkronisere indeksen når rader legges til, endres eller slettes. En katalog kan for eksempel bare omfatte varer som er tilgjengelige for salg, mens et hjelpesenter kan inkludere bare publiserte artikler og kategoriene deres. Hver rad blir et eget dokument.
Integrasjonen er foreløpig i beta. Før du tar den i bruk, bør du kontrollere at id-verdiene er unike og stabile, velge bare nødvendige kolonner og vurdere hvordan størrelsen på resultatet og synkroniseringsplanen påvirker D1-bruken. Indeksen oppdateres med det valgte intervallet, og lesing av hele resultatet ved hver synkronisering bruker D1-lesinger.
Den viktigste endringen er at D1 nå kan være datakilde for AI Search, mens SQL-spørringen bestemmer hvilke databasrader som blir søkedokumenter. For team med innhold i D1 gir dette en direkte måte å koble dataene til en indeks på; planleggingen bør ta hensyn til radgrensen og databaselesingene under synkronisering.
