Hier können Sie Ihre Datenbank-Anbindungen (Aliase) verwalten. Zudem finden Sie hier lizenzierte Business Connectoren (Stecker-Icon). Benutzen Sie das Kontextmenü zum Anlegen, Ändern oder Löschen von Einträgen.
Wichtiger Hinweis: Datenbanken und für den Zugriff auf Datenbanken verwendete JDBC-Treiber sind Produkte von Drittherstellern und werden weder von Lobster unterstützt, noch von Lobster zur Verfügung gestellt. Eine eventuell dennoch geleistete Unterstützung oder Beratung zu Datenbanken bzw. JDBC-Treibern durch den Lobster-Support ist freiwillig und impliziert in keinem Fall einen Übergang der Verantwortung auf diesen. Die Installation, der Betrieb und die Wartung von Datenbanken/JDBC-Treibern, bzw. durchgeführte Maßnahmen an diesen, unterliegen immer und ausnahmslos der Verantwortlichkeit des Kunden.
Der Lobster-Support unterstützt Sie natürlich gerne bei den nötigen internen Konfigurationen zur Anbindung funktionierender Fremdsysteme.
Ü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.
Kontextmenü
Bearbeiten | Selbsterklärend. |
Verbindungstest | Siehe Abschnitt unten. |
Kopie erstellen | Selbsterklärend. |
Löschen | Selbsterklärend. |
Export | Export eines Eintrags als Text-Datei (ohne Passwort). |
Import | Import eines davor exportierten Eintrags. |
Neue Verbindung | Siehe Abschnitt unten. |
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) Vorlage laden: 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.
(5) Type: Normalerweise wählen Sie hier “Direct connection“. Für “Connection via Bridge“ siehe Abschnitt Bridge.
(6) Driver: JDBC-Treiberklasse, die für die Verbindung zur Datenbank verwendet wird, z. B. org.gjt.mm.mysql.Driver
(7) Database address: Vollständiger JDBC-String, der die Verbindung zur Datenbank darstellt, z. B. jdbc:mysql://myserver:3306/db
(8) Database user: Geben Sie Ihren Datenbankbenutzer an.
(9) Password: Geben Sie hier Ihr Passwort ein. Für Vault-Passwörter siehe Abschnitt Vault provider configuration.
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 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()
call db procedure a with ResultSet into Map/List()
update()
update-statement()
exists db-row()
set-vars()
Relevante System-Variablen
VAR_SYS_EXCEPTION_STACKTRACE
VAR_SYS_HAS_SQL_ERROR
Datenbank-Zugriff in Phase 4
Siehe Abschnitt “Phase 4”.