Wis de Nextcloud-waarschuwing voor ontbrekende database-indexen.

Verwijder de Nextcloud-waarschuwing "Database mist enkele indexen" door de opdracht uit te voeren occ db:add-missing-indicesals de webservergebruiker van de juiste Nextcloud-installatie. De opdracht voegt indexen toe die zijn gedefinieerd door Nextcloud of geïnstalleerde apps, maar die ontbreken in de database; in de huidige Nextcloud 35-documentatie --dry-runwordt de SQL-query weergegeven voordat deze wordt uitgevoerd.

Wat de waarschuwing betekent

Een database-index is een opzoekstructuur die de database helpt rijen te vinden zonder de hele tabel te hoeven doorzoeken. Nextcloud en de bijbehorende apps voegen soms indexen toe om query's te verbeteren. Bij een upgrade kan dit werk aan een beheerder worden overgelaten, omdat het aanmaken van een index op een grote tabel tijdrovend kan zijn en de prestaties kan beïnvloeden. De waarschuwing voor een ontbrekende index is meestal een onderhoudsmelding en geen bewijs dat bestanden of databasegegevens beschadigd zijn.

De huidige databasehandleiding van Nextcloud beschrijft db:add-missing-indiceshet toevoegen van indexen die zich in het verwachte schema bevinden, maar ontbreken in de huidige installatie. De handleiding beschrijft ook --dry-runhoe SQL-instructies kunnen worden bekeken. De exacte indexen zijn afhankelijk van uw Nextcloud-versie en de geïnstalleerde apps.

Bereid de server voor.

• Controleer bij welke Nextcloud-instantie de waarschuwing verschijnt, vooral als u een staging- en productieomgeving beheert of meer dan één container gebruikt.
• Zorg ervoor dat er een recente back-up van de database bestaat en dat u weet hoe u deze kunt herstellen. Deze opdracht wijzigt de databasestructuur. Bewerk of verwijder indexen niet handmatig als alternatief.
• Plan om de opdracht uit te voeren wanneer de databasebelasting redelijk is. De server kan tijdens deze bewerking online blijven volgens de upgrade-richtlijnen van Nextcloud, maar het indexeren van een grote tabel kan tijdrovend zijn en de reactiesnelheid tijdelijk beïnvloeden.
• Zoek de installatiemap van Nextcloud, de PHP CLI-versie die door de webserver wordt gebruikt en het account van het besturingssysteem van de webserver. Dit account is vaak te vinden www-dataop Debian of Ubuntu, apacheop Fedora of CentOS, en httpop Arch Linux.

De OCC-handleiding van Nextcloud legt uit dat dit occde opdrachtregelinterface van de server is en moet worden uitgevoerd als de HTTP-gebruiker, zodat bestandseigendom en -rechten consistent blijven. Gebruik dit niet www-datablindelings als uw installatie een ander account gebruikt.

Bekijk de preview en voeg de ontbrekende indexen toe.

Voor een standaard archiefinstallatie op Debian of Ubuntu opent u een shell op de Nextcloud-server en navigeert u naar de map waarin het occbestand zich bevindt. In dit voorbeeld wordt gebruikt /var/www/nextcloud; uw pad kan afwijken.

cd /var/www/nextcloud
sudo -E -u www-data php occ db:add-missing-indices --dry-run

De testrun print de SQL-query die zou worden uitgevoerd zonder de database te wijzigen. Lees de uitvoer en bevestig dat dit de verwachte onderhoudsbewerking is. De --dry-runoptie is gedocumenteerd in de huidige Nextcloud 35-handleiding; als een oudere versie deze optie afwijst, raadpleeg dan de helpfunctie van die versie in plaats van willekeurig opties te verwijderen.

Wanneer u klaar bent om de wijziging toe te passen, voert u de opdracht uit zonder --dry-run:

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

Nextcloud controleert de relevante tabellen en rapporteert de voortgang. Laat het proces voltooien; onderbreek het niet alleen omdat een grote tabel langer duurt dan verwacht. In de upgradehandleiding staat deze opdracht vermeld als een van de langere schemataken die kunnen worden uitgevoerd terwijl de instantie online blijft, dus u hoeft normaal gesproken de onderhoudsmodus niet in te schakelen voor deze reparatie. Vermijd gelijktijdige databaseonderhoudstaken terwijl dit proces loopt.

Als Nextcloud in Docker draait

Voer dit uit occin de Nextcloud-applicatiecontainer, niet in de aparte databasecontainer. Voor een container nextcloudmet de gebruikelijke www-dataaccountnaam is het commando doorgaans als volgt:

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

Vervang dit nextclouddoor de daadwerkelijke naam van uw applicatiecontainer. Als uw image of implementatie een andere containergebruiker, PHP-binary of command wrapper gebruikt, raadpleeg dan de documentatie van die image en zorg ervoor dat de opdracht wordt uitgevoerd als de HTTP-gebruiker.

Controleer of de waarschuwing verdwenen is.

Nadat de opdracht is voltooid, vernieuw je de beheerdersinstellingen > Overzicht . Het bericht over de ontbrekende index zou moeten verdwijnen zodra Nextcloud de indexen herkent. Je kunt de opdracht ook opnieuw uitvoeren; deze zou moeten worden voltooid zonder dat je dezelfde ontbrekende indexen opnieuw hoeft toe te voegen. Dit bevestigt dat de schemacontrole is bijgewerkt, hoewel het geen algehele databaseprestatie meet.

Als de waarschuwing blijft bestaan

1. Controleer of u de opdracht hebt uitgevoerd op dezelfde Nextcloud-installatie en -database die de waarschuwing hebben gegenereerd. Een veelgemaakte fout is het uitvoeren van de opdracht in een onderhoudscontainer, staging-instantie of databasecontainer.
2. Controleer of de opdracht is uitgevoerd door de juiste webservergebruiker en of dezelfde PHP-versie is gebruikt als de webserver. Nextcloud merkt op dat een afwijkende PHP-configuratie voor de commandline occfouten kan veroorzaken.
3. In Nextcloud 35 en later kunt u de controle uitvoeren sudo -E -u www-data php occ db:schema:checkom schemaverschillen te inspecteren. De huidige documentatie geeft aan dat deze controle is toegevoegd in versie 35. Voor eerdere versies kunt u de diagnostische tools gebruiken die voor die versie zijn gedocumenteerd.
4. Als de ontbrekende index bij een app van een derde partij hoort of als de opdracht een foutmelding geeft, werk de app dan bij als er een update beschikbaar is, controleer het Nextcloud-logboek en de uitvoer van de opdracht, en vraag de app-beheerder of Nextcloud-ondersteuning om de exacte index- en tabelnamen. Voer geen handgeschreven CREATE INDEXinstructies uit, tenzij de app- of databasebeheerder deze voor uw specifieke schema heeft verstrekt.

Voor een productieserver is het raadzaam de databaseback-up te bewaren totdat de waarschuwing is verdwenen en de applicatie weer normaal functioneert. De upgradehandleiding van Nextcloud beschrijft de online onderhoudstaak en de optionele testrun.