Los de Nextcloud-waarschuwing "Database mist enkele indexen" op.

Je opent het beheerdersoverzicht van Nextcloud en ziet: "Er ontbreken enkele indexen in de database." Deze waarschuwing kan na een upgrade verschijnen, omdat Nextcloud in de loop van de tijd nieuwe indexen aan bestaande tabellen kan toevoegen en deze niet altijd automatisch aanmaakt in een grote database. Ontbrekende indexen kunnen sommige databasequery's vertragen. De ondersteunde herstelmethode is het ingebouwde occ db:add-missing-indicescommando.

Voordat u het schema wijzigt, controleert u of u de opdracht uitvoert voor de juiste Nextcloud-installatie, maakt u een back-up van de database en gebruikt u de gebruiker van het besturingssysteem van de webserver. In versies waar de opdracht dit ondersteunt, kunt u de voorgestelde SQL-query bekijken met --dry-run. Voer vervolgens de reparatie uit en controleer het beheerdersoverzicht opnieuw.

Wat de waarschuwing betekent

Een database-index is een structuur die de database helpt rijen te vinden zonder de hele tabel te hoeven doorzoeken. Nextcloud en de bijbehorende apps definiëren indexen voor de tabellen en velden die ze gebruiken. Wanneer een nieuwere Nextcloud-release of app-versie een index introduceert die een bestaande installatie nog niet heeft, kan de beheerderspagina een melding geven van deze inconsistentie. Dit is een waarschuwing voor schemaonderhoud; op zichzelf betekent dit niet dat de database beschadigd is of dat er gebruikersbestanden ontbreken.

Volgens de beheerdershandleiding van Nextcloud kunnen indexen in de loop van de tijd worden toegevoegd, bijvoorbeeld om de prestaties te verbeteren, en worden beheerders geadviseerd om de volgende opdracht uit te voeren occ db:add-missing-indices: . Het toevoegen van een index kan tijdrovend zijn, vooral bij een grote tabel, en de belasting van de database of het vergrendelingsgedrag kan variëren afhankelijk van de database-engine en de werkbelasting. Plan de wijziging tijdens een rustigere periode als uw instantie drukbezet is.

Voordat u de reparatie uitvoert

• Controleer het installatiepad en de versie. Voer de opdrachten uit vanuit de map waarin het installatiescript zich bevindt occ, of geef het volledige pad op.
• Maak een back-up van de database. Gebruik hiervoor uw gebruikelijke back-upprocedure voor MariaDB/MySQL, PostgreSQL of SQLite. Controleer of de back-up is voltooid en of u weet hoe u deze kunt herstellen.
• Zoek de HTTP-gebruiker. Gebruik het account dat de webserver voor Nextcloud uitvoert. Veelvoorkomende voorbeelden zijn www-dataDebian of Ubuntu, apacheFedora of CentOS, httpArch Linux en wwwrunopenSUSE. Uw implementatie kan afwijken.
• Controleer de beschikbare opdrachtopties. De stabiele beheerhandleiding van Nextcloud 35 beschrijft deze --dry-run. Als uw geïnstalleerde versie de optie niet herkent, raadpleeg dan occ db:add-missing-indices --helpde uitvoer van die versie en sla de preview over in plaats van aan te nemen dat de optie bestaat.

De officiële back-uphandleiding vermeldt de database, configuratie, gegevensdirectory en andere installatiecomponenten die bewaard moeten blijven voor een volledige back-up. Maak voor deze schema-bewerking minimaal een geteste databaseback-up met behulp van de procedure die geschikt is voor uw database.

Stap 1: Open een shell in de Nextcloud-installatie.

Voor een traditionele Linux-installatie maakt u via SSH verbinding met de server en navigeert u naar de Nextcloud-directory. Een veelgebruikt Ubuntu-pad is /var/www/nextcloud, maar gebruik het pad op uw server.

cd /var/www/nextcloud
sudo -E -u www-data php occ status

Controleer of de statusuitvoer de verwachte geïnstalleerde instantie identificeert. Als u een andere PHP-binary voor de webserver gebruikt dan de standaardversie van de shell php, gebruik dan dezelfde compatibele PHP-versie occ. Door occals HTTP-gebruiker te werken, blijven de verwachte bestandsrechten en -eigendom behouden.

Stap 2: Bekijk de indexwijzigingen

Als uw geïnstalleerde versie dit ondersteunt, voer dan eerst de test uit:

sudo -E -u www-data php occ db:add-missing-indices --dry-run

De testrun toont een voorbeeld van de SQL-instructies zonder ze daadwerkelijk uit te voeren. Lees de uitvoer en controleer of deze betrekking heeft op de ontbrekende indexen die u wilt herstellen. Als de uitvoer een tabel of index identificeert die u niet herkent, noteer dan de exacte naam en controleer of de betreffende applicatie is geïnstalleerd en up-to-date is. Plak de SQL-instructies uit de testrun niet rechtstreeks in de databaseconsole als snelkoppeling.

Stap 3: Voeg de ontbrekende indexen toe

