Establishing a Connection

Creating a JDBC Data Source

You can create a JDBC data source to connect from your Java application, based on CData JDBC Driver for SybaseIQ.

Follow these steps:

Add the driver JAR file to the classpath. The JAR file is located in the installation directory's lib subfolder. Ensure that the .lic file is located in the same folder as the JAR file.
Provide the driver class. For example:
```
cdata.jdbc.sybaseiq.SybaseIQDriver
```
Provide the JDBC URL. For example:
```
jdbc:sybaseiq:user=myuser;password=mypassword;Server=localhost;Database=Northwind
```
Or, if there is a conflict in your application between drivers using the same URL format, use this form to ensure that you are using the CData driver:
```
jdbc:cdata:sybaseiq:user=myuser;password=mypassword;Server=localhost;Database=Northwind
```
Ensure that the URL starts with either jdbc:sybaseiq: or jdbc:cdata:sybaseiq:. The URL can include any of the connection properties in name-value pairs separated with semicolons.

Connecting to SybaseIQ

To connect to the SybaseIQ, specify the following connection properties:

Server: Set this to the name or network address of the SybaseIQ or SAP SQL Anywhere database instance.
Database: Set this to the name of the SybaseIQ or SAP SQL Anywhere database running on the specified Server.

Optionally, you can also secure your connections with TLS/SSL by setting UseSSL to true.

Note: It is also possible to connect to an instance of SAP SQL Anywhere with the above driver configuration.

Authenticating to SybaseIQ

SybaseIQ supports several methods for authentication including Password and Kerberos.

Password

Set the AuthScheme to Password and set the following connection properties to use SybaseIQ authentication.

User: Set this to the username of the authenticating SybaseIQ user.
Password: Set this to the username of the authenticating SybaseIQ user.

Kerberos

To leverage Kerberos authentication, begin by enabling it via the following connection property:

AuthScheme: Set to Kerberos will be used for authentication to SybaseIQ.

See Using Kerberos information regarding the connection properties that need to be set for Kerberos authentication.

You can find an example connection string below:

Server=MyServer;Port=MyPort;User=SampleUser;Password=SamplePassword;Database=MyDB;Kerberos=true;KerberosKDC=MyKDC;KerberosRealm=MYREALM.COM;KerberosSPN=server-name