D1 데이터를 AI 검색에 연결합니다, Cloudflare 베타에서 먼저 정할 공개 범위

AI 생성 이미지

도움말이나 상품 정보를 데이터베이스에 쌓아 두었는데, AI 검색을 붙이려면 다시 파일로 내보내야 할까요? Cloudflare가 11월 12일 AI Search의 D1 데이터 소스 베타를 발표했습니다. 지정한 읽기 전용 쿼리의 결과를 행별 문서로 색인합니다. 질문할 때마다 원본 DB를 조회하는 기능이 아니라, 검색용 자료를 따로 만들고 갱신하는 방식입니다. Cloudflare 발표

연결보다 먼저 정할 것은 검색에 내보낼 내용입니다

D1은 Cloudflare의 SQL 데이터베이스입니다. 이번 연결은 이미 D1에 콘텐츠를 관리하는 팀이 검토할 선택지입니다. 다른 데이터베이스를 쓰는 팀까지 이 기능만을 위해 이전할 필요는 없습니다.

예를 들어 공개 도움말과 내부 검토 메모가 한 테이블에 있다고 해보겠습니다. 검색에는 발행된 도움말의 제목과 본문만 보내고 싶을 것입니다. 이때 필요한 것은 테이블 전체 연결이 아니라, 공개할 행과 열을 고르는 기준입니다. 읽기 전용이라는 말은 데이터를 수정하지 않는다는 뜻이지, 비공개 내용의 노출까지 막아 준다는 뜻은 아닙니다.

연결에는 같은 계정의 D1, 서비스 API 토큰, 안정적인 고유 id가 필요합니다. 쿼리는 단일 읽기 문장이어야 하며 ORDER BY나 LIMIT를 쓰지 않습니다. D1 연결 문서

모든 행을 숨겼는데 기존 답변은 남을 수 있습니다

정상 동기화에서는 결과에서 빠진 행도 전체 읽기가 끝난 뒤 삭제됩니다. 그러나 쿼리가 실패하거나 결과가 0행이면 작업이 오류로 끝나고 기존 색인은 유지됩니다. 인스턴스 한도에 도달한 동기화에서도 삭제가 수행되지 않습니다. 동기화 조건

예를 들어 도움말을 모두 비공개로 전환해 쿼리 결과가 비었다면, 그것만으로 기존 검색 자료까지 지워졌다고 판단하면 안 됩니다. 긴급히 노출을 중단해야 할 때는 원본 수정과 별개로 검색 서비스의 접근 차단·자료 제거 절차를 확인해야 합니다.

기본 동기화 주기는 24시간이며 설정 가능한 주기는 15분부터 24시간까지입니다. 수동 요청도 곧바로 완료를 뜻하지는 않습니다. Jobs의 결과와 실제 검색 응답을 함께 확인해야 합니다. 동기화 문서

비용도 수정한 행 수만으로 판단하면 안 됩니다

매 동기화는 전체 쿼리 결과를 최소 두 번 읽고, 이 사용량은 D1의 읽기 사용량에 포함됩니다. 따라서 내용이 거의 바뀌지 않는 카탈로그라도 짧은 간격으로 반복 읽으면 사용량이 쌓입니다. 변경량뿐 아니라 결과 규모와 실행 빈도를 함께 보는 이유입니다. D1 읽기 조건

처음에는 공개해도 되는 작은 자료로 추가·수정·삭제를 시험하고, 0행과 실패 상황도 따로 확인하는 편이 좋습니다. 검색 결과의 정확성, 공개 범위, 갱신 완료 여부, D1 사용량이 기대와 맞는지 비교해 보세요. 이 네 가지가 확인돼야 파일 내보내기를 줄이는 편의가 실제 운영의 이점으로 이어질 수 있습니다.

이어볼 뉴스

문서를 고쳤는데 AI 검색에는 예전 내용이? Cloudflare 동기화 주기부터 확인하세요

#Cloudflare #D1 #AISearch #데이터검색 #콘텐츠운영