Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ocient.com/llms.txt

Use this file to discover all available pages before exploring further.

This example demonstrates a quick start to begin querying an System.

​
Prerequisites

To get started querying in Ocient, the following are required:
  1. A valid username and password for your Ocient System — These credentials can be obtained from your Database Administrator or System Administrator.
  2. Network access to the SQL Nodes and the IP Address of the Hostname of these nodes in the Ocient System.
  3. The port used for SQL Nodes. By default, this is 4050.
  4. A SQL Client or SQL Driver — This example uses the Ocient JDBC Driver. See Connect Using JDBC.

​
Execute a Query

With these prerequisites, you can construct a connection string for your SQL Client of choice, connect, and begin querying Ocient in a few minutes. This example assumes the use of the JDBC driver and CLI. If using a different connection method, see Connect to Ocient to complete Step 2.

​
Step 1: Create a Connection String

A connection string follows a standard format for Ocient.
SQL
jdbc:ocient://<HOSTNAME_OR_IP_ADDRESS>:<PORT>/<DATABASE>
In this example, you are going to replace each of the placeholders with the following:
  • PORT: 4050
  • HOSTNAME_OR_IP_ADDRESS: 10.10.1.1
  • DATABASE: system
Some systems use a hostname like sql1.example.com instead of an IP Address. Additionally, if you have a database configured already, use that instead of system to access your tables. The final connection string is:
SQL
jdbc:ocient://10.10.1.1:4050/system

​
Step 2: Connect

Start the JDBC CLI according to the instructions in Connect Using JDBC. You need to specify a username and password. The Fully Qualified Username is specified as <username>@<database>, so in your case, for a username of example_user, enter example_user@system. Next, you should see an Ocient CLI prompt:
Shell
Ocient> _
Enter the connect statement using your connection string:
Shell
connect to jdbc:ocient://10.10.1.1:4050/system;
You receive a response similar to Connected to jdbc:ocient://10.10.1.1:4050/system indicating that you are now connected.

​
Step 3: Execute a Query

You can now query any user tables or system catalog tables to which you have access in the database. System Catalog tables provide a wealth of information about the underlying system and configuration. Because you are connected to the system database, you can begin with a few catalog queries. At the Ocient prompt, enter this SQL statement that displays information for all tables in the system.
SQL
Ocient> SELECT * FROM information_schema.tables;
To filter this information, use the LIKE predicate.
SQL
Ocient> SELECT * FROM information_schema.tables WHERE table_name LIKE '%data%';
Now that you are connected, you can execute any SQL queries or perform Database Administrator operations like Data Definition Language (DDL) Statement Reference or Data Control Language (DCL) Statement Reference where you have permission. General SQL Syntax SQL Reference
Last modified on May 27, 2026