JDBC-Konnektor-Erweiterung
Die ThingWorx JDBC Extension bietet eine schnelle und einfache Lösung, um es ThingWorx Administratoren zu ermöglichen, standardmäßige JDBC-Treiber bereitzustellen, die zur Unterstützung von Drittanbieter-Datenbanken für die Verwendung mit einem ThingWorx Datenbank-Ding erforderlich sind. Datenbank-Dinge ermöglichen es ThingWorx Lösungsentwicklern und Architekten, die von einer Datenbank bereitgestellten Funktionen innerhalb einer unter ThingWorx bereitgestellten Lösung zu integrieren und zu nutzen.
Support-Richtlinie
Um die ThingWorx JDBC Extension zu verwenden, müssen Administratoren den entsprechenden JDBC-Treiber für die gewünschte Datenbank angeben. Obwohl PTC alle geeigneten Maßnahmen getroffen hat, um die allgemeine Funktionalität und Sicherheit der JDBC-Konnektor-Erweiterung sicherzustellen, kann PTC nicht verifizieren, ob ThingWorx mit einem bestimmten JDBC-Treiber kompatibel ist, und auch keine technischen Support-Anfragen zu diesen Treibern oder nicht unterstützten Datenbanken verarbeiten.
Darüber hinaus stellt PTC keine JDBC-Treiber von Drittanbietern, die für die Verwendung der Erweiterung für nicht unterstützte Persistenzanbieter erforderlich sind, zur Verfügung und kann auch deren Funktionalität oder Sicherheit nicht bestätigen. PTC empfiehlt dringend, die Sicherheitsempfehlungen Erweiterungen vor der Verwendung von Drittanbieter-Treibern mit der JDBC Extension zu überprüfen.
Schließlich sind diese oben genannten JDBC-Treiber nur für die Verwendung mit ThingWorx Datenbank-Dingen bestimmt.
Übersicht
Wenn eine JDBC-Erweiterung nicht in ThingWorx für Ihre Datenbank vorhanden ist, können Sie den JDBC-Treiber manuell hinzufügen, indem Sie die Treiber herunterladen und die Dateien zum folgenden Speicherort hinzufügen: /Tomcat folder/webapps/Thingworx/WEB-INF/lib
Nachdem Sie die Treiber kopiert haben, müssen Sie ThingWorx neu starten.
Sie können eine Datenbankerweiterung mit dem JDBC-Treiber erstellen und importieren, um einen Neustart von Tomcat zu vermeiden. Der Vorteil dieses Ansatzes besteht darin, dass Sie den Treiber nicht manuell laden müssen. Das Laden der Klasse wird für Sie erledigt, und die Klasse ist Upgrade-sicher, sodass Sie den Treiber nicht erneut bereitstellen müssen, wenn Sie die ThingWorx Webanwendung aktualisieren. Weitere Informationen zum Erstellen einer Datenbankerweiterung erhalten Sie in den Schritten unten.
JDBC-Erweiterung für ThingWorx erstellen
Gehen Sie wie folgt vor, um eine JDBC-Erweiterung zu generieren:
1. Rufen Sie die ThingWorx JDBC-Konnektorerweiterung unter support.ptc.com ab.
 |
Das Unterstützungsmodell für ThingWorx Erweiterungen hat sich kürzlich geändert. Die meisten Erweiterungen sind auf der Downloads-Seite nicht mehr verfügbar. Weitere Informationen finden Sie in diesem Artikel.
|
2. Laden Sie die JAR-Datei des JDBC-Treibers für Ihre spezifische relationale Datenbank wie Microsoft SQL Server oder MySQL von der entsprechenden offiziellen Website herunter.
3. Wechseln Sie zu ThingWorx Composer.
4. Importieren Sie die JDBC-Konnektor-Erweiterung, die Sie in Schritt 1 heruntergeladen haben.
5. Öffnen Sie das Mashup JdbcCreator, und klicken Sie auf Mashup anzeigen.
6. Klicken Sie auf Datei wählen.
7. Wählen Sie die in Schritt 2 heruntergeladene JDBC-Treiberdatei aus.
8. Klicken Sie auf Hochladen.
9. Klicken Sie auf Download Extension File, um die Erweiterung herunterzuladen.
10. Importieren Sie die in Schritt 9 heruntergeladene ZIP-Datei in ThingWorx Composer.
11. Nach dem Import sollte eine Dingvorlage mit dem Namen <JAR file name>Template angezeigt werden.
12. Erstellen Sie ein neues Ding unter Verwendung der generierten Dingvorlage.
13. Konfigurieren Sie die JDBC-Einstellungen, um eine Verbindung mit Ihrer relationalen Datenbank herzustellen.
|
Feldname
|
Beschreibung
|
|---|---|
|
JDBC-Treiberklassenname
|
Hängt vom Treiber ab, der verwendet wird.
|
|
JDBC-Verbindungszeichenfolge
|
Definiert die Informationen, die erforderlich sind, um eine Verbindung mit der Datenbank herzustellen. Die Formatierung der Verbindungszeichenfolge finden Sie unter connectionstrings.com.
|
|
ConnectionValidationString
|
Einfache Abfrage, die Rückgabewerte von der Datenbank verifiziert (unabhängig von auszuführenden Tabellennamen).
|
Datenbankabfragen und -befehle
Wenn die Konfiguration eingerichtet ist, können Sie SQLQueries und SQLCommands in Diensten für die Datenbank erstellen, mit der Sie eine Verbindung hergestellt haben.
Variablen übergeben
Verwenden Sie bei der Erstellung der Abfrage [[Parametername]] für Parameter-/Variablensubstitution und <<Zeichenfolgensubstitution>> für Zeichenfolgensubstitution.
Beispiel
DELETE FROM <> WHERE (FieldName = '[[MatchName]]');
DELETE FROM << TableName >> WHERE ( FieldName = [[MatchNumber]]);
|
|
Es ist extrem gefährlich, die Zeichenfolgensubstitution << ... >> zu verwenden, da das Risiko von SQL-Injection besteht. Wir empfehlen, mit Bedacht vorzugehen, wenn Sie diese Methode der Parameterübergabe in Betracht ziehen. Um jedoch einen sehr dynamischen Satz von Abfragen zu erstellen, müssen Sie die Tabellennamen als << Name der Tabelle >> weitergeben. Wenn Sie die IN-Klausel verwenden müssen, muss Ihre Sammlung ferner mit << Element1, Element2, Element3,>> übergeben werden.
|