Michael JohnsonAs equipes que armazenam conteúdo no Cloudflare D1 agora podem enviar registros selecionados para o AI Search sem uma exportação intermediária separada. Em 12 de novembro de 2026, a Cloudflare adicionou o D1 como fonte de dados na versão beta do serviço: o desenvolvedor define uma consulta somente de leitura, e o AI Search transforma cada linha retornada em um documento e atualiza o índice periodicamente.
O que mudou
Antes, o AI Search oferecia outras categorias de fontes, como objetos do R2 ou conteúdo da web. Agora, o D1 pode enviar diretamente ao índice dados de tabelas, por exemplo, artigos publicados, um catálogo de produtos ou registros de uma base de conhecimento. A Cloudflare descreveu a novidade na entrada do registro de alterações de 12 de novembro; é possível criar uma instância com uma fonte D1 pelo painel de controle, pela API REST ou por um binding do Workers.
O responsável pelo banco define, por meio de uma consulta SQL, quais registros serão incluídos no índice e quais campos serão o título, o conteúdo e os metadados do documento. Para uma base de artigos, por exemplo, a consulta pode selecionar apenas materiais publicados e atribuir aos campos as funções id, title, content e meta_category. Assim, a representação para busca é criada a partir da seleção definida pelo desenvolvedor.
Como funciona a conexão
Ao configurar uma fonte D1, o AI Search executa a consulta definida, indexa as linhas uma a uma e sincroniza o índice periodicamente. Para usar a API REST e o binding do Workers, são necessários o ID do banco D1 na mesma conta da Cloudflare, o ID de um token de serviço e uma consulta que retorne a coluna id. No painel, é possível selecionar o banco, elaborar uma consulta e conferir o resultado de uma linha antes de criar a instância — essas etapas estão na documentação da fonte D1.
Os nomes das colunas determinam sua função: title se torna o título do documento, content é o texto principal e as colunas com o prefixo meta_ são armazenadas como metadados. As demais colunas podem aparecer como campos identificados por rótulos, dependendo do modelo do documento. Isso permite selecionar em SQL as categorias e os campos necessários à busca.
Quais consultas o serviço aceita
A consulta deve conter uma única instrução de leitura, começando com SELECT ou WITH. Ela precisa retornar resultados não vazios com valores de id únicos e não vazios; o máximo é de 100 000 linhas, e a consulta pode ter até 10 000 caracteres. A documentação também proíbe parâmetros de vinculação, comentários e várias construções SQL, incluindo operações de gravação e comandos administrativos. Não é permitido usar ORDER BY ou LIMIT: o AI Search lê os resultados em páginas, ordenando-os por id.
Se o valor de id de uma linha mudar, o AI Search exclui o documento anterior e cria um novo. Por isso, é recomendável escolher um identificador estável para a sincronização. Cada coluna do resultado também precisa ter um nome exclusivo; se necessário, ele pode ser definido com AS. Como a sincronização lê o resultado completo da consulta, ela conta para o consumo de leituras do D1, e as condições WHERE ajudam a limitar os dados indexados.
Para quem isso é útil
A nova integração é adequada para equipes que já armazenam conteúdo estruturado no D1. Elas podem selecionar os registros que farão parte do conjunto de busca por meio de uma consulta ao banco e, em seguida, sincronizar o índice quando linhas forem adicionadas, alteradas ou excluídas. Por exemplo, um catálogo pode incluir apenas itens disponíveis para venda, enquanto uma central de ajuda pode incluir somente artigos publicados e suas categorias. Cada linha se torna um documento independente.
A integração ainda está em beta. Antes de colocá-la em produção, vale conferir se os valores de id são únicos e estáveis, selecionar apenas as colunas necessárias e avaliar como o tamanho do resultado e a frequência de sincronização afetarão o uso do D1. As atualizações do índice ocorrem no intervalo escolhido, e a leitura do resultado completo em cada sincronização consome leituras do D1.
Em resumo, o D1 agora pode ser uma fonte para o AI Search, e a consulta SQL define quais linhas do banco se tornam documentos de busca. Para equipes com conteúdo no D1, isso oferece uma forma direta de conectar os dados ao índice; no planejamento, é importante considerar o limite de linhas e o consumo de leituras do banco durante a sincronização.