Wanneer de preview wordt verwacht en de back-up gereed is, voert u de gedocumenteerde reparatieopdracht uit:

sudo -E -u www-data php occ db:add-missing-indices

De opdracht controleert de databasetabellen en maakt indexen aan die in het schema zijn gedefinieerd maar ontbreken in de huidige installatie. Laat het proces voltooien. Bij een grote database kan dit even duren. Vermijd het onderbreken van het proces terwijl het schema wordt gewijzigd. De documentatie van Nextcloud geeft aan dat deze opdracht kan worden uitgevoerd terwijl de instantie online blijft; de onderhoudsmodus wordt niet vermeld als een vereiste voor deze specifieke reparatie. Volg uw eigen wijzigingsbeheerprocedure als een onderhoudsperiode nodig is.

Docker en andere installatietypen

Bij een implementatie in een container moet je de Nextcloud-applicatie uitvoeren occin de Nextcloud-applicatiecontainer, niet in de databasecontainer. Container- en servicenamen kunnen variëren, dus controleer je implementatie en vervang de naam door de juiste. Voor een Docker-container met de naam nextcloudis het patroon als volgt:

docker exec --user www-data nextcloud php occ db:add-missing-indices

Voor Docker Compose is het overeenkomstige patroon docker compose exec -u www-data <nextcloud-service> php occ db:add-missing-indices. Sommige pakketimplementaties gebruiken een specifiek commando of een andere containergebruiker; volg de instructies voor dat specifieke pakket. Kopieer geen containernaam van de configuratie van iemand anders zonder deze eerst te controleren.

Als de opdracht mislukt of de waarschuwing blijft staan

• Toegang geweigerd: Controleer de HTTP-gebruiker en het installatiepad. Los dit niet op door de opdracht als root uit te voeren, tenzij de documentatie van uw implementatie specifiek een geprivilegieerde wrapper vereist; het PHP-proces moet over het algemeen worden uitgevoerd als de webservergebruiker.
• Databaseverbindings- of PHP-fout: Controleer het Nextcloud-logboek, de status van de databaseservice, de geconfigureerde PHP-versie en de uitvoer van de opdracht. Los het onderliggende verbindings- of runtimeprobleem op voordat u de schema-opdracht opnieuw uitvoert.
• Foutmelding 'Duplicate key' of 'unique-index': Stop en bewaar de volledige foutmelding. Deze kan duiden op conflicterende rijen die voorkomen dat een unieke index wordt aangemaakt. Identificeer de betreffende app en tabel, controleer de app- en Nextcloud-versies en raadpleeg de beheerder van de app of een beheerder die bekend is met de database. Verwijder geen rijen of indexen zonder een dataspecifieke diagnose en back-up.
• "Opdracht niet gevonden" of niet-ondersteunde optie: Controleer of u zich in de juiste Nextcloud-installatie bevindt en controleer php occ listof php occ help db:add-missing-indicesu bent ingelogd als HTTP-gebruiker. Oudere versies tonen mogelijk niet alle nieuwere opties.
• De waarschuwing blijft verschijnen: Vernieuw het beheerdersoverzicht nadat de opdracht succesvol is afgesloten. Lees de exacte index- en tabelnamen in de waarschuwing. Er kunnen meerdere ontbrekende indexen zijn, een nieuw geïntroduceerde index na een app-update, een mislukte databasebewerking of een schema-mismatch die deze opdracht niet heeft opgelost.

Verwar ontbrekende indexen niet met ontbrekende kolommen of primaire sleutels. Nextcloud documenteert aparte commando's voor deze schemawijzigingen, zoals db:add-missing-columnsen db:add-missing-primary-keys. Voer alleen een ander reparatiecommando uit als de beheerderswaarschuwing of de versiespecifieke documentatie daarom vraagt.

Controleer het resultaat

1. Wacht tot db:add-missing-indicesde afsluiting en de melding van voltooiing, zoals bijvoorbeeldDone.
2. Herlaad het beheerdersoverzicht en controleer of de specifieke waarschuwing voor de ontbrekende index is verdwenen.
3. Als het probleem zich blijft voordoen, vergelijk dan de exacte tabel- en indexnamen met de uitvoer van het commando in plaats van het blindelings opnieuw uit te voeren.
4. Controleer het Nextcloud-logboek en de databasestatus op nieuwe fouten en bevestig vervolgens dat normale bestandstoegang en de apps die de betreffende tabellen gebruiken nog steeds werken.
5. Bewaar de back-up totdat het systeem weer normaal functioneert en uw bewaarbeleid het verwijderen ervan toestaat.

Voor de huidige commandosyntaxis raadpleegt u de Nextcloud-database- en indexeringsopdrachtreferentie . Voor gebruikers- en PHP-vereisten raadpleegt u ' Het occ-commando gebruiken' en de Nextcloud-back-uphandleiding . Deze stabiele pagina's geven aan dat de huidige handleiding Nextcloud Server 35 is wanneer deze op 6 oktober 2026 wordt gecontroleerd; paden, opties en verpakkingsinstructies kunnen verschillen in andere releases of implementatietypen.