Mitmachen

credativ-pg-migrator ist Open Source unter der GPLv3 und wird offen entwickelt. Beiträge sind willkommen — und sie müssen nicht aus Code bestehen.

Ein Problem melden

#

Der wertvollste Beitrag ist ein gut beschriebener Fehlerfall. Legacy-Datenbanken sind unerschöpflich einfallsreich, und die Konvertierungslogik kann nur abdecken, was sie bereits gesehen hat.

Eröffnen Sie ein Issue auf GitHub und geben Sie dabei an:

• die Engine und Version der Quelldatenbank sowie den verwendeten Konnektivitätstyp (odbc, jdbc, ddl oder nativ);
• den relevanten Teil Ihrer Konfigurationsdatei — ohne Zugangsdaten;
• die Log-Ausgabe rund um den Fehler (--log-level=DEBUG liefert deutlich mehr Details);
• bei einem Konvertierungsproblem die ursprüngliche Objektdefinition und den erzeugten PostgreSQL-Code. Beides liegt nebeneinander in den Protokolltabellen der Migrationsdatenbank und lässt sich von dort leicht auslesen.

Code beitragen

#

Pull Requests sind willkommen — für einen neuen Connector für eine Quelldatenbank, für eine bessere Abdeckung eines bestehenden Connectors oder für die Korrektur eines Sonderfalls bei der Konvertierung.

Ein Connector für eine Quelldatenbank implementiert die Klasse DatabaseConnector aus dem Modul credativ_pg_migrator.database_connector. Ihre Methoden dokumentieren das erwartete Verhalten und die Rückgabewerte, sodass diese Klasse der richtige Ausgangspunkt ist, wenn Sie eine weitere Engine ergänzen möchten. Quellen werden über ODBC, JDBC oder native Python-Bibliotheken angebunden — nicht jede Option steht für jede Engine zur Verfügung.

Die Funktionsmatrix zeigt gut, wo die Lücken liegen: Jedes --, WIP und ? steht für Arbeit, die noch nicht erledigt oder noch nicht verifiziert ist. Insbesondere die ?-Einträge scheitern meist an einer einzigen Sache — daran, eine Testdatenbank zu finden, die die betreffende Funktion realistisch nutzt. Wenn Sie über ein solches Schema verfügen, ist allein das schon ein echter Beitrag.

Die Dokumentation verbessern

#

Die Dokumentation liegt im Verzeichnis docs/ des Repositorys, direkt neben dem Code. Wenn bei Ihrer Migration etwas unklar war oder gefehlt hat, hilft ein Pull Request auf diese Dateien der nächsten Person weiter.

Professioneller Support

#

Wenn Sie eine Migration planen und diese lieber durchführen lassen möchten, statt sie selbst zu übernehmen: Die credativ GmbH bietet professionellen Support für PostgreSQL und Datenbankmigrationen — von der Bewertung des Quellsystems bis zur Durchführung der Migration.

Nehmen Sie Kontakt mit credativ auf.

Autoren und Lizenz

#

credativ-pg-migrator wurde maßgeblich von Josef Machytka bei der credativ GmbH entwickelt und wird von ihm gepflegt — die vollständige Liste finden Sie in AUTHORS.

Das Projekt steht unter der GNU General Public License, Version 3 (oder einer späteren Version). Den vollständigen Text finden Sie in COPYING.