INHALTSVERZEICHNIS DBANT IHR TOOL ZUM KONVERTIEREN UND KOPIEREN VON DATEN (VERSION )

Transkript

1 INHALTSVERZEICHNIS Einleitung...2 Schnelleinstieg (HowTo)...2 Installieren des Tools...2 Aufteilung der Oberfläche...4 Navigation...5 Databases/Tables Container Database...5 Databases/Tables Database...6 Databases/Tables Container Table...8 Databases/Tables Table...8 Textfiles - Container...9 Textfiles Textfile...10 XML Files - Container...12 XML Files XML-File...13 Transfers - Container...15 Transfers Transfer...16 Transfers Easy - Container...18 Transfers Easy Transfer...20 Sql-Scripts Sql Script...21 Ant-Scripts - Container...22 Ant-Scripts Ant-Script...22 Settings...25 DbAnt-Cloud...27 Allgemeines

2 EINLEITUNG Was kann das Programm? Daten zwischen verschiedene Datenbanksysteme kopieren. Import und Export von Datenbanken in ein Text- oder XML-Format. Daten zu kopieren die hinter Firewalls liegen. Da ich das Programm hauptsächlich mit Oracledatenbanken verwende sind die in der Anleitung verwendeten Beispiele auch auf die Verwendung einer Oracledatenbank ausgelegt. SCHNELLEINSTIEG (HOWTO) INSTALLIEREN DES TOOLS Installieren Sie das Tool von hier: DATEN ZWISCHEN 2 DATENBANKEN KOPIEREN DATENBANK KONFIGURIEREN Rechts klicken auf Databases/Tables und New auswählen. Datenbankeigenschaften Quelldatenbank festlegen Name der Datenbank Provider (z.b. System.Data.OracleClient) Databasename/User/Passwort Rechts klicken auf Databases/Tables und New auswählen. Datenbankeigenschaften Zieldatenbank festlegen Name der Datenbank Provider (z.b. System.Data.OracleClient) Databasename/User/Passwort TRANSFER KONFIGURIEREN UND STARTEN 2

3 Rechts klicken auf Transfers und New auswählen. Transfereigenschaften festlegen. Name festlegen oder Auto Name From Database auswählen Auf New Table bei From Table drücken (neue Lasche mit Tabellenproperties geht auf) Tabellenname eintragen Auf Get Columns and Close drücken (Tabellenname wird übernommen) Auf Same as From Table drücken Auf Start Transfer drücken 3

4 AUFTEILUNG DER OBERFLÄCHE Die Oberfläche unterteilt sich in 2 Bereiche. Der linke Teil enthält die Funktionen in Form einer Baumansicht. Durch Doppelclick auf einen Eintrag werden, so vorhanden, die Eigenschaften des angewählten Objekts im rechten Teil angezeigt und wenn vorhanden die untergeordneten Einträge angezeigt. Durch Rechtsclick auf einen Eintrag wird das entsprechende Kontextmenü angezeigt. Im rechten Teil werden die Eigenschaften der ausgewählten Einträge angezeigt. 4

5 NAVIGATION DATABASES/TABLES CONTAINER DATABASE Beinhaltet die Liste der definierten Datenbanken. NEW Es wird ein neuer Eintrag "NewDatabase" eingetragen und die für die Eigenschaften der Datenbank angezeigt. 5

6 DATABASES/TABLES DATABASE Beinhaltet die Liste der definierten Tabellen für diese Datenbank. OPEN Die für die Eigenschaften der Datenbank wird angezeigt. Der Datenbankeintrag wird gelöscht. NEW TABLE Es wird ein neuer Eintrag "NewTable" unterhalb der Datenbank eingetragen und die für die Eigenschaften der Tabelle angezeigt. SESSION (NUR ORACLE) Es wird eine Tabelle der aktuellen Sessions der Datenbank angezeigt. GETFIELDLIST (ALL TABLES) Die Feldliste aller Tabellen dieser Datenbank wird aktualisiert. PROPERTIES NAME Frei zu vergebender Name. PROVIDER.NET-Provider für den Zugriff auf die Datenbank. DATABASENAME 6

