Innovator 11 excellence DDL-Skripten über oaw generieren Udo Ende HowTo www.mid.de
Zweck Aus einem physikalischen Datenbank-Schema in einem Modell von Innovator Data excellence soll über openarchitectureware (oaw) das zugehörige DDL-Skript generiert werden. Vorgehensweise Die Generierung von DDL-Skripten aus Innovator Data excellence erfolgt über eine konfigurierte Engineering-Aktion, die mit dem Profil DB Base zur Verfügung gestellt wird. Die Engineering-Aktion ist eine Java-Applikation, die über das Innovator JAPI mit dem Repositoryserver kommuniziert, zur Selektion die Daten sammelt und über oaw-generierung die entsprechende Datei mit den SQL-Statements erzeugt. Engineering-Aktion konfigurieren Engineering-Aktionen sind Bestandteil eines Profils und werden im Konfigurationseditor angepasst. Wenn Sie diese Engineering-Aktion wie vorkonfiguriert belassen, werden Standard-oAW-Workflow- Dateien und Standard-Schablonen der MID für die Generierung der DDLs verwendet. Die generierte Datei wird in ein Unterverzeichnis \ddl unterhalb des $INOTMP-Verzeichnisses geschrieben. Eigenschaftendialog der Engineering-Aktion öffnen Sie können die Eigenschaften vorkonfigurierter Engineering-Aktionen Ihren Bedürfnissen anpassen. So gehen Sie vor Um den Eigenschaftendialog der Engineering-Aktion zu öffnen:» Wechseln Sie mit Wechseln>Konfiguration in den Konfigurationseditor Ihres Datenmodells.» Wählen Sie Ansicht>Aktionen. Sie befinden sich in der Ansicht Aktionen.» Selektieren Sie im Profilbaum im Profil DB Base die Aktionssequenz DDL generieren.» Selektieren Sie in der Liste der Profilelemente die untergeordnete Engineering-Aktion. 1
» Wählen Sie Bearbeiten>Eigenschaften. Die gleichnamige Dialogbox erscheint. 2
Argumente der Engineering-Aktion anpassen So gehen Sie vor Um die Argumente der Engineering-Aktion anzupassen:» Das erste Argument db_workflow.oaw verweist auf die Standard-oAW-Workflow-Datei der MID. Das Ändern dieser Einstellung bedarf genauerer oaw-kenntnisse und wird deshalb nicht detailliert erklärt. Sollte es erforderlich sein, kann hier nur ein Dateiname ohne Pfad stehen, da oaw hier nichts anderes auflöst. Sollte ein anderer Workflow verwendet werden, muss eventuell der Pfad zur Workflow-Datei im Klassenpfad eingehängt werden (s. u.).» Alle weiteren Argumente benötigen ein p vor dem Argument. Dies entspricht dem oaw-standard.» Das zweite Argument innovator.language darf nicht verändert werden.» Das dritte Argument prj.root.dir steht in Anführungszeichen, um falsche Argumentauflösungen z. B. durch Leerzeichen im Projekt-Root-Verzeichnisname zu verhindern. Darüber hinaus gibt es noch weitere Argumente: commentsdesired ist standardmäßig true. Mit false kann die Ausgabe von Kommentar- Statements unterdrückt werden. createindexpositioning ist standardmäßig AfterAllTables, wodurch die Index- Statements erst nach allen Tabellen-Statements positioniert werden. Mit EachTableMiddle kann die Ausgabe bei jeder Tabelle direkt vor den Kommentar-Statements erfolgen, mit EachTableEnd am Ende jeder Tabelle. dbtype ist standardmäßig Unknown. Mit Oracle, MSSQL, MySQL oder DB2 können datenbankspezifische Positionierungen im DDL-Skript für Optionen erreicht werden. Neben der standardmäßigen Nachfolge der Option im DDL-Statement kann diese hiermit alternativ nachfolgend sein oder gar weggelassen werden. 3
Diese Positionierung wird über eine Konfigurationsdatei positions.xml aus InoIMInOut.jar (siehe Eintrag im Klassenpfad) gelesen, in der die zu berücksichtigenden Positionierungen hinterlegt sind. Mit dem Argument positionsressourcefilename kann auf eine eigene XML- Konfigurationsdatei verwiesen werden. Genaueres im Folgenden unter "Anpassen der Positionierungen für Optionen von DB-Elementen". endingquoter ist standardmäßig leer. Durch Angabe einer Zeichenkette erhalten alle Namen von Tabellen, Spalten u. ä. diese Zeichenkette hintangestellt. foreignkeywithconstraint ist standardmäßig true, wodurch alle ForeignKey-Statements hinter dem ADD ein CONSTRAINT plus Name des ForeignKeys bekommen. Mit false werden diese unterdrückt. foreignkeyandtriggerspositioning ist standardmäßig AfterAllTables, wodurch die ForeignKey- und Trigger-Statements erst nach allen Tabellen-Statements positioniert werden. Mit EachTableMiddle kann die Ausgabe bei jeder Tabelle nach den Kommentar-Statements erfolgen, mit EachTableEnd am Ende jeder Tabelle. indexforprimarykey ist standardmäßig false, wodurch für PrimaryKeys nicht automatisiert Indizes zusätzlich erzeugt werden. Mit true werden diese erzeugt. leadingquoter ist standardmäßig leer. Durch Angabe einer Zeichenkette erhalten alle Namen von Tabellen, Spalten u. ä. diese Zeichenkette vorangestellt. primarykeyincreate ist standardmäßig false, wodurch alle PrimaryKey-Statements hinter allen Tabellen-Statements positioniert werden. Mit true folgen diese direkt hinter den Tabellenspalten-Statements. shownulls ist standardmäßig true, wodurch ein NULL hinter den Tabellenspalten positioniert wird, falls diese nullable sind. Mit false kann diese Ausgabe unterdrückt werden. showtableowner ist standardmäßig false. Mit true kann der Innovator-Besitzer als DB- Schemaname vor die Tabellennamen, getrennt durch einen Punkt von diesen, gesetzt werden. singlefilename ist standardmäßig AllDBData und bestimmt den Dateinamen der generierten Datei, dem ein.sql angehängt wird. Über dieses Argument kann der Dateiname direkt bestimmt werden. tablenameprefix ist standardmäßig leer. Durch Angabe einer Zeichenkette erhalten alle Namen von Tabellen diese Zeichenkette als Namenspräfix vorangestellt. uniqueconstraintincreate ist standardmäßig false, wodurch alle UniqueConstraint- Statements hinter allen Tabellen-Statements positioniert werden. Mit true folgen diese direkt hinter den Tabellenspalten-Statements. 4
Klassenpfad für Einbindung eigener Workflow-Dateien anpassen So gehen Sie vor Um den Klassenpfad zu erweitern:» Selektieren Sie die Eigenschaftsseite Klassenpfad.» Klicken Sie auf die Schaltfläche, um einen neuen Eintrag zu erzeugen und das Verzeichnis der Workflow-Datei über die Schaltfläche auszuwählen oder klicken Sie auf die Schaltfläche, um den Klassenpfad in einem Textfeld direkt einzutragen. Die letzte Zeile im Bild ist ein Beispiel für den Pfad zu einer eigenen Workflow-Datei. Anpassen der Positionierungen für Optionen von DB-Elementen Die Konfigurationsdatei positions.xml (Verweis mit dem Argument positionsressourcefilename) enthält ein Root Tag Options, darunter datenbankspezifische Tags OracleOptions, SQLServerOptions, DB2Options und MySQLOptions. Darunter kann es jeweils wieder Tags TableOptions, ColumnOptions, PKOptions, FKOptions und IndexOptions geben. Jedes dieser Tags kann ein Tag Option mit Attribut position enthalten. Der Inhalt des Tags Option ist der Innovator-Name der jeweiligen Option, das Attribut bestimmt die Positionierung des Attributs: leading stellt die Option vor das zugehörige Keyword, leftout lässt die Option wegfallen. Anpassen der Zeilenumbrüche und Tabulatoren in den Ausgabedateien Durch Konfiguration eines PostProcessors in der Workflow-Datei kann man die Zeichen für Zeilenumbrüche und Tabulatoren beeinflussen. Diese Möglichkeit bedarf genauerer oaw-kenntnisse und wird deshalb nicht detailliert erklärt. 5
Engineering-Aktion ausführen Die konfigurierte Engineering-Aktion führen Sie aus, um das DDL-Skript zu dem Datenbank-Schema zu generieren. Selektieren Sie im Modellbrowser ein Paket, in dem die Tabellen liegen, für die DDL- Skripten erzeugt werden sollen, oder die Tabellen selbst und wählen Sie Engineering>Aktion ausführen>ddl generieren. Copyright 2010 MID GmbH Bei Fragen wenden Sie sich bitte an unsere Hotline. Telefon: +49 (0)911 96836-222, E-Mail: support@mid.de. Dieses Dokument finden Sie neben anderen auch im exklusiven Login-Download-Bereich für Innovator-Wartungskunden unter http://www.mid.de/support/. Ihre MID MID GmbH, Kressengartenstraße 10, 90402 Nürnberg Telefon: +49 (0)911 96836-0, Fax: +49 (0)911 96836-100, E-Mail: info@mid.de, Internet: http://www.mid.de Innovator 11.2 HowTo DDL generieren excellence 100630.doc 6