Skip to Content

Connect to Data Lake IQ Using the JDBC Driver

0 %
Connect to Data Lake IQ Using the JDBC Driver

Connect to Data Lake IQ Using the JDBC Driver

July 8, 2021
Created by
May 13, 2021
Create and debug a Java application that connects to data lake IQ.

You will learn

  • How to create and debug a Java application that connects to and queries a data lake IQ database
QR code


  • You have completed the first tutorial in this group.

Java Database Connectivity (JDBC) provides an API for accessing databases from Java. An application written to the JDBC standard can be ported to other databases. Database vendors provide JDBC drivers for their database products.

Step 1: Install a JDK

Ensure that you have a Java Development Kit (JDK) installed and make sure it is accessible from your path. Details of the driver and supported versions can be found at JDBC Drivers and Oracle Java SE Support Roadmap.

A few options include:

To verify that the JDK is correctly set up, run the following:

java -version
javac -version

If these commands fail, ensure that the folder they are located in is included in your path.

The following command will install Java on openSUSE Leap 15.2.

sudo zypper install java-11-openjdk-devel
Log on to answer question
Step 2: The SAP IQ JDBC driver

The SAP IQ JDBC driver is a type 2 driver, which means it has a native (non-Java) component. For additional details see Type 2 driver – Native-API driver. The driver is located in %IQDIR17%\Java\sajdbc4.jar on Microsoft Windows and $IQDIR17/java/sajdbc4.jar on Linux. The native component is at %IQDIR17%\Bin64\dbjdbc17.dll on Microsoft Windows and $IQDIR17\lib64\ on Linux.

A native JDBC driver called jConnect is also provided. This tutorial focuses on the SAP IQ JDBC driver.

See JDBC Drivers for additional details.

Log on to answer question
Step 3: Create a Java application that queries data lake IQ
  1. The following commands create a folder named java, enter the newly created directory, create a file named, and open the file in notepad.

    mkdir %HOMEPATH%\DataLakeClientsTutorial\java
    cd %HOMEPATH%\DataLakeClientsTutorial\java
    mkdir ~/DataLakeClientsTutorial/java
    cd ~/DataLakeClientsTutorial/java
  2. Copy the following code into

    import java.sql.*;
    public class JavaQuery {
        public static void main(String[] argv) {
            Connection connection = null;
            try {
                //Option 1
                connection = DriverManager.getConnection("jdbc:sqlanywhere:uid=USER1;pwd=Password1;;ENC='TLS{tls_type=rsa;direct=yes}'");
                //Option 2, the connection properties can be loaded from an ODBC datasource.
                //connection = DriverManager.getConnection("jdbc:sqlanywhere:DSN=HC_HDL_Trial;LOG=myLog.log");  
                //The LOG option is helpful when diagnosing connection issues.
            catch (SQLException e) {
                System.err.println("Connection Failed:");
            if (connection != null) {
                try {
                    System.out.println("Connection to data lake IQ successful!");
                    Statement stmt = connection.createStatement();
                    ResultSet resultSet = stmt.executeQuery("SELECT TITLE, FIRSTNAME, NAME from CUSTOMER;");
                    while ( {
                        String title = resultSet.getString(1);
                        String firstName = resultSet.getString(2);
                        String lastName = resultSet.getString(3);
                        System.out.println(title + " " + firstName + " " + lastName);
                catch (SQLException e) {
                    System.err.println("Query failed!");
  3. Update the host value in the connection string.

  4. Compile the .java file into a .class file using the following command:

    javac -cp %IQDIR17%\Java\sajdbc4.jar;.
    javac -cp $IQDIR17/java/sajdbc4.jar:.
  5. Run JavaQuery.class and indicate where the JDBC driver is located.

    java -classpath %IQDIR17%\Java\sajdbc4.jar;. JavaQuery
    java -classpath $IQDIR17/java/sajdbc4.jar:. JavaQuery
    Java Query

See JDBC Program Structure for additional details.

Log on to answer question
Step 4: Debug the application

Visual Studio Code can run and debug a Java application. It is a lightweight but powerful source code editor available on Microsoft Windows, macOS, and Linux.

  1. If required, Download Visual Studio Code.

  2. In Visual Studio Code, choose File | Open Folder and then add the DataLakeClientsTutorial folder.

  3. Open the file, and if asked, install the recommended extensions.

    Java extensions
  4. Once the Java Extension Pack has been installed, expand the Java Project Explorer and click on the + icon to add the JDBC driver as a referenced library.

    referenced libraries

    The JDBC driver is located at %IQDIR17%\Java\sajdbc4.jar on Microsoft Windows and $IQDIR17/java/sajdbc4.jar on Linux.

  5. Place a breakpoint and then select Run | Start Debugging.

    Notice that the debug view becomes active.

    Notice that the program stops running at the breakpoint that was set. Step through the code by pressing F10 and observe the variable values in the variables pane.

    VS Code Debugging

Congratulations! You have now created and debugged a Java application that connects to and queries a data lake IQ database.

Which of the following statements are true?

Next Steps

Back to top