7 Data Source zum Erzeugen des Connectstrings (Oracle). USER User zum Erzeugen des Connectstrings (Oracle). PASSWORD Passwort zum Erzeugen des Connectstrings (Oracle). CONNECTSTRING Der Connectstring kann entweder direkt eingegeben werden oder über die Felder Databasename/User/Password gebildet werden. POSTCONNECT Diese Sql-Befehle werden nach jedem Connect ausgeführt. Einzelne Befehle müssen mit ; am Schluss oder / in einer eigenen Zeile abgeschlossen werden. Stored Procedures können mit execute spname( param1, param2 ) ausgeführt werden. TRACEFILE PATH Pfad für die Ausgabe von Trace-Informationen (siehe Funktion Sessions). SORT Parameter für das Sortieren im Container wird dieser Wert leer gelassen wird nach dem Namen der Datenbank sortiert. 7

8 DATABASES/TABLES CONTAINER TABLE Liste der definierten Tabellen/Views. OPEN Die für die Eigenschaften diese Tabelle wird angezeigt. Der Tabelleneintrag wird gelöscht. DATABASES/TABLES TABLE FUNKTIONEN - TABELLE Löscht den Eintrag MAKE XML-DEF Erzeugt einen Eintrag im Container XML Files mit Informationen aus der Tabelle. MAKE TEXT-DEF Erzeugt einen Eintrag im Container Textfiles mit Informationen aus der Tabelle. FUNKTIONEN SPALTEN NEW Erzeugt eine neue Zeile in den Spalteninformationen SAVE Löscht die mit Del markierten Spalten und speichert die Spalteninformationen intern. GET COLUMNS Liest die Spalteninformationen aus der Datenbank. GET COLUMNS AND CLOSE Liest die Spalteninformationen aus der Datenbank und schließt das Fenster. PROPERTIERS - TABELLE NAME Name der Tabelle im Container. DEFINITION Im Regelfall der Tabellename oder der Viewname der Tabelle. Wird dieser Eintrag leer gelassen wird der Name verwendet. SORT 8

9 Parameter für das Sortieren im Container wird dieser Wert leer gelassen wird nach dem Namen der Tabelle sortiert. PROPTERTIES SPALTEN DEL Löschkennzeichen. Die markierten Spalten werden beim Save gelöscht. NAME Spaltenname TYPE Spaltentype LEN Länge des Feldes (-1 Länge dynamisch ermitteln). DEC Anzahl Dezimalstellen (-1 dynamisch ermitteln). SORT Parameter für das Sortieren in der Tabelle. TEXTFILES - CONTAINER Liste der definierten Textfiles. NEW Es wird ein neuer Eintrag "NewTextfile" eingetragen und die für die Eigenschaften des Textfiles angezeigt. 9

10 TEXTFILES TEXTFILE OPEN Die für die Eigenschaften des Textfiles wird angezeigt. Der Textfileeintrag wird gelöscht. DUPLICATE Der Textfileeintrag wird dupliziert. FUNKTIONEN - TEXTFILE Der Textfileeintrag wird gelöscht. FUNKTIONEN SPALTEN NEW Erzeugt eine neue Zeile in den Spalteninformationen SAVE Löscht die mit Del markierten Spalten und speichert die Spalteninformationen intern. PROPERTIES TEXTFILE NAME Name im Container. 10

11 FILENAME Filename des Textfiles. BUFFERSIZE Buffergrösse beim Einlesen und Schreiben der Daten. NUMBER HEADERLINES Anzahl der Kopfzeilen. Diese werden beim Einlesen übersprungen. FIELD DELIMITER Delimiter der einzelnen Felder. STRING DELIMITER Abgrenzung von Texten. SORT Parameter für das Sortieren in der Tabelle. PROPTERTIES SPALTEN DEL Löschkennzeichen. Die markierten Spalten werden beim Save gelöscht. NAME Spaltenname TYPE Spaltentype LEN Länge des Feldes (-1 Länge dynamisch ermitteln). DEC Anzahl Dezimalstellen (-1 dynamisch ermitteln). SORT Parameter für das Sortieren. 11

12 XML FILES - CONTAINER Liste der definierten XML-Files. NEW Es wird ein neuer Eintrag "NewXmlFile" eingetragen und die für die Eigenschaften des XML-Files angezeigt. OPEN Eine Tabelle alle XML-Files wird angezeigt. 12

