Performance-limieten & capaciteitsplanning¶
Dit document beschrijft de praktische performance-limieten van MetaVox bij het beheren van metadata over Nextcloud Team folders. Het behandelt bestanden per weergave, kolom-limieten, gelijktijdige-gebruikerscapaciteit en hardware-scaling-overwegingen. Waar van toepassing worden limieten vergeleken met SharePoint Online als referentiepunt.
Samenvatting¶
| Dimensie | MetaVox aanbevolen limiet | MetaVox harde limiet | SharePoint Online |
|---|---|---|---|
| Bestanden per weergave | 5.000 | Geen (geleidelijke degradatie) | 5.000 (geblokkeerd erboven) |
| Velden per team folder | Onbeperkt | Onbeperkt (EAV-model) | Beperkt door 8.000-byte rijgrootte |
Actieve filters (API sorted-file-ids) |
10 | ~15 voor merkbare vertraging | 12 join-operaties (geblokkeerd erboven) |
| Weergegeven kolommen | 10–20 | Geen harde limiet | Beperkt door rijgrootte |
| Gelijktijdige gebruikers (kleine folder) | 10–100 (hardware-afhankelijk) | N.v.t. | N.v.t. |
| Gelijktijdige gebruikers (grote folder) | 2–20 (hardware-afhankelijk) | N.v.t. | N.v.t. |
Kernpunt: SharePoint hanteert harde drempels — queries boven 5.000 items worden geweigerd. MetaVox heeft geen harde limieten; performance degradeert geleidelijk. De primaire bottleneck boven 5.000 bestanden is de Nextcloud-browser-side bestandenlijst, niet MetaVox zelf. Gebruik gefilterde weergaven om bestand-aantallen per weergave onder 5.000 te houden voor de beste ervaring.
SharePoint Online-referentielimieten¶
SharePoint Online hanteert de volgende harde limieten (Microsoft-documentatie):
| Beperking | Limiet | Gedrag bij overschrijding |
|---|---|---|
| List View Threshold | 5.000 items per weergave | Query wordt geblokkeerd |
| Admin override-threshold | 20.000 items | Query wordt geblokkeerd |
| Max items per lijst/bibliotheek | 30 miljoen | Kan geen items meer toevoegen |
| Rijgrootte-limiet | 8.000 bytes per item | Kan geen kolommen meer toevoegen |
| Lookup join-threshold | 12 join-operaties | Query wordt geblokkeerd (8+ lookup-kolommen) |
| Unieke permissies per lijst | 50.000 (aanbevolen: 5.000) | Performance-degradatie |
| Max bestandsgrootte | 250 GB | Upload geweigerd |
De List View Threshold is SharePoint's meest impact-volle limiet: elke weergave-, sort- of filter-operatie die meer dan 5.000 niet-geïndexeerde items raakt, wordt volledig geblokkeerd — niet vertraagd, maar geweigerd door de server.
MetaVox: bestanden per weergave¶
MetaVox handhaaft geen harde item-per-weergave-drempel. Performance degradeert geleidelijk naarmate folder-grootte stijgt. Er zijn vier onafhankelijke bottleneck-tiers:
Bottleneck 1: waarden laden met de maplijst¶
De metadata-waarden komen mee met de eigen maplijst van de Files-app. MetaVox voegt de WebDAV-property nc:metavox toe aan de PROPFIND (Depth 1) van de Files-app, en een server-plugin (MetadataPropertyPlugin.php) beantwoordt die voor maplijsten van teammappen: één toegangscontrole per bestand in het geheugen, daarna één database-query per 1.000 bestanden voor alle waarden. Elke waarde wordt in de maplijst afgekapt op 512 tekens; de cel markeert een afgekapte waarde, en de volledige waarde laadt als de cel wordt bewerkt.
Wat de maplijst niet levert (een bestand waarvoor de plugin niet kon instaan, of een maplijst die er was voordat MetaVox klaar stond), wordt als fallback via de API geladen: directory-metadata, maximaal 200 bestanden per request, gebundeld 50 ms na het laatst aangeboden bestand en uiterlijk 200 ms na het eerste.
| Bestanden in folder | Waarde-queries op de server | Extra API-calls bij open | Scroll-gedrag |
|---|---|---|---|
| 200 | 1 | 0 | Instant (gecached) |
| 1.000 | 1 | 0 | Instant (gecached) |
| 5.000 | 5 | 0 | Instant (gecached) |
| 10.000 | 10 | 0 | Instant (gecached) |
Let op: de waarden komen mee met de maplijst. Scrollen door de bestandenlijst triggert geen extra requests — alle data komt uit de in-memory cache. De MutationObserver detecteert virtual-scroll row-recycling (via
data-cy-files-list-row-fileidattribute-wijzigingen) en vult cellen direct uit de cache.
Bottleneck 2: Nextcloud-bestandenlijst¶
Nextcloud's Files-app laadt alle bestanden in een folder in een client-side dirContents-array. Dit is de primaire beperkende factor en is niet MetaVox-specifiek:
| Bestanden in folder | Nextcloud-gedrag |
|---|---|
| < 1.000 | Instant laden |
| 1.000–5.000 | 1–2 seconden laden |
| 5.000–10.000 | Merkbare vertraging, UI wordt traag |
| 10.000–50.000 | Multi-seconden laden, browser-geheugendruk |
| 50.000+ | Browser kan hangen of crashen |
Bottleneck 3: SQL filtering & sortering (API)¶
In de Files-app draaien filteren en sorteren op MetaVox-kolommen in de browser, over de waarden die het grid al heeft (FilterSortCore.js); een afgekapte waarde wordt gefilterd en gesorteerd zoals getoond. Konden niet alle waarden worden geladen, dan pauzeert het grid sorteren en filteren op MetaVox-kolommen en meldt dat.
Server-side filteren en sorteren gebruikt het OCS-endpoint sorted-file-ids. Dat werkt met een Entity-Attribute-Value (EAV) model met self-JOINs (FilterService.php). Met juiste database-indexen (toegevoegd in migratie Version20250101000010) schaalt query-performance logaritmisch:
| Metadata-records | 1 filter | 3 filters | 5 filters |
|---|---|---|---|
| 10.000 | < 10ms | < 20ms | < 50ms |
| 100.000 | < 50ms | < 100ms | < 200ms |
| 1.000.000 | ~200ms | ~400ms | ~800ms |
| 10.000.000 | ~1s | ~2s | ~4s |
Belangrijk: deze getallen gaan ervan uit dat de database-indexen uit
Version20250101000010actief zijn. Zonder indexen daalt performance met 40–100×.
Bottleneck 4: DOM-rendering¶
Nextcloud 33+ gebruikt virtual scrolling voor de bestandenlijst. MetaVox gebruikt een MutationObserver die luistert naar nieuwe rijen (childList) en row-recycling (attributes op data-cy-files-list-row-fileid). Wanneer een rij wordt gerecycled tijdens scrollen, worden de metadata-cellen direct bijgewerkt uit de in-memory cache zonder API-call. Slechts ~15–50 rijen bestaan in de DOM tegelijkertijd. Dit is geen bottleneck, ongeacht folder-grootte.
Gecombineerde praktische limieten¶
| Bestanden per weergave | MetaVox-status | SharePoint-status |
|---|---|---|
| < 1.000 | Uitstekend | OK |
| 1.000–5.000 | Goed | OK (nadert drempel) |
| 5.000–10.000 | Bruikbaar met vertragingen | Geblokkeerd (boven drempel) |
| 10.000–50.000 | Traag, niet aanbevolen | Geblokkeerd |
| 50.000+ | Onwerkbaar | Geblokkeerd |
Kernverschil: SharePoint blokkeert queries boven 5.000 items. MetaVox degradeert geleidelijk — performance wordt slechter, maar operaties worden nooit geweigerd.
Kolom- & veld-limieten¶
MetaVox veld-architectuur¶
MetaVox gebruikt een EAV (Entity-Attribute-Value) database-model. Metadata-velden worden als rijen opgeslagen, niet als database-kolommen. Dat betekent:
- Geen hardcoded maximum op het aantal velden per team folder
- Velden toevoegen verandert het database-schema niet
- Elke veld-waarde wordt opgeslagen als TEXT-type (geen vaste byte-limiet per waarde); de grid-maplijst bevat de eerste 512 tekens
| Beperking | MetaVox | SharePoint |
|---|---|---|
| Max velden/kolommen per lijst | Onbeperkt (EAV-model) | Beperkt door 8.000-byte rijgrootte |
| Veldnaam-lengte | 255 tekens | 255 tekens |
| Veldwaarde-grootte | TEXT (onbeperkt); 512 tekens in de grid-maplijst | Varieert per kolom-type |
| Lookup/join-threshold | Geen harde limiet | 12 join-operaties |
| Veldtypen | 10 (tekst, getal, textarea, datum, select, multi-select, checkbox, url, gebruiker, file-link) | 30+ |
Kolom-weergave¶
De frontend rendert metadata-kolommen via DOM-injectie met horizontaal scrollen. Er is geen hardcoded kolom-weergave-limiet:
- Minimum kolom-breedte: 60px
- Kolom-breedtes worden dynamisch berekend op basis van label-lengte en type
- Horizontaal scrollen met sticky headers ondersteund
- Kolom-breedtes worden per browser bewaard (local storage)
Praktische kolom-limieten¶
Hoewel er geen harde limiet is, gelden performance-overwegingen:
| Actieve kolommen | Effect |
|---|---|
| 1–10 | Geen impact |
| 10–20 | Bredere horizontaal-scroll-area, nog steeds performant |
| 20–30 | Maplijst-response groeit: elke niet-lege waarde voegt tot 512 tekens per bestand toe |
| 30+ | Overweeg weergaven te gebruiken om subsets te tonen |
Filter-performance vs. kolom-aantal (API)¶
Voor het endpoint sorted-file-ids voegt elke actieve filter één SQL-JOIN-operatie toe aan de query. Dat is daar de primaire scaling-factor voor kolom-aantal (het grid in de Files-app filtert in de browser en voegt geen JOINs toe):
| Actieve filters | SQL-JOINs | Performance-impact |
|---|---|---|
| 1–5 | 2–6 | Verwaarloosbaar met indexen |
| 5–10 | 6–11 | Minimaal, < 200ms bij 100K records |
| 10–15 | 11–16 | Merkbaar, queries kunnen 500ms overschrijden |
| 15+ | 16+ | Niet aanbevolen, overweeg herstructurering |
Vergelijking: SharePoint blokkeert queries wanneer meer dan 12 join-operaties vereist zijn (triggered bij 8+ lookup/persoon/workflow-kolommen). MetaVox blokkeert niet maar wordt langzaam boven ~15 actieve filters.
Gelijktijdige gebruikers¶
Per-gebruiker server-belasting¶
MetaVox injecteert initialisatie-data (groupfolders, en velden en weergaven per teammap) inline in de HTML via Nextcloud's IInitialState-mechanisme. Dit elimineert aparte API-calls voor de initiële page load. Navigeren naar een andere teammap gebruikt dezelfde data; een /api/init-call is alleen de fallback als die ontbreekt.
Elke gebruiker die een folder met metadata-kolommen opent genereert:
| Operatie | Extra API-calls | Database-queries |
|---|---|---|
| Folder open (eerste laad) | 0 (inline via IInitialState) | Uitgevoerd tijdens PHP page-render |
| Folder open (navigatie) | 0–1 (/api/init als fallback) |
~4 als die wordt aangeroepen (groupfolders, velden, weergaven, permissies) |
| Metadata-waarden (alle bestanden) | 0 (met de PROPFIND van de Files-app) | 1 per 1.000 bestanden, binnen de PROPFIND |
| Waarden die de maplijst miste | 0–1 per 200 bestanden | 1 per request |
| Filter-waarden (bij dropdown open) | 0 (in de browser berekend uit geladen waarden) | 0 |
| Totaal per folder-open | 0–1, plus fallbacks | ~1–5 |
Data-consistentie & real-time sync¶
Wanneer notify_push is geïnstalleerd en geconfigureerd, ondersteunt MetaVox real-time samenwerking:
- Cell-locking: wanneer een gebruiker een cel begint te bewerken, wordt die voor andere gebruikers gelockt (30-seconden TTL via Redis). Andere gebruikers zien een lock-indicator met de editor-naam.
- Real-time push: wijzigingen worden via WebSocket (notify_push) gemeld aan de gebruikers die de teammap open hebben: alleen bestands-id's, geen waarden. Hun browser laadt die bestanden opnieuw via de API. Geen polling nodig.
- Aanwezigheids-tracking: een teammap openen registreert de gebruiker; de heartbeat van de Gebruikersstatus-app van Nextcloud houdt de registratie in leven, en naar een andere teammap gaan of het tabblad sluiten beëindigt hem. Zonder de Gebruikersstatus-app blijft een registratie 12 uur staan.
- Graceful degradation: zonder notify_push wint de laatste write; wijzigingen van anderen verschijnen na navigeren of vernieuwen. Cell-locks weigeren nog steeds een tweede bewerker.
Zie Real-time sync voor volledige details.
Gelijktijdige-gebruikerscapaciteit¶
Capaciteit hangt sterk af van server-configuratie en folder-grootte:
Kleine folders (< 500 bestanden)¶
| Server-configuratie | Gelijktijdige gebruikers | Status |
|---|---|---|
| Single-core, 8 GB RAM | 10–15 | Goed |
| 4 cores, 16 GB RAM + Redis | 40–60 | Goed |
| 4 cores + aparte database | 80–100 | Goed |
Middelgrote folders (500–5.000 bestanden)¶
| Server-configuratie | Gelijktijdige gebruikers | Status |
|---|---|---|
| Single-core, 8 GB RAM | 3–5 | Traag |
| 4 cores, 16 GB RAM + Redis | 15–25 | Acceptabel |
| 4 cores + aparte database | 30–50 | Goed |
Grote folders (5.000+ bestanden)¶
| Server-configuratie | Gelijktijdige gebruikers | Status |
|---|---|---|
| Single-core, 8 GB RAM | 1–2 | Zeer traag |
| 4 cores, 16 GB RAM + Redis | 5–10 | Traag |
| 4 cores + aparte database | 10–20 | Acceptabel |
Let op: PHP verwerkt requests single-threaded. Op een single-core server worden requests sequentieel in een queue verwerkt. Meerdere cores laten PHP-FPM requests parallel afhandelen.
Hardware-scaling-impact¶
Wat helpt¶
| Upgrade | Impact | Waarom |
|---|---|---|
| Database op aparte server | Hoog | SQL-queries concurreren niet meer met PHP voor CPU/RAM |
| RAM (8 → 16+ GB) | Hoog | Grotere database buffer pool, meer PHP-workers |
| SSD/NVMe-storage | Hoog | Snellere database-I/O, vooral voor JOINs |
| Redis/APCu-caching | Hoog | MetaVox cachet veld-definities en weergaven (600s TTL), API-filterwaarden (300s) en API-sorteer-/filterresultaten (30s); aanwezigheid en cell-locks hebben het nodig |
| Meer CPU-cores | Middel | Helpt met gelijktijdige gebruikers (parallel PHP-FPM-workers), beperkte winst voor single-user performance |
Wat niet helpt¶
| Wijziging | Waarom beperkt effect |
|---|---|
| Meer CPU-cores (single user) | PHP is single-threaded per request |
| Meer netwerk-bandbreedte | Responses zijn klein: alleen niet-lege waarden, maximaal 512 tekens per waarde in de maplijst |
| CDN / edge caching | Metadata is dynamisch en gebruiker-specifiek |
Geschatte praktische limieten per hardware-tier¶
| Hardware | Bestanden per weergave | Gelijktijdige gebruikers | Actieve filters |
|---|---|---|---|
| Entry (1 core, 8 GB, lokale DB) | ~5.000 | ~10 | ~5 |
| Standaard (4 cores, 16 GB, Redis) | ~8.000 | ~40 | ~10 |
| Aanbevolen (4 cores, 16 GB, aparte DB, Redis) | ~10.000–15.000 | ~80 | ~15 |
Herinnering: de primaire bottleneck boven ~5.000 bestanden is Nextcloud's client-side bestandenlijst, niet MetaVox. Hardware-upgrades verbeteren MetaVox' backend-verwerking maar kunnen de browser-side-beperking niet wegnemen.
Best practices¶
-
Gebruik gefilterde weergaven om het aantal zichtbare bestanden per weergave onder 5.000 te houden. De MetaVox-backend kan miljoenen metadata-records opslaan en bevragen — de limiet zit in het browser-rendering.
-
Zorg dat database-indexen actief zijn. De indexen toegevoegd in migratie
Version20250101000010verbeteren filter-query-performance met 40–100×. Verifieer dat ze bestaan op demetavox_file_gf_meta-tabel. -
Schakel Redis of APCu-caching in in je Nextcloud-configuratie. MetaVox gebruikt gedistribueerde caching voor veld-definities en weergaven (600s TTL) en voor API-filterresultaten (30–300s); met meer dan één webserver hebben aanwezigheid en cell-locks een gedeelde cache zoals Redis nodig. Metadata-waarden worden altijd uit de database gelezen.
-
Beperk voor de
sorted-file-ids-API actieve filters tot 10 of minder. Elke filter voegt een SQL-JOIN toe. Performance blijft uitstekend tot ~10 filters maar degradeert boven 15. -
Gebruik de weergaven-feature om alleen relevante kolommen per use case te tonen, in plaats van alle velden tegelijk. Dit verbetert rendering-performance.
-
Voor multi-user bewerken, installeer notify_push voor real-time sync en cell-locking. Zonder geldt last-write-wins.
-
Overweeg folder-structuur. Grote collecties splitsen over meerdere folders (elk onder 5.000 bestanden) is effectiever dan alleen vertrouwen op hardware-upgrades.