Query Ocient

Quick Start Querying

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

Run 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:

Text


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:

Text


Step 2: Connect

Start the JDBC CLI according to the instructions in Connect Using JDBC. You will be asked to supply 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


Enter the connect statement using your connection string:

Shell


You will receive a response similar to Connected to to jdbc:ocient://10.10.1.1:4050/system indicating that you are now connected.

Step 3: Run 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


To filter this information, use the LIKE predicate.

SQL


Now that you are connected, you can run any SQL Queries, or perform Database Administrator operations like Data Definition Language (DDL) Command Reference or Data Control Language (DCL) Command Reference where you have permission.

Related Links

SQL Reference

Updated 19 Jun 2024
Did this page help you?
Yes
No