Michael Johnsonأصبح بإمكان الفرق التي تخزّن محتواها في Cloudflare D1 تمرير سجلات محددة إلى AI Search من دون الحاجة إلى تصدير وسيط منفصل. ففي 12 نوفمبر 2026، أضافت Cloudflare خدمة D1 مصدرًا للبيانات في إصدار تجريبي من الخدمة: يحدد المطوّر استعلامًا للقراءة فقط، ويحوّل AI Search كل صف ناتج إلى مستند، ثم يحدّث الفهرس وفق جدول زمني.
ما الذي تغيّر؟
كان AI Search يتيح سابقًا فئات أخرى من مصادر البيانات، مثل كائنات R2 أو محتوى الويب. أما الآن، فيمكن لـ D1 تمرير البيانات من الجداول مباشرة إلى الفهرس، مثل المقالات المنشورة أو كتالوج المنتجات أو سجلات قاعدة المعرفة. وقد وصفت Cloudflare هذا التحديث في سجل التغييرات بتاريخ 12 نوفمبر؛ ويمكن إنشاء مثيل باستخدام مصدر D1 عبر لوحة التحكم أو REST API أو ارتباط Workers.
يحدد مالك قاعدة البيانات، من خلال استعلام SQL، السجلات التي ستدخل الفهرس والحقول التي ستصبح عنوان المستند ومحتواه وبياناته الوصفية. فعلى سبيل المثال، قد يختار استعلام قاعدة مقالات المواد المنشورة فقط، ويعيّن للأعمدة الأدوار id وtitle وcontent وmeta_category. وهكذا يُبنى تمثيل البحث انطلاقًا من مجموعة النتائج التي يحددها المطوّر.
كيف يعمل الربط؟
عند إعداد مصدر D1، ينفّذ AI Search الاستعلام المحدد، ويفهرس الصفوف واحدًا تلو الآخر، ثم يزامن الفهرس وفق جدول زمني. ويتطلب استخدام REST API وارتباط Workers معرّف قاعدة بيانات D1 في حساب Cloudflare نفسه، ومعرّف رمز خدمة، واستعلامًا يعيد عمود id. أما في لوحة التحكم، فيمكن اختيار قاعدة البيانات وصياغة الاستعلام والتحقق من نتيجته على صف واحد قبل إنشاء المثيل؛ وترد هذه الخطوات في توثيق مصدر D1.
تحدد أسماء الأعمدة وظائفها: يصبح title عنوان المستند، ويمثل content النص الأساسي، بينما تُحفظ الأعمدة التي تبدأ بالبادئة meta_ بوصفها بيانات وصفية. وقد تظهر الأعمدة الأخرى كحقول معنونة، بحسب قالب المستند. ويتيح ذلك اختيار الفئات والحقول اللازمة للبحث عبر SQL.
ما الاستعلامات التي تقبلها الخدمة؟
يجب أن يتألف الاستعلام من تعليمة قراءة واحدة تبدأ بـ SELECT أو WITH. كما يجب أن يعيد نتائج غير فارغة تتضمن قيم id غير فارغة وفريدة؛ والحد الأقصى 100,000 صف، وطول الاستعلام 10,000 حرف. ويحظر التوثيق أيضًا استخدام معاملات الربط والتعليقات وعدة صيغ SQL، منها عمليات الكتابة والأوامر الإدارية. ولا يجوز استخدام ORDER BY أو LIMIT، إذ يقرأ AI Search النتائج على صفحات ويرتبها حسب id.
إذا تغيّرت قيمة id لأحد الصفوف، يحذف AI Search المستند السابق وينشئ مستندًا جديدًا. لذلك، يُستحسن اختيار معرّف ثابت للمزامنة. ويجب أيضًا أن يكون لكل عمود في النتيجة اسم فريد؛ ويمكن تعيين اسم عند الحاجة باستخدام AS. وبما أن المزامنة تقرأ النتيجة الكاملة للاستعلام، فإنها تُحتسب ضمن استهلاك عمليات القراءة في D1، فيما تساعد شروط WHERE على حصر مجموعة البيانات التي ستُفهرس.
لمن تفيد هذه الميزة؟
يناسب هذا الربط الفرق التي تخزّن محتوى منظمًا في D1 بالفعل. إذ يمكنها اختيار السجلات التي ستُضم إلى مجموعة البحث عبر استعلام لقاعدة البيانات، ثم مزامنة الفهرس عند إضافة الصفوف أو تعديلها أو حذفها. فعلى سبيل المثال، يمكن لكتالوج أن يضم المنتجات المتاحة للبيع فقط، ولمركز مساعدة أن يقتصر على المقالات المنشورة وفئاتها. ويصبح كل صف مستندًا مستقلًا.
ما زال التكامل في إصدار تجريبي. وقبل إطلاقه، يُستحسن التحقق من تفرد id وثباته، واختيار الأعمدة الضرورية فقط، وتقدير أثر حجم النتائج وجدول المزامنة في استخدام D1. وتُحدّث الفهارس وفق الفاصل الزمني المحدد، كما أن قراءة النتيجة الكاملة عند كل مزامنة تستهلك عمليات قراءة من D1.
الخلاصة أن D1 أصبح مصدرًا ممكنًا لـ AI Search، وأن استعلام SQL يحدد صفوف قاعدة البيانات التي تتحول إلى مستندات قابلة للبحث. ويوفر ذلك للفرق التي تخزّن محتواها في D1 طريقة مباشرة لربط البيانات بالفهرس؛ لكن التخطيط يتطلب مراعاة الحد الأقصى لعدد الصفوف واستهلاك عمليات قراءة قاعدة البيانات أثناء المزامنة.
