Michael JohnsonКоманди, які зберігають контент у Cloudflare D1, тепер можуть передавати вибрані записи до AI Search без окремого проміжного експорту. 12 листопада 2026 року Cloudflare додала D1 як джерело даних у бета-версії сервісу: розробник задає запит лише для читання, а AI Search перетворює кожен повернений рядок на документ і оновлює індекс за розкладом.
Що змінилося
Раніше AI Search пропонував інші категорії джерел, наприклад об’єкти R2 або вебконтент. Тепер D1 може передавати дані з таблиць безпосередньо до індексу: наприклад, опубліковані статті, каталог товарів або записи бази знань. Cloudflare описала нововведення в записі журналу змін за 12 листопада; створити екземпляр із джерелом D1 можна через панель керування, REST API або Workers binding.
Власник бази визначає за допомогою SQL-запиту, які записи потраплять до індексу та які поля стануть заголовком, вмістом і метаданими документа. Для бази статей запит, наприклад, може вибирати лише опубліковані матеріали й призначати стовпцям ролі id, title, content і meta_category. Так пошукове представлення формується з вибірки, визначеної розробником.
Як налаштувати підключення
Під час налаштування джерела D1 AI Search виконує заданий запит, індексує рядки по одному й синхронізує індекс за розкладом. Для REST API та Workers binding потрібні ID бази D1 у тому самому обліковому записі Cloudflare, ID сервісного токена й запит, який повертає стовпець 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 reads.
Головна зміна полягає в тому, що D1 тепер може бути джерелом для AI Search, а SQL-запит визначає, які рядки бази стають пошуковими документами. Для команд, що зберігають контент у D1, це прямий спосіб пов’язати дані з індексом; під час планування важливо враховувати ліміт рядків і витрати на читання бази під час синхронізації.
