Create a Database Target¶

Introduction¶

A Database target provides write access to databases using JDBC or ODBC drivers.

Create a Database Target¶

You can choose to create a new Database target on its own, or within an existing operation. For more information on how targets work within operations, see Creating an Operation.

Create a New Database Target as a Standalone Target¶

Within your project in Jitterbit Design Studio, you create a new Database target by any of:

• Go to File > New > New Target; or

• In the tree on the left, right-click on Targets and select New Target; or

• In the top toolbar, click the blue target icon .

In the popup, select Database as the type:

Your new target appears in its own New Target tab in the right pane of the window.

Create a New Database Target in an Existing Operation¶

A target is usually created by default when you create a new operation. (The exception is an operation that consists only of a script.) With an existing operation, you can specify the type of its target by:

• Double-clicking on the target icon; in the popup, select Create New Target; or

• Right-clicking on the target icon and selecting Create New Target.

In the configuration screen that appears, use the Type dropdown to select Database, as shown above.

Use an Existing Database Target in an Existing Operation¶

To use an existing Database target in an existing operation with a target, you can set it by any of:

• Within the operation, double-clicking on the target icon, and in the resulting popup, selecting the desired Database target from the list; or

• Within the operation, right-clicking on the target icon, choosing Select Existing Target, and in the resulting popup, selecting the desired Database target from the list; or

• Dragging the desired Database target from the tree on the left and dropping it onto the existing target icon of the operation.

Configure a Database Target¶

After you have created a Database target, the configuration screen will open in the main view of Design Studio. You can return to the configuration screen at any time by double-clicking on the target icon in the operation, or by double-clicking on the target in the tree on the left.

Basic Configuration¶

The configuration screen will appear similar to this example:

• Name: Enter an appropriate, unique name for the source.
• Type: Use the dropdown to select Database, if it is not already specified.
• Connection Parameters: Specify the details for your database connection:
  • Driver: Enter a driver name, either manually or by clicking the select Button (preferred) next to the driver field. Depending on the driver selected (see Database Drivers below), certain fields in the source configuration are enabled or disabled.
  • Server Name: Enter either the server name or IP address of the server to be accessed.
  • Database Name: Enter the database name to be accessed.
  • Login: If a login is required, enter a valid username into the Login field.
  • Password: Enter a password to use with the Login to access the database.
  • Use default port: The default port will vary depending on the database driver selected. For a different port, deselect the Use default port checkbox and enter a port to use in the Port field.
• Test Connection: Clicking the button will test the Database source; it will fail if it is unable to make a connection to the database server with the provided connection parameters.
• Click the Save button in either the main toolbar or the target's toolbar to save the configuration.

Database Drivers¶

The database drivers dialog will appear similar to this example:

Clicking the Refresh button will update the displayed list of drivers available on the Agent. The list can be filtered by type (JDBC or ODBC) and name. (ODBC drivers are supported only on Private Agents.) Depending upon the driver selected, certain fields in the source configuration are enabled or disabled. To add additional drivers to an Agent, see Install Additional ODBC or JDBC Drivers.

The available drivers depend on whether you are using Cloud Agents or Private Agents.

Cloud Agents¶

Cloud Agent Groups support JDBC drivers only. These JDBC drivers are provided:

• IBM DB2 (AS400)
• MySQL
• Oracle
• Oracle NetSuite
• PostgreSQL
• Redshift
• SQL Server jTDS
• SQL Server MS JDBC
• Sybase jTDS

Private Agents¶

Private Agents support JDBC drivers and ODBC drivers. For ODBC drivers, the architecture of the driver must match the system of the agent. That is, 32-bit agents support 32-bit ODBC drivers and 64-bit agents support 64-bit ODBC drivers.

These JDBC drivers are provided by 64-bit Windows and Linux Private Agents:

• Amazon Redshift
• IBM DB2 (AS400)
• IBM DB2 (JCC)
• MySQL
• Oracle
• Oracle NetSuite
• PostgreSQL
• SQL Server jTDS
• SQL Server Microsoft
• SQLite
• Sybase jTDS

These ODBC drivers are bundled with the 64-bit Windows Private Agent installation:

• PostgreSQL ANSI (x64)
• PostgreSQL Unicode (x64)

This ODBC driver is bundled with the 64-bit Linux Private Agent installation:

• PostgreSQL-jitterbit

Additional drivers are detected from the operating system. You can install additional database drivers as needed.

Options¶

Additional connection parameters can be specified by clicking the Options at the bottom of the Connection Parameters section:

• Optimize for Bulk Data: Available when using a Microsoft SQL Server or an Oracle database as a transformation target, enabling this option improves performance when upserting large amounts of data. (Available as of Harmony version 8.7.0.)

• Transaction Isolation Level: Specify an isolation level using the dropdown menu. The DEFAULT setting uses the driver or database server default transaction isolation level. Driver-specific levels are not supported; available are Transact-SQL transition isolation levels:

  

• Timeout (sec): Specifies the limit to wait for a successful database connection in seconds. Default is 300 seconds (5 minutes).

• Additional Connection String Parameters: Additional parameters that should be added to the database connection string can be entered in this field. Connection string parameters are specific to the database driver you use (i.e. Microsoft SQL, MySQL, PostgreSQL, Oracle, etc.). Review the driver specifications to determine the required parameters.

• Construct connection string manually: Checking this allows entry of the connection string manually in the field below the checkbox. It will then disable the Additional Connection String Parameters. See Manual connection string for details.