Connect to Ocient

Connect via JDBC

The JDBC driver can be executed in a command line interface (CLI) mode or used directly in a program with standard JDBC methods. This example will describe how to connect using the CLI mode. For details on using the JDBC driver in code, please see Establishing a Connection.

Step 1: Download the JDBC Driver

First, confirm the recommended version of the JDBC driver for your version of

 by finding it in Version Compatibility. Download the correct JDBC driver from the

repository by clicking on your preferred version, then selecting "view all" and finally downloading the JAR file that is labeled with the pattern ocient-jdbc4-<version number>-jar-with-dependencies.jar.

Save this file to a convenient location on your client machine.

Step 2: Run the JDBC CLI Program

To run the JDBC CLI Program, you must have java 8 or higher installed on your machine. Next run the following command to start the JDBC CLI Program. Assuming your JAR stored at ~/ocient-jdbc4-jar-with-dependencies.jar:

Shell


You will be prompted to enter the username and password. Enter these when prompted. For example:

Shell


Then you will be greeted with an Ocient CLI prompt.

Example Response:

Shell


Step 3: Connect

To connect, enter the connection string to your SQL Nodes. SQL Nodes install by default with a self-signed TLS certificate for encryption by default, and a custom certificate can be present. Depending on the TLS configuration, you can use tls=unverified (default) or tls=on for the required setting.

Assuming the standard port 4050, a self-signed certificate, and the SQL Node IP Address of 10.10.1.1, you can connect to the system database with the following connecting string:

Shell


Example Response:

Shell


Success! Now you are connected and can execute queries based on your user’s permissions. Try running: select * from sys.tables; to see what tables are defined.

For more details on using the JDBC driver and the CLI program, see the JDBC Manual.