Anleitung - Schritt für Schritt.

Transkript

1 Anleitung - Schritt für Schritt. Datenbank-Migration mit Wizard, Studio und Commander. Beruht sich auf der Migration von Oracle nach PostgreSQL (Greenplum) Version 1.0 Copyright Ispirer Systems Ltd. Ispirer und SQLWays sind Warenzeichen von Ispirer Systems Ltd. Alle andere Produktnamen gelten als Warenzeichen der jeweiligen Unternehmen. Alle Rechte vorbehalten.

2 Inhalt SQLWays Wizard Startseite...3 Quelle-Datenbank wählen...3 Ziel-Datenbank wählen...4 Objekte einer Datenbank oder Query spezifizieren...5 DDL(Data Definition Language) und Datenoptionen spezifizieren...6 Export File Optionen spezifizieren...9 Import Optionen spezifizieren...10 Übersicht der gewählten Optionen...11 Migrationsstatus...11 SQLWays Studio SQLWays Commander Export-Verzeichnis Log Dateien...16 Batch Dateien (nur für SQLWays Wizard)...17 DDL und Datendateien...18

3 SQLWays Wizard Startseite SQLWays Wizard wurde erzeugt, um verschiedene Datenbanken mithilfe ODBC-Verbindung zu konvertieren. Dieses Werkzeug hat verschiedene Optionen, die Ihnen helfen, den Migrationsprozess anzupassen, so dass das Werkzeug Ihren Anforderungen maximal entsprechen wird. Das ist eine Startseite, die Sie sehen, wann Sie SQLWays Wizard starten. Auf dieser Seite gibt es eine Option Wählen ein Projektverzeichnis oder Schaffen ein Neues Project. Alle information über Ihre bestehende Konvertierung, wie z.b. Datentyp- Mapping, Objektname-Mapping usw., wird in einem Ordner gespeichert, der in dieser Option bestimmt wird. Nachdem die erste Konvertierung beendet wird, können Sie das bestehenden Projekt spezifizieren, so dass alle Optionen automatisch wiederhergestellt werden. Quelle-Datenbank wählen Wenn Sie Next (Weiter)> drücken, sehen Sie die folgende Seite:

4 Auf dieser Seite muss man einen Benutzer ("User") wählen und System-DSN bestimmen um eine richtige Quelle-Datenbank anzugeben. Indem Sie den Knopf New (Neu)... drücken, können Sie einen neuen DSN schaffen, mit einer Datenbank zu verbinden. Sie können eine Datei mit DSN wählen wenn Sie Ihre Einstellungen der ODBC-Verbindung in einer Datei gespeichert haben. Sie müssen auch einen Benutzername und ein Passwort bestimmen, mit Ihrer Datenbank zu verbinden. Man braucht einen Auswahlkasten Save Password (Passwort speichern) um ein Passwort für die nächste Session zu speichern, wenn man das bestehende Projekt noch einmal benutzen möchtet. Wenn Sie Next (Weiter)> drücken, versucht SQLWays mit einer Quelle-Datenbank zu verbinden und Information über Objekte, die dort sich befinden, zu lesen. Ziel-Datenbank wählen Erstens müssen Sie eine Ziel-Datenbank aus der Dropdown-Liste wählen. Sie können auch eine Version der Ziel-Datenbank bestimmen. Einige Konvertierungen unterscheiden sich je nach der gewählten Version. Weitere Information wird gebraucht, mit einer Datenbank zu verbinden, wenn Import der konvertierten Objekte sich anfängt. HOST - ist ein Name vom Server, wo die Ziel-Datenbank sich befindet. PORT ein Port, der gebraucht wird, mit einer Datenbank zu verbinden. Benutzername und Passwort Berechtigungsnachweis, der benutzt wird, in einer Ziel.-Datenbank einzuloggen. Wenn Sie den Knopf Advanced (Erweitert)... drücken, sehen Sie den folgenden Schirm:

