Michael JohnsonTeam som lagrar innehåll i Cloudflare D1 kan nu skicka utvalda poster till AI Search utan en separat mellanliggande export. Den 12 november 2026 lade Cloudflare till D1 som datakälla i en betaversion av tjänsten: utvecklaren anger en skrivskyddad fråga, och AI Search gör varje returnerad rad till ett dokument och uppdaterar indexet enligt ett schema.
Vad har förändrats?
Tidigare erbjöd AI Search andra kategorier av datakällor, exempelvis R2-objekt eller webbinnehåll. Nu kan D1 skicka data från tabeller direkt till indexet, till exempel publicerade artiklar, produktkataloger eller poster i en kunskapsbas. Cloudflare beskrev nyheten i ändringsloggen för den 12 november; en instans med D1 som datakälla kan skapas via kontrollpanelen, REST API eller Workers-bindingen.
Databasens ägare bestämmer med en SQL-fråga vilka poster som ska indexeras och vilka fält som ska användas som dokumentets rubrik, innehåll och metadata. För en artikeldatabas kan frågan till exempel välja enbart publicerat material och tilldela kolumnerna rollerna id, title, content och meta_category. På så vis byggs sökunderlaget från ett urval som utvecklaren har angett.
Så fungerar anslutningen
När en D1-datakälla konfigureras kör AI Search den angivna frågan, indexerar raderna en i taget och synkroniserar indexet enligt ett schema. REST API och Workers-bindingen kräver ett ID för en D1-databas i samma Cloudflare-konto, ett ID för en tjänstetoken och en fråga som returnerar en kolumn med namnet id. I kontrollpanelen kan du välja en databas, skriva en fråga och testa resultatet på en rad innan instansen skapas – stegen beskrivs i dokumentationen för D1-datakällan.
Kolumnnamnen anger deras funktion: title blir dokumentets rubrik, content blir huvudtexten och kolumner med prefixet meta_ sparas som metadata. Övriga kolumner kan visas som etiketterade fält, beroende på dokumentmallen. Det gör det möjligt att välja de kategorier och fält som behövs för sökningen i SQL-frågan.
Vilka frågor godtar tjänsten?
Frågan måste vara en enda läsoperation som börjar med SELECT eller WITH. Den måste returnera ett resultat som inte är tomt och som innehåller unika, icke-tomma värden i id; högst 100 000 rader tillåts och frågan får vara högst 10 000 tecken lång. Dokumentationen förbjuder även bindningsparametrar, kommentarer och flera SQL-konstruktioner, däribland skrivoperationer och administrativa kommandon. ORDER BY och LIMIT får inte användas: AI Search läser resultatet i sidor och sorterar efter id.
Om en rads värde för id ändras tar AI Search bort det tidigare dokumentet och skapar ett nytt. Därför bör du välja en stabil identifierare för synkroniseringen. Varje kolumn i resultatet måste också ha ett unikt namn; vid behov kan du ange ett med AS. Eftersom synkroniseringen läser hela frågeresultatet räknas den av mot D1:s läsningar, och villkor med WHERE hjälper till att begränsa urvalet som indexeras.
Vem har nytta av detta?
Den nya integrationen passar team som redan lagrar strukturerat innehåll i D1. De kan välja poster till sökkorpusen med en databasfråga och sedan synkronisera indexet när rader läggs till, ändras eller tas bort. En katalog kan exempelvis bara ta med produkter som finns tillgängliga för försäljning, medan ett hjälpcenter kan begränsas till publicerade artiklar och deras kategorier. Varje rad blir ett separat dokument.
Integrationen är fortfarande i betaversion. Innan den tas i bruk bör du kontrollera att id är unikt och stabilt, välja endast nödvändiga kolumner och bedöma hur resultatets storlek och synkroniseringsschemat påverkar användningen av D1. Indexet uppdateras enligt det valda intervallet, och varje synkronisering läser hela resultatet och förbrukar D1-läsningar.
Den viktigaste förändringen är att D1 nu kan användas som datakälla för AI Search, där SQL-frågan avgör vilka databasrader som blir sökdokument. För team med innehåll i D1 ger det ett direkt sätt att koppla samman data och index; vid planeringen är det viktigt att ta hänsyn till radgränsen och databasläsningarna under synkroniseringen.
