Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can use Database Info activity to specify the Server URL (JDBC URL), Username and Password to access the database. Server URL points to a specific database on a specified database server. There is no standard for Server URL. Every JDBC driver uses a slightly different syntax. For example, a Server URL for a MySQL database using the com.mysql.jdbc driver might look like this:

jdbc:mysql://localhost/databaseName

Database Info uses database driver to connect to the specified Database Server.

Prerequisites

Ensure that you have created a Database Driver activity before creating Database Info Activity.


Steps to create Database Info

  1. Click Configure > ACCOUNTS > Database Info. 

  2. Click CREATE Database Info.
  3. On Create Database Info window screen, enter the name and description of the new Database Source in the Name and Description textboxes fields respectively.



  4. Select an existing JDBC database driver activity from the in the Select JDBC Driver drop-down list field.
    To use a new JDBC database driver activity, click Create New

    Info

    For information on how to create a database driver activity, refer to Creating Database Driver.


  5. Enter the Server URL. Click Help displayed adjacent to the Server URL text box to field to get help in defining the Server URL.
    For example, for database format SQL-JTDS, the URL format is- jdbc:jtds:sqlserver://<databaseServerName>:<port>/<databaseName>.
  6. Enter the username of the database server in the User text box field.
  7. Enter the password for the username of the database in the Password and Confirm Password text boxes fields.
  8. Enter the name of the schema in the Select Schema Name or click Browse Schema to browse the schema on the database whose connection you have just created.

    Info
    While creating an activity, for example, an Advanced Database target, you can override the Schema you have used for this Database Info.
    You can override the DB schema dynamically by defining a Process Flow variable/Transaction Parameter, Service.<DBInfoName>.Schema, and setting its value as the Schema that you want to use.


  9. Select Enable Connection Pooling check box to enable database connection pooling.
  10. Select a database connection pool in the Select Connection Pool field based on your requirement. The available options are Hikaric3p0, and Universal Connection Pool (UCP).

    Warning
    titleImportant
    If you are using a Database Source associated with this Database Info in a Process Flow, you can set the connection pool as Universal Connection Pool to improve the Database Source execution time.


  11. Enter the maximum number of connections in the Maximum Connections text box fields that you want to keep in your connection pool at any time, default is 10.

    Info
    If you enter 0 in the Maximum Connections text box field then the activity will keep an unlimited number unlimited number of connections in the connection pool.


  12. Enter the minimum number of connections in the Minimum Connections text box that field that you want to keep in your connection pool at any time, default is 3.
  13. Enter the time in the Maximum Idle Time (seconds) text box field. This field allows you to keep an ideal connection in the connection pool as per the time specified, default is 10.
  14. Enter the time, in milliseconds, in the Maximum Wait Time When Exhausted (milliseconds) text box that field that you want the client to wait for a connection to be checked-in or acquired when the pool is exhausted.

     


    Info
    If you enter 0 in the Maximum Wait Time When Exhausted (milliseconds) field then the client will wait indefinitely.


  15. Click Test Database Connection to verify the connection between Adeptia Connect and Database.

    Info
    • If you edit any Database Info activity while it is being used at run-time then it would re-initialize the connection pool.
    • Apart from the four connection pooling settings that are visible on the Create New Database Info screen, you can change a lot of other settings of database connection pooling in the c3p0.properties file which you can find at .../<Adeptia Connect Installation folder>/AdeptiaServer/ServerKernel/etc.
    • You can also configure the c3p0.properties file for a particular Database Info activity. For this you can make a copy of c3p0.properties file and append the activity ID of the database info activity. For example, c3p0_<activityID>.properties. 

      Here <activityID> is the 30 digit ID of the Database Info activity. 
      When you use this file then at the time of execution, the connection pool properties defined in this file are used instead of the one defined in c3p0.properties file. 



  16. Expand Advanced Properties and select the project of the activity from in the drop-down list of  Project field.

  17. Click Save.