...
This section contains information that is specific to the database type Sybase IQ.
Note |
---|
Note! The Sybase IQ database type requires jConnect v16.0 and later. |
Supported Functions
The Sybase IQ database can be used with:
Audit Profile
Database Collection/Forwarding Agents
Event Notifications
Preparations
The Sybase JDBC driver that is included in the SDK has to be downloaded to the Platform in order to connect to a Sybase IQ database from Usage Engine. Follow these steps to set up the Sybase JDBC driver on the Platform:
...
Restart the Desktop.
Close Pooled Connections
The The APL function closePooledConnections
enables you to close a pooled connection with the Sybase IQ server. This feature helps you eliminate invalid connections.
Note |
---|
Note!This function only closes inactive connections, regardless of how long the connections have been idle. |
Code Block | ||
---|---|---|
| ||
int closePooledConnections (string dbProfile) |
Parameters
Returned Value | Description |
| The name of the database where the table is stored, preceded by the folder name. |
Info | |||||||
---|---|---|---|---|---|---|---|
Example - Using APL function closePooledConnections
|
Performance Tuning
The default maximum number of connections on an Execution Context is five. You can tune this number by setting the Execution Context property sybaseproperty sysbase.iq.pool.maxlimit
in the relevant EC.
Info | |||||||
---|---|---|---|---|---|---|---|
Example - Setting the maximum number of connections for Sybase IQ
|
By default there is no timeout value defined for the socket tied to a database connection. This means that a running query could get stuck, in case the database suddenly becomes unreachable. To specify a timeout valueThere are two properties available for handling timeout of socket connections and socket threads:
sybase.jdbc.socketread.timeout
with default value 180000 (3 minutes in milliseconds)
sybase.jdbc.socketconnect.timeout
with default value 30000 (30 seconds in milliseconds)
To specify other timeout values, in milliseconds, set the Execution Context property sybase.jdbc.socketread.timeout
.properties in the relevant <pico>.conf
file.
Info | |||||||
---|---|---|---|---|---|---|---|
Example - Setting the timeout for a socket tied to a Sybase IQ connection
|
Note |
---|
Note!When using the timeout property you must ensure that you set a limit that exceeds your longest-running query, otherwise, you might terminate a connection while it is executing a query. |
...