连接到外部数据库
ThingWorx Platform 支持通过两个实体 DatabaseThingSQLThing 连接至外部数据库。两个实体均使用 Java 数据库连接 (JDBC) 与数据库建立连接,且需要为 ThingWorx Platform 添加相应的 JDBC 驱动程序。可通过扩展或直接在 Apache Tomcat 部署中添加 JDBC 驱动程序。
DatabaseThing 暂时受 ThingWorx Platform 支持,随后将继续支持针对不太复杂需求的数据库访问。
最近,新增了 SQLThing 以支持跨多个实体共享配置和连接。使用 SQLThing 时,配置由使用 GenericJdbcPersistenceProviderPackage 创建的持久化方案提供工具管理,并于其中配置 JDBC 连接详情。然后,可通过一个或多个 SQLThing 实体配置中的名称参考所创建的持久化方案提供工具,同时共享所有实体的连接池。
SQLThing 可选择通过 SQLThing 配置中的复选框参与 ThingWorx Platform 事务。当同一 ThingWorx Platform 事务的其他操作失败时,此类支持允许回滚对外部数据库所做的更改。由此还会导致基于相同 JavaScript 服务执行的多个 SQL 服务使用外部数据库上的单个事务,这在某些情况下可能是必要的。请注意,提交数据库更改后,任何其他调用此类 JavaScript 包装的服务均会受到影响,因为它们共享着相同的平台事务。
名称
默认值
注解
JDBC URL
jdbc:_DB_://localhost/
数据库的 JDBC URL,您可从该数据库中获取连接。可以在此 URL 中指定多个架构。
Username
dbuser
用于获取数据库连接的用户名
密码
不适用
用于获取数据库连接的密码
初始连接池大小
0
启动时创建且会连接到数据库的线程的数量
建立连接增量
1
确定在连接池耗尽时将获得的连接数
连接池大小上限
100
连接池在任何给定时间保持的最大连接数
连接池大小下限
0
连接池在任何给定时间保持的最小连接数
缓存语句最大数目
100
全局 PreparedStatement 缓存大小
驱动类
数据库 JDBC 驱动类
建立连接重试次数
3
定义连接池将尝试获取新连接的次数
建立连接重试延迟
10000
连接池在两次获取连接尝试之间等待的时间 (以毫秒为单位)
退出重试超时
1000000
当连接池耗尽时,调用 getConnection 的客户端等待检入或获取连接的毫秒数
合用连接空闲重新测试周期 (秒)
60
最大空闲时间
0
连接被放弃之前,连接池中存在但未使用的连接秒数零表示空闲连接从不过期。
连接最大时长
0
一旦超出这个时长 (以秒为单位),连接将会被销毁并从连接池中清除。零表示无强制的最大连接时长。
Helper 线程数目
8
通常,速度较慢的 JDBC 操作将由未持有竞争锁的 helper 线程执行。将这些操作分散到多个线程中,可以同时执行多个操作,从而显著提高性能。
未返回连接超时
0
如果应用程序获取了连接但在指定的时间段 (以秒为单位) 内未能关闭连接,则连接池会销毁连接。零表示无超时,并且应用程序会关闭其连接。
过量连接最大空闲时间
300
在超过 minPoolSize 的连接允许销毁之前,在连接池中保持空闲的秒数。零表示无强制,多余连接不会被销毁。
加载所有实体时的批量获取大小
5000
SSL 连接模式
禁用
SSL 连接已启用或禁用
SSL 根证书路径
启用 SSL 连接模式时,SSL 许可证的路径
连接池饱和警戒限
85
这对您有帮助吗?