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 Spark SQL.

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.sparksql.SparkSQLDriver
```
Provide the JDBC URL. For example:
```
jdbc:sparksql:Server=127.0.0.1;
```
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:sparksql:Server=127.0.0.1;
```
Ensure that the URL starts with either jdbc:sparksql: or jdbc:cdata:sparksql:. The URL can include any of the connection properties in name-value pairs separated with semicolons.

Connecting to Spark SQL

Specify the following to establish a connection with Spark SQL:

Server: The host name or IP address of the server hosting SparkSQL.
Port: The port for the connection to the SparkSQL instance.
TransportMode: The transport mode to use to communicate with the SparkSQL server. Accepted entries are BINARY and HTTP. BINARY is selected by default.

Securing Spark SQL Connections

To enable TLS/SSL in the driver, set UseSSL to True.

Authenticating to Spark SQL

The service may be authenticated to using the Anonymous, PLAIN, LDAP, NOSASL, KERBEROS auth schemes.

Anonymous

When using Anonymous, no user credentials are required. The value 'anonymous' is sent for the User and Password fields. Set the following connection properties:

AuthScheme: Anonymous.

PLAIN

To authenticate with PLAIN, set the following connection properties:

AuthScheme: PLAIN.
User: The user to login as.
Password: The password of the user.

To authenticate, set User and Password.

LDAP

To authenticate with LDAP, set the following connection properties:

AuthScheme: LDAP.
User: The user to login as.
Password: The password of the user.

To authenticate, set User, Password, and AuthScheme.

NOSASL

When using NOSASL, no authentication is performed. Set the following connection properties:

AuthScheme: NOSASL.

Kerberos

For details on how to authenticate with Kerberos, see Using Kerberos.