Oracle

Knowi enables visualization, warehousing and reporting automation from Oracle along with other structured and unstructured datasources.

Overview

1. Connect, extract and transform data from your Oracle database, using one of the following options:

   • Using our Cloud9Agent. This can securely pull data inside your network. See agent configuration for more details.
   • Through our UI to connect directly, if the database is accessible from the cloud.

2. Visualize and Automate your Reporting instantly.

UI

If you are not a current Knowi user, check out our Oracle Instant Reporting page to get started and sign up.

Connecting

The following image shows how to connect and set up database connectivity.

1. Login to Knowi and select Queries -> New Datasource from the left down menu.

2. Click on Oracle. Either follow the prompts to set up connectivity to your own Oracle database, or, use the pre-configured settings into Knowi's own demo Oracle database.

   If you connecting through an agent, check Internal Datasource to assign it to your agent. The agent (running inside your network) will synchronize it automatically. Alternatively, configure datasource and queries directly into agent.

   When connecting from the UI directly to your Oracle database, please follow the connectivity instructions to allow Knowi to access your database.

3. If you wish to limit the tables available to subsequent queries, please refer to our Access Control List documentation
4. Save the Connection. Click on the "Configure Queries" link on the success bar.

Queries & Reports

1. This section enables you to set up automated queries that can either be run on a schedule or once.

   

   Report Name: Specify a name for the report.

   SQL Query: Modify or enter SQL queries directly.

   Cloud9QL: Optional SQL-Like post processor for the data returned by the SQL query. See Cloud9QL Docs for more details.

   If you're using the Knowi demo Oracle database, click 'Preview' to see the results.

2. Scheduling: Configure how often this should be run. Select 'None' for a one time operation. The results are stored within Knowi.

3. Overwrite Strategy (for scheduled query runs):

   Overwrite Strategies determines how the data is stored in Knowi:

   i. If empty, data will be added on to the existing data for this dataset within Knowi. Or,

   ii. "All": Any existing data for this dataset will be replaced by this results.

   iii. One or More Field Names (Example: "A,B,C"): A new record is created where the values of the combination of the field names do not exist, and, updates current records for the field grouping where it exists. For example, if this is set to say "Date, Type", existing data with the same Date and Type values will be updated with the latest data, and new records created when they do not exist.

4. Click on 'Save' to complete setting up the report. This also sets up this data extraction on a schedule, if configured.

5. Click on 'Dashboards' to access dashboards. You can drag and drop the newly created report from the bottom list into to the dashboard.

Cloud9Agent Configuration

As an alternative to the UI based connectivity above, you can use a Cloud9Agent inside your network to pull from Oracle securely.

Highlights:

• Pull data using SQL.
• Execute queries on a schedule, or, one time.

The agent contains a datasource_example_oracle.json and query_example_oracle.json under the examples folder of the agent installation to get you started.

• Edit those to point to your database and modify the queries to pull your data.
• Move it into the config directory (datasource_XXX.json files first if the Agent is running).

Datasource Configuration:

Query Configuration:

Datasource Example:

[
  {
    "name":"demoOracle",
    "url":"localhost:1521:cloud9demo",
    "datasource":"oracle",
    "userId":"cloud9demo",
    "password":"cloud92014"
  }
]

Query Examples:

[
  {
    "entityName":"Errors",
    "dsName":"demoOracle",
    "queryStr":"select error_condition as 'Error', count 'Count' from errors",
    "frequencyType":"minute",
    "frequency":10,
    "overrideVals":{
      "replaceAll":true
    }
  },
  {
    "entityName":"Queues",
    "dsName":"demoOracle",
    "queryStr":"select Name, size as 'Queue Size', Type from queue",
    "overrideVals":{
      "replaceValuesForKey":["Type"]
    },
    "startTime":"07:20",
    "frequencyType":"daily",
    "frequency":1
  }
]

The first query is run every 10 minutes at the top of the hour and replaces all data for that dataset in Knowi. The second is run once a day at 07:20 AM and updates existing data with the same Type field, or inserts new records otherwise.