Übersicht

(1) Treiber verwalten: Öffnet einen Dialog zur Verwaltung der Datenbank-Treiber unter ./extlib. Hinweis: Laden Sie JDBC-Treiber bitte nur als .jar-Dateien hoch. Danach ist ein Neustart des Integration Servers notwendig. Um zu prüfen, ob der Treiber richtig geladen wurde, können Sie in der Datei ./logs/wrapper.log (Windows) oder ./logs/console.txt (Linux) nach dem Namen Ihrer .jar-Datei suchen.

(2) Business Connector: Auswahl eines kostenpflichtigen Business Connectors. Um diesen anzubinden kontaktieren Sie bitte information@lobster.de. Hinweis: Siehe auch Seite Update-Center.

(3) Spalte links: Zeigt an, ob es sich um eine klassische Datenbankverbindung (wie Sie sie bisher kennen) oder einen Business Connector (Stecker-Symbol) handelt. Die Datenbank für Lobster Integration selbst erkennen Sie an dem grünen Icon.

Neue Datenbank-Verbindung anlegen

Eine neue Datenbank-Verbindung können Sie anlegen über das Plus-Symbol rechts unten oder über das Kontextmenü. Verbindungen, die Sie hier anlegen, müssen nicht mehr in der Konfigurationsdatei ./etc/database.xml gepflegt werden, Sie können ausschließlich in der GUI arbeiten. Zudem ist kein Neustart des Integration Servers notwendig, lediglich bei neu hochgeladenen Treibern (siehe oben).

(4) JDBC Properties: Siehe Abschnitt DatabaseService für Details.

(5) Vorlage wählen: Hier können Sie vorkonfigurierte Verbindungs-Vorlagen auswählen. Hinweis: Die neuesten Vorlagen erhalten Sie über das Update-Center.

• Links finden Sie klassische Datenbank-Verbindungen. Ersetzen Sie die Platzhalter DB_HOST_OR_IP und DB_NAME mit Ihren spezifischen Werten. Füllen Sie bei Bedarf fehlende Felder und JDBC Properties wie z. B. Catalog Name, User, Password, etc. aus.

• Rechts finden Sie die Connectoren.

(6) Leeren Catalog Name erlauben: Wenn diese Checkbox gesetzt ist, kann das Feld Catalog Name leer gelassen werden. Ist die Checkbox nicht gesetzt und das Feld Catalog Name ist leer, dann wird dort automatisch der Alias-Name eingetragen.

Verbindungstest

Einen Verbindungstest können Sie durchführen über das Kontextmenü einer markierten Verbindung. Dabei wird im Hintergrund eine Standard-SQL-Abfrage abgesetzt. Als Rückmeldung bekommen Sie eine schlichte Erfolgsmeldung oder Fehlermeldung. Hinweis: Bei CData-Verbindungen müssen Sie selbst eine jeweils passende SQL-Abfrage eingeben.

Siehe auch folgenden Abschnitt.

Datenbank-Zugriff über GUI-Tools

• Plugin SQL-Konsole.

• Admin-Konsole → SQL-Monitor.

Datenbank-Zugriff in Eingangsagenten in Phase 1

• Basic SQL (Eingangsagent Cron).

• Business Connector (Eingangsagent Cron) (kostenpflichtige Connectoren und Klassen DefaultFileSQLCron, DefaultSQLCron bzw. CrossSQLCron)

Datenbank-Zugriff über Funktionen in Phase 3

• select into list(select a, dbalias b, [c,d,e,f,g,h,i,j],k,l,[m,n,o,p])

• select into map(a,b,[param &1 = c], d,e, f,g,h,i,j], delimiter k, map l,m,n,o,p)

• select into map(a,b,list name c, delimiter d, map e,f,g,h,i)

• select-statement a [[param &1 = c], d,e, f,g,h,i,j], default k,l,m,n dbAlias = b

• call db procedure a, alias b, [c,d,e,f,g,h,i,j],k,l,m,[n],o,[p]

• call db procedure a, alias b,c,d,e,f

• call db procedure a with ResultSet [[param &1 = c], d,e, f,g,h,i], [column of ResultSet j = 1], default k,l dbAlias = b

• call db procedure a with ResultSet into Map/List k [[param &1 = c], d,e, f,g,h,i], delimiter j, l, dbAlias = b

• update (sql-stmt a, alias b, list c, ignore error d)

• update-statement a, alias b [[param &1 = c],d,e,f,g,h,i,j,[k],[l],[m]]

• exists db-row(select-statement a [[param &1 = c], d,e,f,g,h,i,j,k,l])

• set-vars(select a, dbalias b, [c,d,e,f,g,h,i,j for params &1...&8][,k,l,m,n])

Relevante System-Variablen

• VAR_SYS_EXCEPTION_STACKTRACE

• VAR_SYS_HAS_SQL_ERROR

Datenbank-Zugriff in Phase 4

Siehe Abschnitt Phase 4.