Cloudflare D1 stelt een limiet aan queryresultaten: wat u vóór 4 november moet controleren

Als uw toepassing grote resultaten uit Cloudflare D1 met één query ophaalt, controleer die dan vóór 4 november: vanaf die datum mislukt een query die meer dan 50 MB retourneert. De wijziging betreft de grootte van het resultaat, niet de grootte van de database of de omvang van het API-verzoek; import en export via de REST API blijven zich gedragen zoals voorheen.

Wat verandert er precies?

Cloudflare kondigde de beperking aan op 30 oktober 2026. De nieuwe regel gaat in op woensdag 4 november: als het resultaat van een SQL-query groter is dan 50 MB, retourneert D1 de foutmelding D1 query result exceeded the maximum response size limit of 50 MB. Het bedrijf geeft aan dat deze drempel het 99,999e percentiel van D1-query’s omvat, wat betekent dat veruit de meeste query’s onder de limiet blijven. Dit is een schatting van Cloudflare op basis van haar platform, geen garantie voor een afzonderlijke toepassing.

Het onderscheid tussen een queryresultaat en gegevensoverdracht is belangrijk. De beperking geldt voor het resultaat dat een D1-query retourneert; import- en exportbewerkingen via de REST API zijn uitdrukkelijk van de regel uitgesloten. Controleer daarom vooral toepassingsquery’s die veel rijen of brede records uitlezen en deze vervolgens in hun geheel ophalen.

Waarom een groot resultaat ongemerkt kan ontstaan

De omvang van het antwoord hangt niet alleen af van het aantal rijen. Een query met veel kolommen kan zelfs bij een gematigd aantal records een groot resultaat opleveren, vooral als de rijen lange tekst of andere omvangrijke waarden bevatten. De constructie SELECT * neemt alle kolommen mee, ook als de aanroepende code er maar enkele nodig heeft. Ook kan een tabel door groei na verloop van tijd een voorheen veilige query over de drempel duwen.

De praktische conclusie: controleer niet alleen eenmalige administratieve exports, maar ook terugkerende bewerkingen van de toepassing, zoals rapportageverwerkers, achtergrondtaken en API-methoden die gegevens verzamelen voor verdere verwerking. Dit zijn aandachtspunten voor een audit, geen bewering dat elk van deze gevallen daadwerkelijk wordt geraakt.

Zo bereidt u uw query’s voor

In de aankondiging raadt Cloudflare aan de geretourneerde dataset te verkleinen: selecteer de benodigde kolommen in plaats van SELECT * te gebruiken en verdeel grote resultaten in pagina’s met LIMIT en OFFSET. Zo wordt één antwoord kleiner en kan de verwerking over meerdere query’s worden verdeeld.

1. Zoek brede selecties op. Bekijk query’s met SELECT *, zonder beperking van het aantal rijen of met grote tekstvelden.
2. Beperk de geselecteerde kolommen. Vermeld alleen de kolommen die de volgende verwerkingsstap daadwerkelijk nodig heeft.
3. Verdeel het uitlezen in porties. Voeg paginering toe met LIMIT en OFFSET, zoals Cloudflare voorstelt, en verwerk de porties achtereenvolgens.
4. Controleer het gedrag na het opdelen. Zorg ervoor dat de toepassing de resultaten correct samenvoegt en er niet van uitgaat dat de volledige dataset in één antwoord wordt ontvangen.

Als de toepassing voor een afzonderlijke export de volledige dataset nodig heeft, controleer dan of de exportbewerking via de REST API daarvoor geschikt is: Cloudflare meldt afzonderlijk dat de nieuwe limiet daarop niet van toepassing is. Voor de gewone toepassingslogica is deze uitzondering geen vervanging voor het herzien van grote SQL-antwoorden.

Voor wie geldt de deadline?

De deadline geldt rechtstreeks voor D1-gebruikers van wie query’s meer dan 50 MB retourneren. Controleer eerst code die het volledige resultaat in het geheugen laadt, tussen componenten doorgeeft of voor een rapport samenstelt. Als query’s al alleen kleine pagina’s en de benodigde velden retourneren, is mogelijk geen specifieke wijziging nodig; de feitelijke omvang van de antwoorden van uw query’s is bepalend.

Door vóór 4 november te controleren, kunt u afhankelijkheid van één groot antwoord opsporen voordat de beperking ingaat. Volgens de schatting van Cloudflare blijft de drempel voor de meeste query’s ruim boven het gebruikelijke volume; voor systemen die wel worden geraakt, is het meest directe plan om de geselecteerde gegevens te beperken, ze in porties uit te lezen of voor exports de daarvoor bedoelde route via de REST API te gebruiken.