rdb-RdbmsWorker

This child component of all rdb Database devices manages the queue and worker for asynchronous operations on a single database.
Figure 28.   Worker properties
Image

This component is available under any of the rdb (relational database) types: HsqlDbDatabase, MySQLDatabase, OracleDatabase, and SqlServerDatabase.

This component provides two properties for setting the maximum number of concurrent threads and for setting the maximum allowable queue size for the database connection. These worker properties are not pooled at the Network level, as with the NiagaraNetwork driver. Each database driver has its own thread pool setting.

Property Value Description
Max Threads number (defaults to one thread)
Tunes large networks (those with many station components) to process more than a single thread at a time. It is the only visible part of a shared thread-pool scheme for scaling large-jobs and allows the local station’s thread pool to grow uncapped.

Each thread uses one JDBC Connection to communicate with the database, so there are as many connections created as there are threads.

Normally you increase this value to between 20 and 50 to improve performance when handling large volumes of data.

Max Queue Size number (defaults to 1000)

Specifies the maximum number of items that can be queued for worker processing. In a few cases, particularly in a large system, increasing this size may be beneficial.

Queue size does not allocate a fixed memory size. Rather, the amount of memory used is dynamic, changing as message items are added and removed from the queue.