Innovator 11 excellence DDL importieren Data-Definition-Language-Dateien in Datenbankschema importieren HowTo www.mid.de
Zweck In Innovator Data excellence können Sie mit dem DDL-Import Ihr physisches Modell initial befüllen. Dabei können Sie das Datenbankschema Ihrer physischen Datenbank verwenden. Eine Aktualisierung des physischen Modells wird nicht unterstützt. Anforderungen Ihr physisches Modell muss das Profil DB Base importieren (Dialogbox Bearbeiten/Eigenschaften, Register Importierte Profile). Einstieg So gehen Sie vor Um ein Datenbankschema in Innovator zu erstellen und aus einer DDL-Datei initial zu befüllen:» Legen Sie Im Modellbrowser unterhalb des Systemmodells mit dem Menübefehl Element> Neu>Modell>Physisches Modell ein physisches Modell an.» Legen Sie unterhalb des Physischen Modells mit dem Menübefehl Element>Neu>Modell> Datenbankkatalog einen Datenbankkatalog an.» Legen Sie unterhalb des Datenbankkatalogs mit dem Menübefehl Element>Neu>Modell> Datenbankschema eine Datenbankschema an.» Selektieren Sie das Datenbankschema.» Um das Schema aus der DDL-Datei zu befüllen, rufen Sie die Engineering-Aktion DDL importieren auf.» Wählen Sie die zu importierende Datei aus Ihrem Dateisystem aus und bestätigen Sie mit OK. Funktionalität Der Import ignoriert alle Modellelemente, die bereits im Datenbankschema existieren. Das bedeutet, dass keine Beziehungen zwischen den vorhandenen und den importierten Modellelementen erzeugt werden können. Die einzige Ausnahme ist das Datenbankschema, das Sie für den Import ausgewählt haben. Wenn Sie also dieselbe DDL-Datei zweimal in dasselbe Datenbankschema importieren, werden Sie Fehlermeldungen erhalten, weil die Modellelemente bereits existieren. Das komplette physische Datenbankmodell muss in einer DDL-Datei enthalten sein. Alle Datenbankobjekte, die in der DDL-Datei verwendet werden, müssen in einer Datei angelegt werden. Es darf also 1
z. B. kein Fremdschlüssel auf eine Tabelle angelegt werden, die nicht auch in dieser DDL-Datei angelegt wird. Anpassung Argumente Sie können das Verhalten des Imports verändern, wenn Sie Argumente der Engineering-Aktion setzen. Liste aller verfügbaren Argumente: DataPrint Ausgabe des geparsten DDL. Standardwert ist "false". bcombineprivilege Verschiedene Privilegien derselben Aktion kombinieren. Der Standardwert ist "true". bignoreunresolved Nicht aufgelöste Referenzen ignorieren. Der Standardwert ist "false". screation Der Name der Spezifikation, die die Stereotype enthält. Der Standardwert ist "". sdirectory Verzeichnis der DDL Dateien scustomeradapter Siehe Kapitel "Kundenadapter". Der Standardwert ist "de.mid.innovator.ddlimport.defaultadapter". babortonerror Bei Auftreten eines Fehlers abbrechen. Der Standardwert ist "false". bdebug Debugausgaben einschalten. Der Standardwert ist "false". bdisableapicache Puffer der Innovator-API ausschalten. Der Standardwert ist "true". bdisablecache Puffer der Anwendung ausschalten. Der Standardwert ist "false". bignoreselection Auswahl ignorieren. Der Standardwert ist "false". bshowdialog Zeige den Dialog. Der Standardwert ist "true". bshowreport Zeige den Bericht. Der Standardwert ist "true". bsilent Keine Ausgabe. Der Standardwert ist "false". ifontsize Schriftgröße. Der Standardwert ist "20". sinodir absoluter INODIR-Verzeichnisname. Standard ist "$(INODIR)". sinotmp absoluter INOTMP-Verzeichnisname. Standard ist "$(INOTMP)". stitle Titel der Anwendung. Standard ist "DDL importieren". Stereotype für neue Modellelemente Sie können die Stereotype angeben, die für das Anlegen von Modellelementen verwendet werden. Diese müssen in einer Spezifikation am Zielmodell stehen. Sie können den Namen der Spezifikation, in der die Stereotype stehen, als Argument 'screation' der Engineering-Aktion mitgeben. Wenn Sie 2
keinen Namen mitgeben, wird die ausgelieferte Spezifikation aus der Datei INODIR/java/ InoIMInOut/bin/InoIMInOut.jar verwendet. Für jeden Elementtyp gibt es einen Eintrag für den Profilnamen und einen Eintrag für den Stereotypnamen. Drei Felder bestimmen, welche Spezifikation für die Beschreibung der Tabelle, der View und der Spalte verwendet wird. Ein Beispiel der Datei ist <?xml version="1.0" encoding="utf-8"?> <Stereos> <StereotypeRootProfile>Data excellence</stereotyperootprofile> <StereotypeRootName>package</StereotypeRootName> <StereotypeTableProfile>Data excellence</stereotypetableprofile> <StereotypeTableName>table</StereotypeTableName> <StereotypeTableColumnProfile>Data excellence</stereotypetablecolumnprofile> <StereotypeTableColumnName>tableColumn</StereotypeTableColumnName> <StereotypePrimaryKeyProfile>Data excellence</stereotypeprimarykeyprofile> <StereotypePrimaryKeyName>dbKey</StereotypePrimaryKeyName> <StereotypeForeignKeyProfile>Data excellence</stereotypeforeignkeyprofile> <StereotypeForeignKeyName>dbForeignKey</StereotypeForeignKeyName> <StereotypeIndexedColumnProfile>Data excellence</stereotypeindexedcolumnprofile> <StereotypeIndexedColumnName>indexedColumn</StereotypeIndexedColumnName> <StereotypeIndexProfile>Data excellence</stereotypeindexprofile> <StereotypeIndexName>index</StereotypeIndexName> <StereotypeDTDProfile>Data excellence</stereotypedtdprofile> <StereotypeDTDName>datatypeDefinition</StereotypeDTDName> <StereotypeDependencyProfile>Data excellence</stereotypedependencyprofile> <StereotypeDependencyName>depend</StereotypeDependencyName> <StereotypeUniqueKeyFeatureProfile>Data excellence </StereotypeUniqueKeyFeatureProfile> <StereotypeUniqueKeyFeatureName>featureUniqueKey</StereotypeUniqueKeyFeatureName> <StereotypeKeyRelationshipFeatureProfile>Data excellence </StereotypeKeyRelationshipFeatureProfile> <StereotypeKeyRelationshipFeatureName>featureKeyRelationship </StereotypeKeyRelationshipFeatureName> <StereotypeTableOptionProfile>Data excellence</stereotypetableoptionprofile> <StereotypeTableOptionName>dbOption</StereotypeTableOptionName> <StereotypeTableColumnOptionProfile>Data excellence </StereotypeTableColumnOptionProfile> <StereotypeTableColumnOptionName>dbOption</StereotypeTableColumnOptionName> <StereotypePrimaryKeyOptionProfile>Data excellence </StereotypePrimaryKeyOptionProfile> <StereotypePrimaryKeyOptionName>dbOption</StereotypePrimaryKeyOptionName> <StereotypeForeignKeyOptionProfile>Data excellence </StereotypeForeignKeyOptionProfile> <StereotypeForeignKeyOptionName>dbOption</StereotypeForeignKeyOptionName> <StereotypeIndexOptionProfile>Data excellence</stereotypeindexoptionprofile> <StereotypeIndexOptionName>dbOption</StereotypeIndexOptionName> <StereotypeIndexedColumnOptionProfile>Data excellence </StereotypeIndexedColumnOptionProfile> <StereotypeIndexedColumnOptionName>dbOption</StereotypeIndexedColumnOptionName> <DescriptionTable>DDL COMMENT</DescriptionTable> <DescriptionColumn>DDL COMMENT</DescriptionColumn> <StereotypeDBUserProfile>Data excellence</stereotypedbuserprofile> <StereotypeDBUserName>user</StereotypeDBUserName> <StereotypeDBRoleProfile>Data excellence</stereotypedbroleprofile> <StereotypeDBRoleName>role</StereotypeDBRoleName> 3
<StereotypeDBRoleAuthorizationProfile>Data excellence </StereotypeDBRoleAuthorizationProfile> <StereotypeDBRoleAuthorizationName>roleAuthorization </StereotypeDBRoleAuthorizationName> <StereotypeViewProfile>Data excellence</stereotypeviewprofile> <StereotypeViewName>view</StereotypeViewName> <DescriptionView>ViewText</DescriptionView> <StereotypeViewColumnProfile>Data excellence</stereotypeviewcolumnprofile> <StereotypeViewColumnName>viewColumn</StereotypeViewColumnName> </Stereos> Kundenadapter Sie können während des Imports von DDL-Dateien weitere Aktionen durchführen, die im Standard nicht durchgeführt werden. Dazu können Sie mit der Programmiersprache Java Methoden erstellen, die während des Imports aufgerufen werden. Die Methoden müssen sich in einer Klasse befinden, deren qualifizierten Namen Sie der Engineering-Aktion per Argument scustomeradapter bekannt machen. Desweiteren muss die Klasse die Schnittstelle de.mid.innovator.ddlimport.adapterinterface implementieren. Es gibt zwei Methoden, die Sie implementieren können: precommit wird aufgerufen, bevor die Modellelemente erzeugt werden postcommit wird aufgerufen, nachdem die Modellelemente erzeugt wurden Außerdem müssen Sie die kompilierte Klasse im Klassenpfad der Engineering-Aktion bereitstellen. Beispiel: Die Methode soll für jede Tabelle, die angelegt wurde, einen Zähler am Schema erhöhen. Zusätzliches Argument der Engineering-Aktion scustomeradapter="de.mid.example.counter" Quelltext der Java-Klasse Counter.java package de.mid.example; import java.util.list; import de.mid.innovator.srv.excellence.inosrvobject; public class Counter implements AdapterInterface{ public void precommit(inosrvobject pack, List<SQLCommand> listcommand) { return; public void postcommit(inosrvobject pack, List<SQLCommand> listcommand) { int icount = 0; for (SQLCommand command:listcommand){ if (SQLCommand.CMD.CREATE_TABLE.equals(command.CMD)){ icount++; pack.setlabel("counter", String.valueOf(iCount)); return; 4
Begriffe Konzeptionelles Modell Physisches Modell Ableitung Abbildung DDL SQL auch bekannt als logisches Datenmodell oder ER-Modell. Es beschreibt die Datenstrukturen in ihrer abstrakten Form. Das konzeptionelle Modell muss in der dritten Normalform (3NF) normalisiert sein. auch bekannt als physikalisches Datenmodell oder Datenbankmodell. Es hält die präzise Spezifikation für ein bestimmtes Datenbankdesign in einer bestimmten Konfiguration. Das physische Modell ist nicht die Datenbank, aber es kann verwendet werden, um die DDL-Datei zu generieren. der Vorgang des Anlegens und Änderns eines Modells aus einem anderen Modell anhand der Abbildungsvorschrift. die Abbildungsvorschrift beschreibt, welches Modellelement von welchem Modellelement abgeleitet werden soll. ist ein Akronym für Database Definition Language (englisch für Datenbankdefinitionssprache). Es beschreibt das Datenbankschema einschließlich der Tabellen, Views, Schlüssel, Indizes, Prozedurem, Trigger, Benutzer, Rollen, etc. Sie können mit Hilfe dieser Sprache das Modell verändern. Die Sprache ist eine Untermenge von SQL. ist ein Akronym für Structured Query Language (englisch für strukturierte Abfragesprache). Es ist eine Obermenge von DDL. Außer Operationen auf dem Schema, können Sie damit auch die Inhalte lesen und verändern. Copyright 2010 MID GmbH Bei Fragen wenden Sie sich bitte an unsere Hotline. Telefon: +49 (0)911 96836-22, 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, Eibacher Hauptstraße 141, 90451 Nürnberg Telefon: +49 (0)911 96836-0, Fax: +49 (0)911 96836-10, E-Mail: info@mid.de, Internet: http://www.mid.de Innovator 11.3 HowTo DDL Import 101015.doc 5