Michael JohnsonTiimit, jotka tallentavat sisältöä Cloudflare D1:een, voivat nyt siirtää valitut tietueet AI Searchiin ilman erillistä välivientiä. 12. marraskuuta 2026 Cloudflare lisäsi D1:n palvelun tietolähteeksi beetavaiheessa: kehittäjä määrittää vain luku -kyselyn, ja AI Search muuntaa jokaisen palautetun rivin dokumentiksi sekä päivittää indeksin aikataulun mukaan.
Mikä muuttui
Aiemmin AI Search tarjosi muita tietolähteitä, kuten R2-objekteja tai verkkosisältöä. Nyt D1 voi siirtää taulukoiden dataa suoraan indeksiin: esimerkiksi julkaistuja artikkeleita, tuotekatalogin tai tietämyskannan tietueita. Cloudflare kuvasi uudistuksen 12. marraskuuta julkaistussa muutoslokimerkinnässä; D1-tietolähteen sisältävän instanssin voi luoda hallintapaneelissa, REST API:n kautta tai Workers-sidonnalla.
Tietokannan omistaja määrittää SQL-kyselyllä, mitkä tietueet indeksoidaan ja mitkä kentät toimivat dokumentin otsikkona, sisältönä ja metatietoina. Artikkelien tietokannassa kysely voi esimerkiksi valita vain julkaistut sisällöt ja määrittää sarakkeille roolit id, title, content ja meta_category. Näin hakunäkymä muodostetaan kehittäjän määrittämästä kyselytuloksesta.
Miten yhteys toimii
D1-tietolähdettä määritettäessä AI Search suorittaa kyselyn, indeksoi rivit yksitellen ja synkronoi indeksin aikataulun mukaan. REST API:n ja Workers-sidonnan käyttö edellyttää samassa Cloudflare-tilissä olevan D1-tietokannan tunnusta, palvelutunnuksen tunnusta sekä kyselyä, joka palauttaa id-sarakkeen. Hallintapaneelissa voi valita tietokannan, laatia kyselyn ja tarkistaa tuloksen yhdestä rivistä ennen instanssin luomista – nämä vaiheet kuvataan D1-tietolähteen dokumentaatiossa.
Sarakkeiden nimet määrittävät niiden käyttötarkoituksen: title on dokumentin otsikko, content pääteksti, ja meta_-etuliitteellä alkavat sarakkeet tallennetaan metatietoina. Muut sarakkeet voidaan näyttää nimettyinä kenttinä dokumenttimallista riippuen. Näin SQL-kyselyllä voi valita hakuun tarvittavat luokat ja kentät.
Millaisia kyselyitä palvelu hyväksyy
Kyselyn on oltava yksi lukutoiminto, joka alkaa komennolla SELECT tai WITH. Sen on palautettava vähintään yksi rivi, ja id-arvojen on oltava yksilöllisiä ja ei-tyhjiä. Rivien enimmäismäärä on 100 000 ja kyselyn enimmäispituus 10 000 merkkiä. Dokumentaatio kieltää myös sidontaparametrit, kommentit sekä useat SQL-rakenteet, kuten kirjoitusoperaatiot ja hallintakomennot. Komentoja ORDER BY ja LIMIT ei saa käyttää: AI Search lukee tuloksen sivuittain ja lajittelee sen id-arvon mukaan.
Jos rivin id-arvo muuttuu, AI Search poistaa vanhan dokumentin ja luo uuden. Siksi synkronointia varten kannattaa valita pysyvä tunniste. Myös jokaisella tulossarakkeella on oltava yksilöllinen nimi; tarvittaessa sen voi määrittää AS-avainsanalla. Koska synkronointi lukee kyselyn koko tuloksen, se kuluttaa D1:n lukukertoja, ja WHERE-ehdoilla voi rajata indeksoitavaa aineistoa.
Kenelle tästä on hyötyä
Uusi integraatio sopii tiimeille, jotka jo tallentavat jäsenneltyä sisältöä D1:een. Ne voivat valita hakuaineistoon tulevat tietueet tietokantakyselyllä ja synkronoida indeksin rivien lisäämisen, muuttamisen tai poistamisen yhteydessä. Tuotekatalogiin voi esimerkiksi sisällyttää vain myyntikelpoiset tuotteet ja ohjekeskukseen vain julkaistut artikkelit luokkineen. Jokaisesta rivistä muodostuu erillinen dokumentti.
Integraatio on vielä beetavaiheessa. Ennen käyttöönottoa kannattaa tarkistaa id-arvojen yksilöllisyys ja pysyvyys, valita vain tarvittavat sarakkeet sekä arvioida, miten tuloksen koko ja synkronointiaikataulu vaikuttavat D1:n käyttöön. Indeksi päivittyy valitun aikavälin mukaan, ja koko kyselytuloksen lukeminen jokaisessa synkronoinnissa kuluttaa D1-lukukertoja.
Keskeinen uudistus on, että D1 voi nyt toimia AI Searchin tietolähteenä ja SQL-kysely määrittää, mitkä tietokannan rivit muuttuvat hakudokumenteiksi. D1:een sisältöä tallentaville tiimeille tämä tarjoaa suoran tavan yhdistää data ja indeksi; suunnittelussa on kuitenkin huomioitava riviraja sekä synkronoinnin aiheuttamat tietokantaluvut.
