Tabellen und Spalten in Directus sicher umbenennen (ohne alles zu zerstören)

Wer schon einmal versucht hat, eine Tabelle oder Spalte in Directus umzubenennen, kennt das Problem: Directus behandelt eine Umbenennung als strukturelle Änderung. Relationen, Berechtigungen, Automatisierungen und Ihre gesamte Anwendung können sofort brechen. Jahrelang war das eine der am häufigsten gewünschten Funktionen in der Directus-Community – ohne eingebaute Lösung und ohne verlässliche Erweiterung.

Wir sind in fast jedem Kundenprojekt genau darauf gestoßen. Also haben wir eine Lösung gebaut und als kostenlose Open-Source-Erweiterung für alle veröffentlicht.

Das Problem: Directus kennt kein sicheres Umbenennen

Benennen Sie eine Collection oder ein Feld in Directus um, erzeugt das System eine neue Tabelle oder Spalte und lässt die alte zurück. Alle Fremdschlüsselrelationen, eigenen API-Endpunkte, Anzeigeeinstellungen und abhängigen Funktionen sind beschädigt. Diese Verweise manuell zu korrigieren ist fehleranfällig und zeitaufwendig – besonders bei großen Datenbanken mit Dutzenden verknüpfter Collections.

Vorhang auf: die Erweiterung Directus Safe Rename

Unsere directus-extension-safe-rename ist eine kostenlose Open-Source-Erweiterung für Directus, mit der Sie Collections und Felder sicher umbenennen. Sie führt alle internen Verweise, Relationsaktualisierungen und Berechtigungszuordnungen automatisch mit.

Was sie leistet

Die Erweiterung stellt sicher, dass beim Umbenennen einer Collection oder eines Feldes:

• Alle Fremdschlüsselrelationen auf den neuen Namen zeigen
• Berechtigungen und Policies erhalten bleiben
• Eigene Endpunkte und Automatisierungen weiterarbeiten
• Bestehende Daten sicher und ohne Verlust übernommen werden
• Systemcollections und kritische Felder vor versehentlicher Umbenennung geschützt sind

Warum wir sie gebaut haben

Wir bauen individuelle Lösungen auf Directus für Kunden in ganz Europa. Mit wachsender Projektkomplexität wurde das fehlende sichere Umbenennen zu einem echten Engpass. Stellen Sie sich vor, eine Collection in einem Produktivsystem umzubenennen, von der über 50 Tabellen abhängen – jeden Verweis manuell anzupassen ist nicht nur langsam, es ist gefährlich.

Wir haben die GitHub-Issues von Directus, die Community-Foren und Discord durchgesehen. Es war eine der häufigsten Wünsche. Also haben wir es richtig gelöst und die Lösung an die Community zurückgegeben.

Installation

Die Erweiterung installiert sich wie jede andere Directus-Erweiterung:

npm install directus-extension-safe-rename

Starten Sie dann Ihre Directus-Instanz neu. Die Erweiterung erscheint im Verwaltungsbereich unter Extensions, und die Umbenennen-Funktion steht in den Einstellungen von Collections und Feldern bereit.

Vollständige Installationsanleitung, Anwendungsbeispiele und Screenshots finden Sie im GitHub-Repository.

Für wen ist das?

Für alle Directus-Entwickler, Agenturen und Teams, die sich je gescheut haben, eine Collection umzubenennen, weil danach alles Nachgelagerte bricht. Wenn Sie komplexe Setups mit vielen Collections betreuen, in denen Umbenennen riskant ist, ist diese Erweiterung für Sie.

Mitmachen

Die Erweiterung steht unter der MIT-Lizenz und ist offen für Beiträge. Ob Directus-Profi oder Einsteiger – Ihre Fehlermeldungen, Funktionswünsche oder Pull Requests machen sie für alle besser.

• GitHub: github.com/contensu/directus-extension-safe-rename
• npm: directus-extension-safe-rename
• Lizenz: MIT

Über Contensu

Wir sind eine Agentur für Individualsoftware-Entwicklung und bauen CRM-Systeme, Websites, interne Tools und Lernplattformen für kleine und mittlere Unternehmen in ganz Europa. Außerdem entwickeln und pflegen wir Open-Source-Werkzeuge, die echte Probleme aus unserer täglichen Arbeit lösen.

Wenn Sie Individualsoftware brauchen, schreiben Sie uns.