5 Im Bin -Verzeichnis müssen Sie den Weg zum Nativen Tool eines Kunden in einer Ziel- Datenbank bestimmen. Also, unser Werkzeug arbeitet mit Quelle-Datenbanken und verwendet ODBC-Verbindung dabei, das Werkzeug verbindet sich mit Ziel-Datenbanken und verwendet Native Tools dabei. In meisten Fällen kann unser Werkzeug selbst den Weg zum Nativen Tool aus der Systemverzeichnis identifizieren. Aber wir empfehlen, dass Sie diesen Weg jedenfalls identifizieren werden. Alle andere Optionen auf dieser Seite sind spezifisch für jede Datenbank und sehr einfach. Das ist eine Hauptoption auf dieser Seite. Objekte einer Datenbank oder Query bestimmen Auf dieser Seite im linken Panel sehen Sie alle Objekte, die eine Quelle-Datenbank enthält, wie z.b. Tabellen, Sichten, gespeicherte Prozeduren, usw. Im rechten Panel sehen sie Objekte, die konvertiert werden müssen. Wenn Sie am Anfang das bestehende SQLWays Projekt bestimmt haben, werden Objekte, die während der vorherigen Session gewählt wurden, automatisch im rechten Panel beschrieben werden. Auf dieser Seite können Sie auch einen Filter spezifizieren, um nur für disese Migration benötigte Objekte zu beschreiben. Der Filter befindet sich unter dem Knopf *.*.