13 XML FILES XML-FILE OPEN Die für die Eigenschaften des XML-Files wird angezeigt. Der XML-Fileeintrag wird gelöscht. DUPLICATE Der XML-Fileseintrag wird dupliziert. FUNKTIONEN XML-FILE Der Eintrag wird gelöscht. FUNKTIONEN SPALTEN NEW Erzeugt eine neue Zeile in den Spalteninformationen SAVE Löscht die mit Del markierten Spalten und speichert die Spalteninformationen intern. PROPERTIES XML FILE NAME Name im Container. FILENAME SCHEMA Filename des in dem die Schemainformationen der XML-Datei gespeichert werden. FILENAME DATA Filename des in dem die Daten der XML-Datei gespeichert werden. Dieser Name wird um die Nummer des geschriebenen Blocks im Format _ erweitert. Die Größe der einzelnen Blocks wird beim Schreiben durch die Größe des angegeben Blocks beim Transfer bestimmt. COMPRESSDATA Bestimmt ob die Ausgabedaten komprimiert werden sollen. BUFFERSIZE Buffergrösse beim Einlesen und Schreiben der Daten. SORT Parameter für das Sortieren. PROPTERTIES SPALTEN 13

14 DEL Löschkennzeichen. Die markierten Spalten werden beim Save gelöscht. NAME Spaltenname TYPE Spaltentype LEN Länge des Feldes (-1 Länge dynamisch ermitteln). DEC Anzahl Dezimalstellen (-1 dynamisch ermitteln). SORT Parameter für das Sortieren. 14

15 TRANSFERS - CONTAINER Liste der definierten Transfers. NEW Es wird ein neuer Eintrag "NewTransfer" eingetragen und die für die Eigenschaften des Transfers angezeigt. 15

16 TRANSFERS TRANSFER OPEN Die für die Eigenschaften des Transfers wird angezeigt. Der Transfereintrag wird gelöscht. DUPLICATE Der Transfereintrag wird dupliziert. FUNKTIONEN TRANSFER Löschte den Eintrag. AUTO NAME Erzeugt aus den Informationen automatisch einen Namen. START TRANSFER Starten den Kopiervorgang. STOP TRANSFER Bricht den aktuellen Kopiervorgang ab. REFRESH TABLES Aktualisiert die Datenbank/Tabelleninformationen der Properties. EDIT TABLE Ruft die Propertyseite von From Table bzw. To Table auf. Diese Funktion ist nur aktiv wenn eine Datenbank in From Database ausgewählt wurde. NEW TABLE Legt einen neuen Tabelleneintrag in From Database bzw. To Database an und ruft die Propertyseite auf. Die neue Tabelle wird automatisch übernommen. Diese Funktion ist nur aktiv wenn eine Datenbank in To Database ausgewählt wurde. SAME AS FROM TABLE Liest die Tabelleninformationen mit demselben Namen in der To Database wie in der From Database definiert wurde ein. Ist diese Tabelleninformation nicht vorhanden wird diese neue angelegt und die Spalteninformationen über die Funktion Get Columns in der Tabelledefinition erzeugt. Diese Funktion ist nur aktiv wenn eine Datenbank in From Database und To Database ausgewählt wurde. CREATE TABLE DDL Erzeugt ein SQL-Script zur Anlage der in From Table angegebenen Tabelle in der To Database und legt dieses auf das Clipboard. FUNKTIONEN SPALTEN 16

17 NEW Erzeugt eine neue Zeile in den Spalteninformationen SAVE Löscht die mit Del markierten Spalten und speichert die Spalteninformationen intern. SET FROM COLUMNS Liest die Spalteninformation von der From Table ein. Diese Funktion wird automatisch durchgeführt wenn eine neue From Table ausgewählt wird. SET TO COLUMNS Liest die Spalteninformation von der To Table ein und versucht diese den From -Einträge zuzuordnen. Diese Funktion wird automatisch durchgeführt wenn eine neue To Table ausgewählt wird. PROPERTIES - TRANSFER NAME Name des Transfers WHERE optional eine Where-Bedingung. Diese wird sowohl für den Select als auch ggf. für den Delete in der Zieldatenbank verwendet. WHERE FOR SELECT optional eine Where-Bedingung für das Lesen der Daten. Diese übersteuert eine ggf. vorhandene generelle Where-Bedingung. WHERE FOR optional eine Where-Bedingung für das Löschen der Daten. Diese übersteuert eine ggf. vorhandene generelle Where-Bedingung. SORT Parameter für das Sortieren. FROM DATABASE Quelldatenbank oder leer für Text/XML-Files. FROM TABLE Quelltabelle oder Text/XML-Definition TO DATABASE Zieldatenbank oder leer für Text/XML-Files. TO TABLE Zieltabelle oder Text/XML-Definition DB BLOCK ROW Gibt an wieviel Zeilen pro einzelnen Lesevorgang maximal gelesen werden. TARGET ROWS Gibt an ob die Daten in der Zieldatenbank vor dem Kopieren gelöscht werden sollen. 17

