Michael JohnsonLos equipos que almacenan contenido en Cloudflare D1 ahora pueden enviar registros seleccionados a AI Search sin una exportación intermedia. El 12 de noviembre de 2026, Cloudflare añadió D1 como fuente de datos en la versión beta del servicio: el desarrollador define una consulta de solo lectura y AI Search convierte cada fila devuelta en un documento y actualiza el índice según un calendario.
Qué ha cambiado
Antes, AI Search ofrecía otras categorías de fuentes, como objetos de R2 o contenido web. Ahora D1 puede enviar directamente al índice datos de tablas: por ejemplo, artículos publicados, un catálogo de productos o registros de una base de conocimiento. Cloudflare describió la novedad en la entrada del registro de cambios del 12 de noviembre; se puede crear una instancia con D1 como fuente desde el panel de control, la API REST o un binding de Workers.
El propietario de la base determina mediante una consulta SQL qué registros se incluirán en el índice y qué campos serán el título, el contenido y los metadatos del documento. Por ejemplo, en una base de artículos, la consulta podría seleccionar solo los materiales publicados y asignar a las columnas los roles id, title, content y meta_category. Así, la vista de búsqueda se construye a partir de la selección definida por el desarrollador.
Cómo funciona la conexión
Al configurar una fuente D1, AI Search ejecuta la consulta indicada, indexa las filas una por una y sincroniza el índice según un calendario. Para la API REST y el binding de Workers se necesitan el ID de la base D1 dentro de la misma cuenta de Cloudflare, el ID de un token de servicio y una consulta que devuelva una columna id. En el panel se puede elegir la base, redactar una consulta y comprobar el resultado en una fila antes de crear la instancia; estos pasos se detallan en la documentación de la fuente D1.
Los nombres de las columnas determinan su función: title se convierte en el título del documento, content en el texto principal y las columnas con el prefijo meta_ se conservan como metadatos. Otras columnas pueden mostrarse como campos etiquetados, según la plantilla del documento. Esto permite seleccionar en SQL las categorías y los campos que necesita la búsqueda.
Qué consultas acepta el servicio
La consulta debe ser una única instrucción de lectura que empiece por SELECT o WITH. Debe devolver un resultado no vacío con valores id únicos y no vacíos; el máximo es de 100 000 filas y la consulta no puede superar los 10 000 caracteres. La documentación también prohíbe los parámetros de vinculación, los comentarios y varias construcciones SQL, incluidas las operaciones de escritura y los comandos administrativos. No se puede usar ORDER BY ni LIMIT: AI Search lee el resultado en páginas y lo ordena por id.
Si cambia el valor de id de una fila, AI Search elimina el documento anterior y crea uno nuevo. Por eso, conviene elegir un identificador estable para la sincronización. Cada columna del resultado también debe tener un nombre único; si es necesario, se puede asignar mediante AS. Como la sincronización lee todo el resultado de la consulta, cuenta para el consumo de lecturas de D1, y las condiciones WHERE ayudan a limitar la selección que se indexa.
A quién le resulta útil
Esta nueva integración es adecuada para equipos que ya almacenan contenido estructurado en D1. Pueden seleccionar mediante una consulta a la base los registros que formarán el corpus de búsqueda y, después, sincronizar el índice cuando se añadan, modifiquen o eliminen filas. Por ejemplo, un catálogo puede incluir solo productos disponibles para la venta, y un centro de ayuda, solo artículos publicados y sus categorías. Cada fila se convierte en un documento independiente.
La integración todavía está en beta. Antes de ponerla en marcha, conviene comprobar que los valores de id sean únicos y estables, seleccionar solo las columnas necesarias y evaluar cómo afectarán el tamaño del resultado y el calendario de sincronización al uso de D1. El índice se actualiza con el intervalo elegido, y leer todo el resultado en cada sincronización consume lecturas de D1.
En resumen, D1 ahora puede servir como fuente para AI Search, y la consulta SQL determina qué filas de la base se convierten en documentos de búsqueda. Para los equipos que almacenan contenido en D1, esto ofrece una forma directa de conectar los datos con el índice; al planificar, es importante tener en cuenta el límite de filas y las lecturas de la base durante la sincronización.
