Configuring the Adapter for Snowflake Cloud Data Warehouse (JDBC)

Configuring the adapter consists of specifying connection and authentication information for each of the connections you want to establish.

Configure the Snowflake Cloud Data Warehouse Adapter (JDBC)

You can configure the adapter from either the WebFOCUS Reporting Server browser interface or ibi Data Migrator desktop interface.

    Procedure
  1. From the WebFOCUS Reporting Server browser interface Applications page, click Get Data.

    or

    From the ibi Data Migrator desktop interface, expand the Adapters folder.

    In the WebFOCUS Reporting Server browser interface, the Get Data page opens showing your configured adapters. In the ibi Data Migrator desktop interface, the Adapters folder opens.

  2. In the WebFOCUS Reporting Server browser interface, click the (+) button, and find the adapter on the page or, in the ibi Data Migrator desktop interface, exapnd the Available folder if it is not already expanded.

    In the WebFOCUS Reporting Server browser interface, you can select a category of adapter from the drop-down list or use the search option (magnifying glass) to search for specific characters.

  3. In the ibi Data Migrator desktop interface, expand the appropriate group folder and the specific adapter folder. The group folder is described in the connection attributes reference.
  4. Right-click the adapter name and/or version and select Configure.

    The Add Adapter to Configuration pane opens.

  5. Enter values for the parameters required by the adapter, as described in the chapter for the specific adapter you want to configure.
  6. Click Configure. The configured adapter is added to the Configured list in the WebFOCUS Reporting Server browser interface or in the Adapters list in the ibi Data Migrator desktop interface resources tree.

    In the WebFOCUS Reporting Server browser interface, the adapter remains on the Available Adapters list with an asterisk to indicate that at least one connection has been configured. You can configure additional connections from either the Configured or Available list by right-clicking the adapter and clicking Add Connection.

Snowflake Cloud Data Warehouse Adapter Configuration Settings (JDBC)

The Adapter for Snowflake Cloud Data Warehouse is under the SQL group folder.

Connection name

Logical name used to identify this particular set of connection attributes. The default is CON01.

URL

Is the URL to the Snowflake data source.

The basic syntax is:

jdbc:snowflake://Server/?warehouse=&|db=&|schema=

You can add any additional connection parameters, such as tracing=off, by first adding the delimiter characters ampersand followed by a vertical bar (&|) to the end of the string.

Security

There are three methods by which a user can be authenticated when connecting to a database server:

  • Explicit. The user ID and password are explicitly specified for each connection and passed to the database, at connection time, for authentication.
  • Password Passthru. The user ID and password received from the client application are passed to the database, at connection time, for authentication.
User

Primary authorization ID by which you are known to the data source.

Password

Password associated with the primary authorization ID.

Driver Name

Is the name of the JDBC driver. For example:

net.snowflake.client.jdbc.SnowflakeDriver
IBI_CLASSPATH

Is the jar classpath for the driver. For example:

/qas/snowflake/snowflake-jdbc-3.6.3.jar
Security

There are two methods by which a user can be authenticated when connecting to a database server:

  • Explicit. The user ID and password are explicitly specified for each connection and passed to the database, at connection time, for authentication.
  • Key Pair Authentication. As a minimum, this authentication method requires a 2048-bit RSA key pair. The public key is assigned to the user. For the user authentication, the public key is verified based on the private key submitted with the connection information. For more information, please refer to the Configuring Key Pair Authentication chapter of the Snowflake documentation.

EXPLICIT

The following are the connection attributes for the Explicit security method:

User

Primary authorization ID by which you are known to the data source.

Password

Password associated with the primary authorization ID.

KEY PAIR AUTHENTICATION

The following are the connection attributes for the Key Pair Authentication security method:

User

Primary authorization ID by which you are known to the data source.

Private key file password

Is a password that is used to protect the private key.

Private key file location

Is a secure location of the private key. The private key file location can be on a network, for example:

\\example.cloud.com\sno\keys\rsa_key.p8

Or it can be in a local directory, for example:

/qa/sno/keys/rsa_key.p8
Note: You can use either the slash (/) or backslash (\) character as a delimiter in the pathname for any operating system, UNIX, Linux, or Windows.
Advanced Parameters

There are four Advanced Parameters:

  • Driver Name (Optional). Is the name of the JDBC driver. For example: 
    net.snowflake.client.jdbc.SnowflakeDriver
  • IBI_CLASSPATH. Is the jar classpath for the driver. For example: 
    /qas/snowflake/snowflake-jdbc-3.6.3.jar
  • Allow Data Load. Select Yes to allow Upload, Quick Copy, and Custom Copy for a given connection. The default value is Yes.
  • Connection Description (Optional). User-defined notes used to describe the given connection. This parameter is optional.
Environment

Allows you to define required and informational Environment variables. You must define the required variables before starting the server.

There are three Environment parameters:

  • CLASSPATH. Directory search path for JVM or Java-based applications to find user-defined classes and packages, if not defined in IBI-CLASSPATH.
  • PATH. Directory search path for executable programs that are not in the current directory or called by full path name. To verify if this setting is required, check the vendor documentation.
  • LD_LIBRARY_PATH. Directory search path for DLL files that are used directly or indirectly by a called executable or DLL file. To verify if this setting is required, check the vendor documentation.
Select profile

Select a profile from the drop-down menu to indicate the level of profile in which to store the CONNECTION_ATTRIBUTES command. The global profile, edasprof.prf, is the default.

If you wish to create a new profile, either a user profile (user.prf) or a group profile if available on your platform (using the appropriate naming convention), choose New Profile from the drop-down menu and enter a name in the Profile Name field (the extension is added automatically).

Store the connection attributes in the server profile (edasprof).

Always use the characters &| (ampersand followed by the vertical bar) as the parameter separator in the URL for the JDBC type of Snowflake adapter.

Extended Bulk Load functionality is supported with the JDBC type of Snowflake Adapter and does not require any additional configuration steps.