18 ONE TRANSACTION Gibt on ob der gesamte Vorgang in einer Transaktion laufen soll oder die einzelnen Blöcke bestätigt werden sollen. INFO Laufende Information des Kopiervorgangs. PROPTERTIES SPALTEN DEL Löschkennzeichen. Die markierten Spalten werden beim Save gelöscht. FROM Auswahl Quellspaltenname FROMCOL LEN Länge des Feldes (-1 Länge dynamisch ermitteln). FROMCOL DEC Anzahl Dezimalstellen (-1 dynamisch ermitteln). FROMCOL FORMAT Derzeit nicht benutzt, leer lassen. TO Auswahl Zielpaltenname TOCOL LEN Länge des Feldes (-1 Länge dynamisch ermitteln). TOCOL DEC Anzahl Dezimalstellen (-1 dynamisch ermitteln). TOCOL FORMAT Derzeit nicht benutzt, leer lassen. SORT Parameter für das Sortieren. TRANSFERS EASY - CONTAINER Liste der definierten Transferscontainer. Dieser Container erleichtert die Erstellung von Transfers mit mehreren Tabellen. 18

19 . NEW Es wird ein neuer Eintrag "New" eingetragen und die für die Eigenschaften des Transfers angezeigt. FUNKTIONEN TRANSFER EASY Löschte den Eintrag. GET TRANSFERS Erzeugt die entsprechenden Transfers für alle Tabellen die sowohl in der From als auch in der To -Database laut Maske in Table(s) vorhanden sind. CLEAR TRANSFERS Löscht alle erzeugten Transferdefinitionen. START TRANSFER Starten den Kopiervorgang. 19

20 TRANSFERS EASY TRANSFER OPEN Die für die Eigenschaften des Transfers wird angezeigt. Der Transfereintrag wird gelöscht. 20

21 SQL-SCRIPTS SQL SCRIPT OPEN Die für die Eigenschaften wird angezeigt. Der Eintrag wird gelöscht. FUNKTIONEN Der Eintrag wird gelöscht. READ FILE Liest die Datei ein. Dabei werden Zeilen von Dateien die im angegeben sind rekursive aufgelöst. EXCEUTE Führt die im Text enthaltenen Sql-Befehler durch. Einzelne Befehle müssen mit ; am Schluss oder / in einer eigenen Zeile abgeschlossen werden. Stored Procedures können mit execute spname( param1, param2 ) ausgeführt werden. COPY ALL TO CLIPBOARD Kopiert den Inhalt des Text-Feldes aufs Clipboard. CLEAR TEXT Löscht den Inhalt des Text-Feldes. PROPERTIES NAME Name im Container DATABASE Datenbank für die Ausführung der Befehle FILENAME Dateiname für Read File INSERT FILEINFOS Gibt an ob Kommentarzeilen bei aufgelösten Dateien ins Script eingefügt werden sollen. TEXT Sql-Script 21

22 ANT-SCRIPTS - CONTAINER Liste der definierten Ant-Scripts. NEW Es wird ein neuer Eintrag "NewAntScript" eingetragen und die für die Eigenschaften des Ant-Scripts angezeigt. ANT-SCRIPTS ANT-SCRIPT OPEN Die für die Eigenschaften des Ant-Scripts wird angezeigt. Der Ant-Scriptseintrag wird gelöscht. FUNKTIONEN Führt Scriptbefehle aus. 22

23 Die Eigenschaften auf dieser können nur geändert werden wenn Edit Ant-Scripts in den Settings erlaubt ist. Bei den Namen der Commands und der Options wird die Groß-/Kleinschreibung nicht beachtet. Bei den Optionsparameter schon. Löscht den Eintrag. READ FILE Lesen Script aus Datei EXECUT Script durchführen FELDER NAME Angezeigter Name FILENAME Filename für Einlesen mit Read File TEXT Script 23

