On this Page

Overview

You can create a Generic JDBC Account to connect to data sources that you want to use in your Pipelines. You can configure your Generic JDBC account in SnapLogic using either the Designer or the Manager.

Snap-Account Compatibility

Snap

Generic JDBC Account

Generic JDBC - Execute

Generic JDBC - Insert

Generic JDBC - Select

Generic JDBC - Update


Configuring Generic JDBC Account Using SnapLogic Designer

Drag a Generic JDBC Snap to the Canvas and click the Snap to open its settings. Click the Account tab. You can now either use an existing account or create a new one.

Selecting an existing account

SnapLogic organizes and displays all accounts to which you have access, sorting them by account type and location. To select an existing account:

  1. In the Account tab, click the Expand(blue star)  icon to view the accounts to which you have access, and select the account that you want to use.

  2. Click the Save (blue star) icon.

Creating an account

  1. In the Account tab, click Add Account below the Account Reference field.

  2. Select the Location in which you want to create the account, select the Generic JDBC Account Type, and click Continue. The Add Account dialog window associated with the account type is displayed.

  3. Enter the required account details. Learn more on how to provide information for the account type in Generic JDBC account.

  4. Click Validate to verify the account, if the account type supports validation.

  5. Click Apply to complete configuring the Generic JDBC account.

Enter additional information on this account in the Notes field of the Info tab. This will help you–and other users–understand the purpose of the account, especially if there are multiple accounts of the same type.

Configuring Generic JDBC Account Using SnapLogic Manager

You can use Manager to create accounts without associating them immediately with Pipelines.

note

Accounts in SnapLogic are associated with projects. You can use accounts created in other projects only if you have at least Read access to them.

Accounts in SnapLogic are associated with projects. You can use accounts created in other projects only if you have at least Read access to them.

  1. In the left pane, browse to the project in which you want to create the account and click (blue star) > Account JDBC > Generic JDBC Account, followed by the appropriate account type. The Create Account dialog associated with the selected account type is displayed.

  2. Repeat steps 3 through 5 in the Creating an account section. 

note

Avoid updating account credentials while Pipelines using that account are executing. Doing so may lead to unexpected results, including your account getting locked.

Avoid updating account credentials while Pipelines using that account are executing. Doing so may lead to unexpected results, including your account getting locked.

Account Encryption

Standard Encryption

If you are using Standard Encryption, the High sensitivity settings under Enhanced Encryption are followed.

Enhanced Encryption

If you have the Enhanced Account Encryption feature, the following fields are encrypted for each sensitivity level selected for this account.

  • High: Password

  • Medium + High: Username, password

  • Low + Medium + High: Username, password, JDBC URL

Active Directory authentication

SnapLogic supports Active Directory authentication for SQL server for mssql-jdbc-6.2.2-jre8.jar driver. Ensure that you have installed the mssql-jdbc-6.2.2-jre8.jar file. Also, use the following configurations in Account Settings to configure Active Directory authentication:

SnapLogic supports Active Directory authentication for SQL Server using the User impersonation method. The prerequisites are as follows:

Connecting to Athena Database Using Athena JDBC Driver

Athena JDBC Driver 1.x versions are deprecated, and the Generic JDBC Snaps are not compatible with them. Therefore, we recommend you use Athena JDBC Driver 2.x or later for the AWS Athena database when using Generic JDBC Snaps.

Connecting to Cassandra Database Using Cassandra Simba Driver

To connect to the Cassandra database using the Cassandra Simba driver, ensure that the appropriate Simba JAR files are installed based on the version of JDK in the Snaplex node. Contact your Org admin to know the JDK in the Snaplex node. Learn more about the JAR version to be used: JDBC Install Guide.

Besides the JAR files, configure the following settings in the Account Settings when using the Cassandra Simba driver:

note

For JDK 11 and Above

  • For JDK 11 and above, use version 4.2 of the Cassandra Simba Driver.

  • Of the JARs included with version 4.2, do not include the following since they are already provided as part of the Snap pack:

    • asm-5.0.3.jar

    • guava-16.0.1.jar

    • jackson-annotations-2.6.0.jar

    • jackson-core-2.6.3.jar

    • jackson-databind-2.6.3.jar

    • joda-time-2.9.1.jar

    • metrics-core-3.1.2.jar

    • snappy-java-1.1.2.6.jar

    • slf4j-api-1.7.7.jar

    • netty-transport-4.0.37.Final.jar

    • netty-handler-4.0.37.Final.jar

    • netty-common-4.0.37.Final.jar

    • netty-codec-4.0.37.Final.jar

    • netty-buffer-4.0.37.Final.jar

For JDK 11 and Above

  • For JDK 11 and above, use version 4.2 of the Cassandra Simba Driver.

  • Of the JARs included with version 4.2, do not include the following since they are already provided as part of the Snap pack:

    • asm-5.0.3.jar

    • guava-16.0.1.jar

    • jackson-annotations-2.6.0.jar

    • jackson-core-2.6.3.jar

    • jackson-databind-2.6.3.jar

    • joda-time-2.9.1.jar

    • metrics-core-3.1.2.jar

    • snappy-java-1.1.2.6.jar

    • slf4j-api-1.7.7.jar

    • netty-transport-4.0.37.Final.jar

    • netty-handler-4.0.37.Final.jar

    • netty-common-4.0.37.Final.jar

    • netty-codec-4.0.37.Final.jar

    • netty-buffer-4.0.37.Final.jar

Typical JDBC Connection Properties for Various Databases

SAP HANA

To download SAP HANA you must have an SAP ID and download it at http://www.sdn.sap.com/irj/scn/go/portal/prtroot/docs/webcontent/uuid/402aa158-6a7a-2f10-0195-f43595f6fe5f

Sybase

jConnect provides high performance native access to the complete family of Sybase products, including Adaptive Server Enterprise, Adaptive Server Anywhere, Adaptive Server IQ, and Replication Server.

The jConnect JDBC driver is usually delivered as a zip file. First, you need to unzip this file and locate the jconn4.jar file, which usually is stored in the classes directory.

You can download the Sybase JDBC Driver from here.

Another open-source alternative to connect Sybase database is  jTDS Drivers, which you can find at http://jtds.sourceforge.net/.

jTDS Driver 

Examples

This section provides examples of JDBC connection details for different sources. Note that specifics may vary based on the Operating System or Database version.

Hive

Varies based on version. See https://cwiki.apache.org/confluence/display/Hive/HiveServer2+Clients#HiveServer2Clients-JDBC for general information on Hive JDBC Drivers for HiveServer2.

Informix

Log into Informix with your IBM account to be able to download the Informix JDBC drivers and upload them into SnapLogic.

JDBC ODBC Bridge

Oracle does not support the JDBC-ODBC Bridge from Java 8 and recommends using JDBC drivers provided by the vendor for database. However, if the database vendor supports the JDBC ODBC bridge, then you can use it with the JDBC Snap Pack, but SnapLogic does not certify any JDBC ODBC bridge connections.

SAP Hana

Sybase

Teradata


Troubleshooting

Key

Value

jcc.jvm_options

-Dcom.mysql.cj.disableAbandonedConnectionCleanup=true 

If the Snap fails to connect to the database, it retries three times.

Snap Pack History