Michael JohnsonHvis applikasjonen din henter ut store resultater fra Cloudflare D1 med én enkelt spørring, bør du sjekke den før 4. november: Fra denne datoen vil spørringer som returnerer mer enn 50 MB, feile. Endringen gjelder størrelsen på resultatet, ikke databasestørrelsen eller omfanget av API-forespørselen; import og eksport via REST API fortsetter som før.
Hva er det som endres?
Cloudflare kunngjorde begrensningen 30. oktober 2026. Den nye regelen trer i kraft onsdag 4. november: Hvis resultatet av en SQL-spørring overstiger 50 MB, vil D1 returnere feilmeldingen D1 query result exceeded the maximum response size limit of 50 MB. Selskapet opplyser at grensen dekker den 99,999. persentilen av D1-spørringer, noe som betyr at det store flertallet fortsatt ligger under grensen. Dette er Cloudflares anslag for plattformen, ikke en garanti for den enkelte applikasjonen.
Det er viktig å skille mellom resultatet av en spørring og overføring av data. Begrensningen gjelder resultatet som en D1-spørring returnerer; operasjoner for import og eksport via REST API er uttrykkelig unntatt. Derfor bør du først og fremst kontrollere applikasjonsspørringer som leser mange rader eller brede poster og deretter henter alt på én gang.
Hvorfor et stort resultat kan oppstå uten at du merker det
Svaret bestemmes ikke bare av antallet rader. En spørring med mange kolonner kan returnere et stort resultat selv med et moderat antall poster, særlig hvis radene inneholder lange tekststrenger eller andre store verdier. Konstruksjonen SELECT * tar med alle kolonnene, selv om den som kaller spørringen, kanskje bare trenger noen få. Når tabellen vokser over tid, kan en spørring som tidligere var trygg, også passere grensen.
Den praktiske konsekvensen er at du bør kontrollere både engangsuttrekk for administrasjon og regelmessige operasjoner i applikasjonen – for eksempel rapportbehandlere, bakgrunnsjobber og API-metoder som samler data for videre behandling. Dette er scenarioer som bør revideres, ikke en påstand om at alle nødvendigvis blir berørt.
Slik klargjør du spørringene
I kunngjøringen anbefaler Cloudflare å begrense datasettet som returneres: Velg nødvendige kolonner i stedet for å bruke SELECT *, og del store uttrekk opp i sider med LIMIT og OFFSET. Dette reduserer størrelsen på hvert enkelt svar og gjør det mulig å fordele behandlingen over flere spørringer.
- Finn brede uttrekk. Gå gjennom spørringer med
SELECT *, uten begrensning på antall rader eller med store tekstfelt. - Begrens kolonnene. Ta bare med kolonnene som faktisk trengs i neste behandlingstrinn.
- Del lesingen opp i mindre deler. Legg til sideinndeling med
LIMITogOFFSET, slik Cloudflare foreslår, og behandle delene fortløpende. - Kontroller hvordan oppdelingen fungerer. Forsikre deg om at applikasjonen setter sammen resultatene riktig, og ikke forutsetter at hele uttrekket kommer i ett svar.
Hvis applikasjonen trenger hele datasettet til et eget uttrekk, bør du undersøke om eksport via REST API passer til oppgaven: Cloudflare opplyser særskilt at den nye grensen ikke gjelder denne operasjonen. For vanlig applikasjonslogikk erstatter ikke dette unntaket behovet for å gjennomgå store SQL-svar.
Hvem gjelder fristen for?
Fristen gjelder direkte for D1-brukere med spørringer som returnerer mer enn 50 MB. Først bør du kontrollere kode der resultatet lastes inn i minnet i sin helhet, sendes mellom komponenter eller genereres for en rapport. Hvis spørringene allerede bare returnerer små sider og nødvendige felt, er det kanskje ikke nødvendig med noen særskilt endring; beslutningen bør baseres på den faktiske størrelsen på svarene fra spørringene dine.
En kontroll før 4. november gjør det mulig å oppdage avhengigheter av ett stort svar før begrensningen trer i kraft. Ifølge Cloudflares anslag ligger grensen langt over det vanlige omfanget for de fleste spørringer. For systemer som blir berørt, er den mest direkte planen å redusere datamengden som velges, lese den i mindre deler eller bruke REST API-eksport for uttrekk.
