To configure and publish the JDBC connection, perform the following steps:
1Open the JDBCConnectionContact connection.
2In the Type field, select JDBC Generic Cloud Adapter.
3In the Run On field, select the Secure Agent.
4In the OData-Enabled field, select Yes.
5In the OData Cloud Access Enabled field, select Yes.
6In the Connection Properties section, enter values for the following properties:
Property
Description
JDBC Connection URL
The URL schema for the database. Use the corresponding schema for the following databases:
- IBM DB2: jdbc:db2://<server>:<port>/<database>
- Microsoft SQL Server: jdbc:sqlserver://<Host>:<Port>;databaseName=<Database>
- MySQL: jdbc:mysql://<Host>:<Port>/<Database>
If you encounter an issue, append ?useSSL=false&allowPublicKeyRetrieval=true to the JDBC Connection URL. For example, jdbc:mysql://<Host>:<Port>/?useSSL=false&allowPublicKeyRetrieval=true
The path to the JDBC driver .jar file. For example, you can enter the following directory: C:/jdbc
If you do not specify a directory path, the Secure Agent gets the .jar file from the process-engine/ext directory.
You must specify one of the following values for the JDBC connection to work successfully:
- JDBC JAR directory. If you choose to specify the JDBC JAR directory, you can place the .jar file in any directory and specify the directory in the JDBC Jar Directory field.
- JDBC driver class name. If you choose to specify the JDBC driver class name, you must place the JDBC driver .jar file in the following directory:
process-engine/ext
JDBC Driver Class Name
The name of the JDBC driver class.
Based on the database, you can specify one of the following driver class names:
- IBM DB2: com.ibm.db2.jcc.DB2Driver
- Microsoft SQL Server: com.microsoft.sqlserver.jdbc.SQLServerDriver
- MySQL: com.mysql.jdbc.Driver
- Oracle: oracle.jdbc.OracleDriver
- PostgreSQL: org.postgresql.Driver
You must specify one of the following values for the JDBC connection to work successfully:
- JDBC JAR directory. If you choose to specify the JDBC JAR directory, you can place the .jar file in any directory and specify the directory in the JDBC Jar Directory field.
- JDBC driver class name. If you choose to specify the JDBC driver class name, you must place the JDBC driver .jar file in the following directory:
process-engine/ext
Schema
The schema name, which varies by database. Use the following guidelines for the schema name:
- IBM DB2: Use the schema name to specify the correct object.
- Microsoft SQL Server: Use the schema name to specify the correct object.
- MySQL: Optional. The schema name is the database name.
- Oracle: Optional. The schema name is the user name.
- PostgreSQL: Use the schema name to specify the correct object.
If the JDBC connection URL does not provide enough context, you must enter a schema name to fetch the metadata.