24 COMMANDOS Löscht Einträge aus dem Navigationsbaum delete /type all table database xmlfile textfile transfer sqlscript antscript /name <name> [/regex y n] /regex = search with regex, n = default /name = syntax by tables = <database> <table> GETTABLE Legt eine neue Tabellendefintion an wenn diese nicht vorhanden ist. gettable /d <Database> /t <Tablename> [/s y n] [/xml <Basis-Verz>] [/closeonend y n] /s = <Tablename> wird mit Like gesucht. TRANSFER Führt einen Transfer durch transfer /t <Transfername> [/fd <FromDatabase>] [/td <ToDatabase>] [/ft <FromTable>] [/tt <ToTable>] [/where <WhereClause>] [/dbblockrow <Number Rows per Block>] [/deletetargetrows y n] [/onetransaction y n] [/closeonend y n] [/sync y n] EXECUTESQL Führt ein SQL-Statement durch. executesql /d <Database> /c <SqlStatement> CLOSEALL Schliest alle Fenster bis auf das Scriptfenster. closeall COLLAPSETREES Schließt alle Einträge im Navigationsbaum. WAITFORTRANSFER Wartet bis alle laufenden Transfers beendet sind. waitfortransfer DEFAULTOPTION Legt die Default-Option für ein Commando fest. defaultoption /cmdname <Name des Commands> [/<Option> <Optionparameter> ] 24

25 SETTINGS Generelle Settings. OPEN Die für die generellen Settings wird angezeigt. COLLAPSE Schließt alle Einträge im Navigationsbaum. FUNKTIONEN SAVE AS DEFAULT Das aktuell angegebene Configfile wird als default gespeichert. SAVE SETTINGS Die aktuellen Einstellungen werden in das angegebene Configfile gespeichert. Hinweis: Das Programm ist mit der Endung.DbAntCfg verknüpft. Das bedeutet Doppelclick auf eine Datei mit der Endung.DbAntCfg öffnet das Programm und lädt das angegebene Configfile. LOAD SETTINGS Die Einstellungen werden aus dem angegebenen Configfile gelesen. 25

26 PROPERTIES PASSWORT ADMIN Eingabe eines neuen Administratorpassworts. Diese Zeile wird nur angezeigt wenn im Administratormodus. PASSWORT USER Eingabe eines neuen Userpassworts. EDIT DATABASE Änderung/Anzeige der Eigenschaften erlaubt. EDIT TABLES AND FILES Änderung/Anzeige der Eigenschaften erlaubt. EDIT TRANSFERS Änderung der Eigenschaften erlaubt. EDIT ANT-SCRIPT Änderung der Eigenschaften erlaubt. REFRESH COLUMNS Refresh Columns im Transfer erlaubt. LAST CONFIG-FILES Liste der zuletzt verwendeten Configfiles. CONFIG FILE Name der Konfigurationsdatei. SAVE FILENAME Das angegebene Configfile für den nächsten Programmstart nutzen. LICENSEKEY Wird derzeit automatisch vergeben. 26

27 DBANT-CLOUD Daten können auch in der DbAnt-Cloud gespeichert werden. Dafür benötigen Sie einen privaten Datenschlüssel den Sie unter anfragen können. Bei XML-, Text und Konfigurationsdateien können Sie den Dateinamen mit folgender Syntax angeben. dbant:<ihr persönlicher Key>:<Dateiname> Damit werden die Daten in die DbAnt-Cloud gespeichert bzw. von dieser gelesen. Beispiel für Configurationsdatei: dbant:40eda68c-f312-47d7-a60f-afd729caaa01:config.xml ALLGEMEINES Fragen oder Anregungen senden Sie bitte an Copyright (c) Michael Premlechner All rights reserved. DIESE SOFTWARE WIRD AUF DER BASIS "AS IS" (SO WIE SIE IST) ZUR VERFÜGUNG GESTELLT UND JEGLICHE AUSDRÜCKLICHE ODER STILLSCHWEIGENDE GEWÄHRLEISTUNG WIRD ABGELEHNT. UNTER KEINEN UMSTÄNDEN BIN ICH FÜR DIREKTE, INDIREKTE, ZUFÄLLIGE, BESONDERE, BEISPIELHAFTE SCHÄDEN ODER FOLGESCHÄDEN AUFGRUND DER NUTZUNG ODER FALSCHEN NUTZUNG DIESER SOFTWARE HAFTBAR. 27