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.
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.
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:
You will be prompted to enter the username and password. Enter these when prompted. For example:
Then you will be greeted with an Ocient CLI prompt.
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:
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.