Michael JohnsonTýmy, které ukládají obsah do Cloudflare D1, nyní mohou předávat vybrané záznamy do AI Search bez samostatného mezikroku exportu. Dne 12. listopadu 2026 přidala Cloudflare D1 jako zdroj dat v beta verzi služby: vývojář zadá pouze čtecí dotaz a AI Search převede každý vrácený řádek na dokument a aktualizuje index podle plánu.
Co se změnilo
Dříve AI Search podporoval jiné kategorie zdrojů, například objekty R2 nebo webový obsah. Nyní může D1 předávat do indexu data z tabulek přímo: například publikované články, katalog produktů nebo záznamy znalostní báze. Cloudflare novinku popsala v záznamu změn z 12. listopadu; instanci se zdrojem D1 lze vytvořit přes ovládací panel, REST API nebo Workers binding.
Vlastník databáze určí pomocí SQL dotazu, které záznamy se do indexu dostanou a která pole budou představovat název, obsah a metadata dokumentu. U databáze článků může dotaz například vybrat pouze publikované materiály a přiřadit sloupcům role id, title, content a meta_category. Vyhledávací reprezentace tak vzniká z výběru, který určí vývojář.
Jak připojení funguje
Při nastavení zdroje D1 AI Search provede zadaný dotaz, zaindexuje jednotlivé řádky a synchronizuje index podle plánu. Pro REST API a Workers binding je potřeba ID databáze D1 ve stejném účtu Cloudflare, ID servisního tokenu a dotaz vracející sloupec id. V ovládacím panelu lze vybrat databázi, sestavit dotaz a před vytvořením instance ověřit výsledek na jednom řádku — postup popisuje dokumentace zdroje D1.
Názvy sloupců určují jejich funkci: title se stává názvem dokumentu, content hlavním textem a sloupce s předponou meta_ se ukládají jako metadata. Ostatní sloupce se mohou zobrazovat jako označená pole, a to podle šablony dokumentu. Díky tomu lze v SQL vybrat kategorie a pole potřebná pro vyhledávání.
Jaké dotazy služba přijímá
Dotaz musí být jediným příkazem pro čtení a začínat na SELECT nebo WITH. Musí vracet neprázdný výsledek s jedinečnými a neprázdnými hodnotami id; maximum je 100 000 řádků a délka dotazu může být nejvýše 10 000 znaků. Dokumentace zakazuje také parametry vazby, komentáře a několik konstrukcí SQL včetně příkazů pro zápis a administrativních příkazů. Nelze použít ORDER BY ani LIMIT: AI Search čte výsledek po stránkách a řadí jej podle id.
Pokud se hodnota id řádku změní, AI Search odstraní původní dokument a vytvoří nový. Pro synchronizaci je proto vhodné zvolit stabilní identifikátor. Každý sloupec ve výsledku musí mít také jedinečný název; v případě potřeby jej lze určit pomocí AS. Protože synchronizace čte celý výsledek dotazu, započítává se do spotřeby čtení D1. Podmínky WHERE pomohou omezit výběr, který se indexuje.
Pro koho je novinka užitečná
Nové propojení se hodí týmům, které už ukládají strukturovaný obsah v D1. Záznamy pro vyhledávací korpus mohou vybírat pomocí dotazu do databáze a následně synchronizovat index při přidání, změně nebo odstranění řádků. Katalog může například zahrnovat pouze položky dostupné k prodeji a centrum nápovědy jen publikované články a jejich kategorie. Každý řádek se stává samostatným dokumentem.
Integrace je zatím v beta verzi. Před spuštěním je vhodné ověřit jedinečnost a stabilitu hodnot id, vybrat pouze potřebné sloupce a posoudit, jak velikost výsledku a plán synchronizace ovlivní využití D1. Aktualizace indexu probíhají ve zvoleném intervalu a čtení celého výsledku při každé synchronizaci spotřebovává čtení D1.
Hlavní změnou je, že D1 nyní může sloužit jako zdroj pro AI Search a SQL dotaz určuje, které řádky databáze se stanou dokumenty pro vyhledávání. Týmům s obsahem v D1 to poskytuje přímý způsob, jak propojit data s indexem; při plánování je třeba počítat s limitem počtu řádků a se čtením databáze během synchronizace.
