데이터는 있는데 조회가 실패한다면…D1의 11월 4일 변경 확인하세요

Cloudflare D1으로 관리 화면이나 보고서를 운영한다면, 많은 데이터를 한꺼번에 가져오는 기능부터 점검할 때입니다. 11월 4일부터 한 번의 쿼리 결과가 50MB를 넘으면 오류가 발생합니다. 저장된 데이터가 사라지는 변화가 아니라, 데이터를 한 번에 꺼내오는 크기에 제한이 생기는 것입니다.

저장 용량이 아니라, 한 번에 받는 결과의 크기입니다

Cloudflare D1 공식 변경 공지의 시행일, 50MB 제한, REST API 예외와 권장 조치 실제 본문 캡처 — 11월 4일 적용 조건과 예외 · Cloudflare 공식 문서

Cloudflare의 10월 30일 공식 공지는 시행일과 오류 조건을 안내했습니다. 이번 제한은 데이터베이스 전체 크기가 아니라 쿼리가 반환하는 결과에 적용됩니다. 따라서 데이터베이스가 크다는 이유만으로 모든 조회가 실패하는 것은 아닙니다.

Cloudflare는 대부분의 D1 사용자는 영향을 받지 않을 것으로 안내했습니다. 모든 서비스를 바꾸기보다 큰 결과를 한꺼번에 받는 경로부터 확인하면 됩니다.

점검은 전체 기간 보고서와 일괄 조회부터

데이터베이스에서 큰 결과를 한 번에 가져오는 방식과 작은 묶음으로 나누어 가져오는 방식을 표현한 개념도 — 저장된 데이터와 한 번의 조회 결과는 다릅니다 · 개념도

예를 들어 관리자가 전체 기간의 주문을 조회하는 화면을 생각해볼 수 있습니다. 화면에는 주문일과 상태만 필요하지만, 구현에서는 상세 설명을 포함한 모든 열을 한꺼번에 가져올 수도 있습니다. 이런 경로가 있다면 필요한 열만 선택하고 조회 범위를 나누는 것이 첫 점검 대상입니다.

실제 영향을 판단하려면 서비스가 반환하는 결과의 크기와 요청 방식을 확인해야 합니다.

Cloudflare는 필요한 열만 선택하고 큰 결과 집합을 페이지로 나눌 것을 제안합니다. 다만 행마다 데이터 크기가 다르므로 ‘몇 행까지는 안전하다’고 일괄 정할 수는 없습니다. 페이지 분할을 적용한 뒤에도 결과 크기와 오류 처리를 함께 시험하는 편이 좋습니다.

‘내보내기’ 버튼이 있다고 예외는 아닙니다

공식 안내에 따르면 REST API를 통한 가져오기·내보내기 작업은 이번 제한의 예외입니다. 여기서 중요한 것은 버튼의 이름이 아니라 실제 호출하는 작업입니다.

일반 조회 결과를 받아 파일로 만드는 기능과, 문서에 명시된 REST API 내보내기는 구분해서 봐야 합니다. 기존 기능이 어느 방식으로 구현되어 있는지 확인한 뒤 대응을 정해야 합니다. 모든 내보내기가 막힌다거나, 파일을 만드는 조회는 모두 예외라고 해석하면 안 됩니다.

D1 공식 제한 문서