Michael Johnsonİçeriğini Cloudflare D1’de saklayan ekipler artık seçtikleri kayıtları ayrı bir ara dışa aktarma işlemine gerek kalmadan AI Search’e aktarabiliyor. Cloudflare, 12 Kasım 2026’da D1’i hizmetin beta sürümünde bir veri kaynağı olarak ekledi: geliştirici salt okunur bir sorgu tanımlıyor, AI Search ise döndürülen her satırı bir belgeye dönüştürüp dizini planlı olarak güncelliyor.
Neler değişti
AI Search daha önce R2 nesneleri veya web içeriği gibi başka kaynak kategorileri sunuyordu. Artık D1, tablolardaki verileri doğrudan dizine aktarabiliyor: örneğin yayımlanmış makaleler, ürün kataloğu veya bilgi bankası kayıtları. Cloudflare yeniliği 12 Kasım tarihli değişiklik günlüğünde açıkladı; D1 kaynağıyla bir örnek kontrol paneli, REST API veya Workers binding üzerinden oluşturulabiliyor.
Veritabanı sahibi, hangi kayıtların dizine ekleneceğini ve hangi alanların belgenin başlığı, içeriği ve meta verileri olacağını SQL sorgusuyla belirliyor. Örneğin makale veritabanı için yazılan bir sorgu yalnızca yayımlanmış içerikleri seçebilir ve sütunlara id, title, content ve meta_category rollerini atayabilir. Böylece arama görünümü geliştiricinin belirlediği seçimden oluşturulur.
Bağlantı nasıl çalışıyor
D1 kaynağı yapılandırıldığında AI Search tanımlanan sorguyu çalıştırıyor, satırları tek tek indeksliyor ve dizini planlı olarak eşitliyor. REST API ve Workers binding için aynı Cloudflare hesabındaki D1 veritabanının kimliği, bir hizmet belirtecinin kimliği ve id sütununu döndüren bir sorgu gerekiyor. Kontrol panelinde veritabanı seçilebiliyor, sorgu oluşturulabiliyor ve örnek kurulmadan önce tek bir satır üzerinden sonuç denetlenebiliyor; bu adımlar D1 veri kaynağı belgelerinde açıklanıyor.
Sütun adları, ilgili alanların görevini belirliyor: title belgenin başlığı, content ana metni oluyor; meta_ önekiyle başlayan sütunlar ise meta veri olarak saklanıyor. Belge şablonuna bağlı olarak diğer sütunlar etiketli alanlar şeklinde gösterilebiliyor. Böylece SQL’de arama için gereken kategoriler ve alanlar seçilebiliyor.
Hizmetin kabul ettiği sorgular
Sorgu, SELECT veya WITH ile başlayan tek bir okuma ifadesi olmalı. Boş olmayan bir sonuç döndürmeli ve bu sonuçta id değerleri benzersiz ve boş olmamalı; üst sınır 100.000 satır, sorgu uzunluğu ise 10.000 karakter. Belgeler ayrıca bağlama parametrelerini, yorumları ve yazma işlemleriyle yönetim komutları dâhil çeşitli SQL yapılarını yasaklıyor. AI Search sonuçları id değerine göre sıralayarak sayfalar hâlinde okuduğundan ORDER BY ve LIMIT kullanılamıyor.
Bir satırın id değeri değişirse AI Search eski belgeyi siliyor ve yenisini oluşturuyor. Bu nedenle eşitleme için sabit bir tanımlayıcı seçmek gerekiyor. Sorgu sonucundaki her sütunun adı da benzersiz olmalı; gerekirse ad AS ile verilebilir. Eşitleme sorgunun tüm sonucunu okuduğundan bu işlem D1 okuma kullanımına dâhil ediliyor; WHERE koşulları dizine alınacak veri kümesini sınırlamaya yardımcı oluyor.
Kimler için yararlı
Yeni entegrasyon, yapılandırılmış içeriğini zaten D1’de saklayan ekipler için uygun. Bu ekipler, arama koleksiyonuna girecek kayıtları veritabanı sorgusuyla seçebilir ve satırlar eklendiğinde, değiştirildiğinde veya silindiğinde dizini eşitleyebilir. Örneğin bir katalog yalnızca satışa açık ürünleri, bir yardım merkezi ise yalnızca yayımlanmış makaleleri ve kategorilerini içerebilir. Her satır ayrı bir belgeye dönüşür.
Entegrasyon henüz beta sürümünde. Kullanıma almadan önce id değerlerinin benzersiz ve sabit olduğunu doğrulamak, yalnızca gereken sütunları seçmek ve sonuç boyutunun yanı sıra eşitleme planının D1 kullanımını nasıl etkileyeceğini değerlendirmek yararlı olur. Dizin güncellemeleri seçilen aralıkta gerçekleşiyor; her eşitlemede sonucun tamamının okunması D1 okuma tüketimine yansıyor.
Özetle D1 artık AI Search için bir kaynak olabiliyor ve SQL sorgusu, veritabanındaki hangi satırların aranabilir belgelere dönüşeceğini belirliyor. İçeriğini D1’de tutan ekipler için bu, verilerle dizini doğrudan bağlamanın bir yolu; planlama sırasında satır sınırını ve eşitleme esnasındaki veritabanı okumalarını hesaba katmak gerekiyor.