6 In diesem Feld können Sie einige Filter für verschiedene Objekte einer Datenbank zugeben. Um einen Filter zu zugeben drücken Sie den Knopf Add (Zugeben), um einen Filter zu löschen den Knopf Remove (Löschen). Wenn ein Filter im linken Panel zugegeben wird, werden Sie Objekte, die nur dem gewählten Filter passen, sehen und wir können Objekte für Konvertierung davon wählen. DDL (Data Definition Language) und Datenoptionen spezifizieren Auf dieser Seite können Sie Optionen für gewählte Objekte spezifizieren um die Konvertierung an Ihre Anforderungen anzupassen. In dieser Anleitung werden nur einige von ihnen beschrieben - die meistens benutzt werden. Die erste Option, die wir beschreiben möchten, heißt Omit schema names in SQL scripts (Schemanamen in SQL-Scripten abstellen). Diese Option hat 3 Werte: Yes (Ja), No (Nein), Default. Wenn die Option Yes (Ja) gewählt wird, werden alle Schemanamen in Ergebnisscripten abgestellt (aus gespeicherten Prozeduren,Funktionen, Namen der Tabellen usw.). Wenn die Option No (Nein) gewählt wird, wird ein Schemaname vor dem Name eines Objekts behalten oder wird ein default-schemaname zugegeben (nur für MSSQL Server). Wenn die Option Default gewählt wird, hängt das Benehmen von der Ziel-Datenbank ab. Wenn die Option Omit schema names in SQL scripts (Schemanamen in SQL-Scripten abstellen) als No (Nein) oder Default spezifiziert wird, wird eine andere Option erreichbar, die heißt Change schema name to (Umstellen Schemanamen auf). Diese Option stellt alle Schemanamen auf ein besonderes Schema um, das wird in einem Textfeld spezifiziert. Eine andere nützliche Option heißt Generate DROP TABLE statement (Anweisung DROP TABLE generieren. Diese Option ist normalerweise deaktiviert. Wenn sie aktiviert ist, wird für jede Tabelle in der konvertierten Datenbank eine DROP Anweisung zugegeben. Das ist nützlich, wenn Sie nicht sicher sind, ob diese Tabelle existiert oder nicht, oder wenn Sie DDL einer Tabelle reimportieren möchten. Jetzt werden wir auf die Registerkarte Object Names (Namen der Objekte) drücken.

7 Merken Sie die Option Replace reserved words (Reservierte Wörter ersetzen) in dieser Registerkarte an. Unser Werkzeug kann mit solchen Situationen umgehen, wenn ein Wort in einer Ziel-Datenbank reserviert und in einer Quelle-Datenbank nicht reserviert wurde. In diesem Fall wird dieses Wort durch doppelte Anführungszeichen begrenzt. Indem Sie die Option Replace reserved words (Reservierte Wörter ersetzen) verwenden, können Sie diese Situation lösen und z.b. r_%rword% spezifizieren, so dass allen reservierten Wörter in diesem Fall r_ vorangestellt sein wird. Jetzen werden wir den Knoten Tables (Tabellen) im linken Panel wählen. Sie werden dieselbe Optionen sehen, die Sie hier unten auf dem Bild sehen. In SQLWays haben wir zwei Typen der Zuordnung ("Mapping") - Globale Datentyp-Mapping und Lokale Datentyp- Mapping. Wenn Sie Tables (Tabellen) im linken Panel wählen, können Sie Globale Datentyp-Mapping ändern. Konvertierung jedes Typs kann für die ganze Konvertierung verändert werden. Um Lokale Datentyp-Mapping zu sehen, müssen Sie eine der Tabellen wählen (wie Sie auf dem Bild unten sehen) und auf die Registerkarte DDL options drücken.

8 Sie können eine Liste der Spalten mit entsprechenden Datentypen sehen. In dieser Registerkarte können wir die Konvertierung jeder Spalte verändern und sogar eine Spalte von der Konvertierung ausschließen. Bitte bemerken Sie, dass Veränderungen in Local Data Type mapping (Lokale Datentyp- Mapping) eine höhere Priorität als die Veränderungen in Global Data Type mapping (Globale Datentyp-Mapping) haben. Sie können auch Namen der Spalten ändern, indem Sie von Data Type Mapping (Datentyp- Mapping) aus der Dropdown-Liste zu Column Name Mapping (Spaltenname-Mapping) wechseln, wie auf dem Bild unten. Zurück zu Tables (Tabellen), dann wählen Sie eine Registerkarte Datenoptionen. Hier können Sie einige zusätzliche Optionen sehen, die Migration von Daten betreffen. Hauptoption hier ist Export Data (Datenexport). Diese Option nützlich ist, wenn Sie Daten konvertieren und übetragen nicht möchten. Wenn die Option unchecked data (nicht überprüfte Daten) nicht konvertiert werden wird, dann wird nur DDL konvertiert werden.

9 Hier gibt es eine andere Option Generate DDL ( Sie können das auf dem Bild unten sehen), die erlaubt nur Daten zu migrieren ohne Konvertierung der DDL-Anweisungen. Das ist eine Hauptoption auf dieser Seite. Export File Optionen spezifizieren Die erste Option ist Export Directory (Export-Verzeichnis). Diese Option enthält den Weg zum Ordner, in dem die von SQLWays generierte Dateien nach der Konvertierung gespeichert werden. Das ist nützlich für Übertragung der Dateien nach der Ziel-Datenbank. Sie können jederzeit den Import aus dieser Verzeichnis anfangen.

10 Die nächste nützliche Option ist Run in trace mode. Diese Option generiert zusätzliche Information über Konvertierung in der Dateien sqlways.trc (diese Datei ist nützlich für unsere Entwickler) and gibt kommentierte Quellen der konvertierten Objekte in die Ergebnisdatei dazu. Die nächste Option Divide data file into parts (Datendateien in einige Teile verteilen)". Diese Option ist nützlich, wenn die generierte Datendatei zu groß ist, um vom Betriebssystem OS unterstützt zu werden, deshalb kann sie in einige Teile verteilt werden. Zum Beispiel, wir können eine große Datendatei, die ursprünglich einige G von Daten enthält, in die benötigte Anzahl von Dateien mit der Größe 100M verteilen. Import-Optionen spezifizieren Diese Seite entspricht den Import-Optionen. Hier können Sie spezifizieren, wo der Import realisiert wird, und Betriebssystem des entfernten Rechners (wenn Import direkt im entfernten System realisirt wird) oder die Sequenz einer Migration bestimmen. Werden wir jede Option dieser Seite aufmerksam studieren. Die erste Option ist Import to local or remote target database will be executed from the local system (Import nach der lokalen oder entfernten Ziel-Datenbank wird vom lokalen System realisiert). Diese Option wird gebraucht, wenn Sie DDLs und Daten direkt von Ihrem lokalen Rechner nach der Ziel-Datenbank migrieren möchten. Diese Option ist standardmäßig aktiviert. Zusammen mit dieser Option können Sie eine Option Start import automatically (Import automatisch anfangen) wählen. Nachdem diese Option geprüft worden ist, beginnt Import sofort nach dem Export und beginnt die Konvertierung der gewählten Objekte. Die nächste Option Import will be executed directly on a remote system (transfer of export files required) (Import wird realisiert direkt im entfernten System (Übertragung der Export-Datein ist obligatorisch)). Diese Option muss gewählt werden, wenn Sie den Import vom anderen Rechner anfangen möchten. In diesem Fall können Sie das Betriebssystem des entfernten Rechner wählen; wenn das UNIX-System ist, spezifizieren Sie den Weg nach Shell. In diesem Fall müssen Sie auch den Weg nach Export-Verzeichnis im entfernten System spezifizieren, in dem konvertierte Dateien übertragen werden. Sie können auch LOB-Verzeichnis spezifizieren. Achtung wenn Sie entschieden haben, vom entfernten Rechner zu importieren, müssen Sie konvertierte Dateien manuell auf diesen Rechner übertragen.

11 Übersicht der gewählten Optionen Auf dieser Seite können Sie die Zusammenfassung Ihrer Konvertierung vor dem Export sehen. Nachdem Sie den Knopf Next (Weiter) gedrückt haben, beginnt der Export. Migrationsstatus Auf dieser Seite können Sie den Status der Konvertierung und Ergebnisse nach dem Export sehen. Wenn Sie die Option Start import automatically (Import automatisch anfangen) gewählt haben, können Sie auch den Status von Import prüfen. Wenn nicht, klicken Sie auf den Knopf Start Import um Import manuell zu starten. Der Knopf View Export...(Export ansehen) öffnet den Export-Ordner mit konvertierten Dateien. Der Knopf View Report...(Bericht ansehen) öffnet einen kurzen Bericht in Ihrem Browser um Ergebnisse der Konvertierung anzusehen. Der Knopf Send to Support... generiert ein Muster einer Anfrage mit den angehängten Dateien sqlways.log und sqlways_imp.log, die an unser Support-Team gesendet werden können.

12 SQLWays Studio Dieses Tool wird eigentlich für die Konvertierung von Scripten gebraucht. Gewöhnlich wird es für Konvertierung der einzelnen Scripte, für Prüfung der Ergebnisse von Konvertierung benutzt. Im Studio können Sie bestehende Dateien öffnen oder neur Dateien für schnelle Konvertierung schaffen,oder einige Anweisungen in leere Dateien kopieren, usw. In SQLWays Studio zu konvertieren erstens müssen Sie Quelle- und Ziel-Datenbank aus der entsprechenden Dropdown-Listen wählen: Quelle- Script muss im linken Panel gestellt werden, und Ziel-Script - im rechten Panel. Dann klicken Sie auf um Konvertierung zu starten. Auf der Unterseite können Sie den ganzen Prozess einer Konvertierung und Ergebnisse sehen (ob die Konvertierung erfolgreich war oder nicht). In diesem Panel gibt es einige nützliche Informationen. Vor allem, die erste Reihe zeigt Ihnen, welche Befehlszeile für Durchführung der Konvertierung gewählt wurde. Danach, jedes Script, das konvertiert wurde, hat seinen eigenen Status ob es normalerweise konvertiert wurde oder mit Fehler. Und endlich - totale Information. Zum Beispiel, wenn wir dasselbe Script (auf dem Bild hier oben) konvertieren, dann bekommen wir die folgende totale Information über die Konvertierung:

13 Total: 1 script(s), 1 Ok, 0 Failed, 8 line(s), 4 sec Man versteht darunter, dass es nur 1 Script in dieser Session gibt, das normalerweise konvertiert wurde. Das Script hat 8 Zeilen und wurde in 4 Sekunden konvertiert. Ein anderes nützliches Merkmal im Studio ist dass Sie nur eine gewählte Anweisung konvertieren können. Zum Beispiel, wenn Sie nur eine SELECT-Anweisung aus der konvertierten Prozedur wählen, dann wird SQLWays studio nur diese Anweisung konvertieren. Kurzum, Studio zielt sich auf Konvertierung der einzelnen Scripte, um einem Kunden schnelle Prüfung der Ergebnisse zu gewährleisten.

14 SQLWays Commander Das Hauptziel dieses Werkzeugs besteht darin, dass es eine Reihe von Scripten oder Ordnern, oder beide, konvertieren muss. Optionen einer Konvertierung werden gleicherweise wie im Studio eingestellt. Wir müssen auch in gleicher Weise Quelle- und Ziel-Datenbanken spezifizieren und die Konvertierung anfangen. Das Hauptmerkmal dieses Werkzeugs besteht darin, dass es nur multiple Dateien konvertieren kann. Wir können eine, zwei oder mehrere Dateien in jeglicher Reihe wählen und nur einen Knopf drücken um eine Konvertierung anzufangen. Bemerken Sie, dass Quelle-Dateien müssen sich immer im linken Panel befinden. Das rechte Panel gilt als ein Ordner, wo es Ergebnisse gibt. Nachdem wir einen Knopf gedrückt haben um eine Konvertierung zu beginnen, wird das folgende Fenster erscheinen: Hier bestimmen wir Quelle- und Ziel-Datenbanken, und eine Zieldatei. Wenn die Konvertierung beendet wird, müssen Sie nur die Ergebnisse ansehen um die Konvertierung zu prüfen. Sie können die Ergebnisse in einer Textdatei in einem entsprechenden Panel ansehen. Sie können auch in gleicher Weise eine Quelle-Datei ansehen.

15 Wir können auch in gleicher Weise, wie wir Scripte konvertieren, auch die ganze Datei konvertieren. Wir müssen den Ordner wählen und die Konvertierung anfangen. In diesem Fall wird das Bestätigungsfenster nur eine zusätzliche Option haben Dateimaske. In dieser Option können Sie spezifizieren, welche Maske unser Werkzeug verwenden muss, um die für Konvertierung benötigte Dateien zu wählen. Zum Beispiel, wenn wir alle Dateien konvertieren möchten, dann müssen wir eine Maske *.* spezifizieren, aber wenn wir alle Dateien mit der Erweiterung sql konvertieren möchten, dann müssen wir eine *.sql Maske spezifizieren.. Also, das Hauptziel von SQLWays Commander besteht darin, dass das Programm nur multiple Dateien oder Ordner mit einer Filtermaske konvertiert.

16 Export-Verzeichnis Nach der Migration im Export-Ordner werden viele Dateien mit verschiedenen Erweiterungen und Zweckbestimmungen generiert werden. Diese Dateien sind sehr nützlich für die Prüfung der Ergebnisse vom Export und Import. In diesem Kapitel werden wir ihre Bedeutung beschreiben. Nach der Beendung der Export-Phase werden Sie im Export-Ordner Dateien haben, die in die folgenden Gruppen verteilt werden: Log-Dateien, Batch-Dateien, DDL und Daten-Dateien. Log-Dateien In dieser Gruppe haben Sie drei Dateien (wenn Sie benötigte Phasen beendet haben). Die erste Datei sqlways.log Diese Datei enthält Hauptinformation über die Export-Phase und sie wird nach dieser Phase geschaffen. In dieser Datei können Sie die folgende Information bekommen: Die Version von SQLWays, die für die Konvertierung benutzt wurde, die Befehlszeile, die verwendet wurde, um die Konvertierung anzufangen, Information über Fehler, wenn es einige Fehler während der Konvertierung gab und Gesamtinformation über die Export-Phase. Wir emfehlen, eine Log-Datei nach jedem Export zu prüfen, um es einige Fehler gibt oder nicht. Die nächste Datei sqlways_imp.log. Diese Datei enthält Information über die Import-Phase und wurde nach dieser Phase geschaffen.

17 In dieser Datei gibt es die folgende Information: Die Version von SQLWays, die für die Migration benutzt wurde; Information über alle importierte Objekte und Fehler, wenn es einige Fehler während der Migration gab. Die dritte Datei sqlways.trc Diese Datei enthält detaillierte Information über die Export-Phase. Diese Datei wird generiert, nur wenn die Option Run in Trace mode (Im Trace-Modus laufen) auf der Seite Specify Export File Options (Optionen der Export-Datei spezifizieren) gewählt wurde. Information von dieser Datei sehr nützlich für unsere Entwickler ist, um komplizierte Aspekte in unserem Werkzeug zu identifizieren. Batch-Dateien (nur für SQLWays Wizard) Wenn die Option Generate import scripts (Import-Scripte generieren) auf der Seite Choose a Target Database (eine Ziel-Datenbank wählen) gewählt wurde, werden nach der Konvertierung im Export- Verzeichnis Batch-Dateien mit entsprechenden Kommandos generiert werden, um jedes Objekt zu importieren. Die übliche Datei sqlways_all.bat, die alle andere Dateien startet, wird geschaffen werden. Zum Beispiel, hier unten können Sie eine der Batch-Dateien sehen, in der es ein Kommando gibt, das sql-datei mit Create Procedure-Anweisung ausführt. Um den Import aller Objekte manuell zu starten, können Sie eine Datei sqlways_all.bat laufen. Sie wird den Import aller spezifizierten Objekte starten.

18 Sie können sowohl den Export als auch den Import aus dem Export-Ordner starten. Dafür müssen Sie nur eine Datei sqlways_exp_imp.bat laufen. DDL und Daten-Dateien DDL und Daten-Dateien sind Hauptdateien für Import. Sie können drei verschiedene Erweiterungen haben: *.sql, *.ldi (nur für SQLWays Wizard), *.txt (nur für SQLWays only). SQL-Dateien enthalten eine Definition einer SQL-Anweisung und werden während des Imports ausgeführt. Wenn die Option Run in trace mode (Im Trace-Modus laufen) gewählt wurde, wird zusammen mit SQL-Anweisungen eine Quelle-SQL-Anweisung als ein Kommentar generiert. In diesem Fall können Sie Quelle- und Ziel-Anweisungen vergleichen und prüfen, ob die Konvertierung normalerweise durchgeführt wird oder nicht. Zum Beispiel, das folgende Bild zeigt eine create procedure-anweisung mit der konvertierten Quelle: LDI-Datei enthält ein Kommando, um Einladen von Daten in die Ziel-Dazenbank zu starten. Zum Beispiel, auf dem Bild unten können Sie ein Kommano sehen, das Einladen von Daten in die PostgreSQL Datenbank startet. TXT-Dateien enthalten Daten, die in eine Ziel-Datenbank mithilfe ein Kommando aus der *.ldi Datei geladen werden.