JDBC 連接器延伸功能
ThingWorx JDBC 延伸功能提供了一種簡單快速的解決方案,可讓 ThingWorx 管理員部署支援協力廠商資料庫所需的標準 JDBC 驅動程式,以與 ThingWorx 資料庫物件搭配使用。資料庫物件可讓 ThingWorx 解決方案開發者與設計師合併及利用由在 ThingWorx 上部署之解決方案中的資料庫所提供的功能。
支援原則
欲使用 ThingWorx JDBC 延伸功能,管理員必須為所需資料庫提供適當的 JDBC 驅動程式。雖然 PTC 已採取所有適當的措施來確保 JDBC 連接器延伸功能的一般功能與安全性,但 PTC 無法確定 ThingWorx 與任何特定 JDBC 驅動程式都相容,PTC 也不會處理與此類驅動程式或不支援的資料庫相關的技術支援請求。
此外,PTC 也不提供且無法確認針對不支援的持續性提供者使用延伸功能時所需之協力廠商 JDBC 驅動程式的功能或安全性。PTC 強烈建議在使用具有 JDBC 延伸功能的協力廠商驅動程式之前先檢閱
延伸功能安全性建議。
最後,上述 JDBC 驅動程式僅用於與 ThingWorx 資料庫物件搭配使用。
概觀
如果資料庫的 ThingWorx 中沒有的 JDBC 延伸功能,您可下載驅動程式,並將檔案新增至下列位置,手動新增 JDBC 延伸功能:/Tomcat folder/webapps/Thingworx/WEB-INF/lib
複製驅動程式後,您必須重新啟動 ThingWorx。
欲避免 Tomcat 重新啟動,您可以建構並匯入包含 JDBC 驅動程式的資料庫延伸功能。此方法的優點是您不必手動載入驅動程式。已為您處理類別載入,並且這是安全的升級,因此在更新 ThingWorx Web 應用程式時不必重新部署驅動程式。如需建立資料庫延伸功能的詳細資訊,請遵循下列步驟。
為 ThingWorx 建立 JDBC 延伸功能
欲產生 JDBC 延伸功能,請執行下列操作:
|
|
ThingWorx 延伸功能支援模型最近已變更。大多數延伸功能都無法再從下載頁取得。如需其他資訊,請參閱 此文章。
|
2. 從對應的官方網站下載特定關聯式資料庫的 JDBC 驅動程式 JAR 檔案,例如 Microsoft SQL Server 或 MySQL。
3. 轉至 ThingWorx Composer。
4. 匯入您在步驟 1 中下載的 JDBC 連接器延伸功能。
5. 開啟 JdbcCreator 混搭,然後按一下「檢視混搭」。
6. 按一下「選擇檔案」。
7. 選取在步驟 2 中下載的 JDBC 驅動程式檔案。
8. 按一下「上載」。
9. 按一下 Download Extension File 以下載延伸功能。
10. 將在步驟 9 中下載的 ZIP 檔案匯入 ThingWorx Composer。
11. 匯入之後,您應該會看到名為 <JAR file name>Template 的物範本。
12. 使用產生的物範本建立新物件。
13. 配置 JDBC 設定以連線至關聯式資料庫。
欄位名稱 | 描述 |
|---|
JDBC 磁碟類別名稱 | 取決於正在使用的驅動程式。 |
JDBC 連線字串 | |
ConnectionValidationString | 一種簡單查詢,可驗證來自資料庫的傳回值 (無論待執行的表格名稱是什麼)。 |
依據資料庫的查詢和指令
在服務中設定好組態後,就可建立 SQLQueries 和 SQLCommands,以針對已連線的資料庫執行組態。
傳遞變數
建構查詢時,請針對參數/變數替代使用 [[參數名稱]],並針對字串替代使用 <<字串替換>>。
範例
DELETE FROM <> WHERE (FieldName = '[[MatchName]]');
DELETE FROM << TableName >> WHERE ( FieldName = [[MatchNumber]]);
| 使用 << ... >> 字串替代相當危險,因為它會使您面臨 SQL 插入的風險。考慮使用這種參數傳遞方法時,建議您務必謹慎小心。但是,若要建立非常動態的查詢集,您必須以 << 表格名稱 >> 的格式傳入表格名稱。此外,如果您需要使用 IN 子句,您的集合必須隨 << Item1, Item2, Item3,>> 一起傳入 |