MySQL Datasource Integration

Knowi enables data discovery, query, aggregation, visualization and reporting automation from MySQL along with other unstructured and structured datasources.

Overview

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

    a. Using our Cloud9Agent. This can securely pull data inside your network. See agent configuration for more details.

    b. Through our UI to connect directly.

  2. Visualize and Automate your Reporting instantly.

UI Based Approach

Connecting

  1. Log in to Knowi and select Queries from the left sidebar.

  2. Click on New Datasource + button and select MySQL from the list of datasources.

  3. After navigating to the New Datasource page, either use the pre-configured settings into Cloud9 Chart's own demo MySQL database or follow the prompts and configure the following details to set up connectivity to your own MySQL database:

    a. Datasource Name: Enter a name for your datasource
    b. Host Name: Enter the host name to connect to
    c. Port: Enter the database port
    d. Database Name: Enter database name
    e. User ID: Enter the User ID to connect
    f. Password: Enter the password to connect to the database
    g. Database Properties: Additional database connection properties. For example, for zero dates in your database that you would like to treat as null, use zeroDateTimeBehavior=convertToNull

  4. Establish Network connectivity and click on the Test Connection button.

    Note: The connection validity of the network can be tested only if it has been established via Direct Connectivity or an SSH tunnel. For more information on connectivity and datasource, please refer to the documentation on- Connectivity & Datasources.

  5. Click on Save and start Querying.

MySQL Connect

Query

Step1: Query using a visual builder or query editor
Visual Builder: After connecting to the MySQL datasource, Knowi will pull out a list of tables along with field samples. Using these tables, you can automatically generate queries through our visual builder in a no-code environment by either dragging and dropping fields or making your selections through the drop-down.

Query MysqlDB

Tip: You can also write queries directly in the Query Editor, a versatile text editor that offers more advanced editing functionalities like MySQL Query, support for multiple language modes, Cloud9QL, and more.

Furthermore, you can also use the Format button in the query editor to auto-format the query text for indentation, spaces, and more.

format MysqlDB

Step 2: Define data execution strategy by using any of the following two options:

  • Direct Execution: Directly execute the Query on the original Datasource, without any storage in between. In this case, when a widget is displayed, it will fetch the data in real time from the underlying Datasource.

  • Non-Direct Execution: For non-direct queries, results will be stored in Knowi?s Elastic Store. Benefits include- long-running queries, reduced load on your database, and more.

Non-direct execution can be put into action if you choose to run the Query once or at scheduled intervals. For more information, feel free to check out this documentation- Defining Data Execution Strategy

Data Strategy MysqlDB

Step 3: Click on the Preview button to analyze the results of your Query and fine-tune the desired output, if required.

Preview Results

The result of your Query is called Dataset. After reviewing the results, name your dataset and then hit the Create & Run button.

Create and Run


Cloud9Agent Configuration

As an alternative to the UI based connectivity above, you can use Cloud9Agent inside your network to pull from MySQL securely. See Cloud9Agent to download your agent along with instructions to run it.

Highlights:

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

The agent contains a datasource_example_mysql.json and query_example_mysql.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:

Parameter Comments
name Unique Datasource Name.
datasource Set value to mysql
url URL to connect to, where applicable for the datasource. Example for MySQL: localhost:3306/test
userId User id to connect, where applicable.
Password Password, where applicable
userId User id to connect, where applicable.

Query Configuration:

Query Config Params Comments
entityName Dataset Name Identifier
identifier A unique identifier for the dataset. Either identifier or entityName must be specified.
dsName Name of the datasource name configured in the datasource_XXX.json file to execute the query against. Required.
queryStr MySQL SQL query to execute. Required.
frequencyType One of minutes, hours, days,weeks,months. If this is not specified, this is treated as a one time query, executed upon Cloud9Agent startup (or when the query is first saved)
frequency Indicates the frequency, if frequencyType is defined. For example, if this value is 10 and the frequencyType is minutes, the query will be executed every 10 minutes
startTime Optional, can be used to specify when the query should be run for the first time. If set, the the frequency will be determined from that time onwards. For example, is a weekly run is scheduled to start at 07/01/2014 13:30, the first run will run on 07/01 at 13:30, with the next run at the same time on 07/08/2014. The time is based on the local time of the machine running the Agent. Supported Date Formats: MM/dd/yyyy HH:mm, MM/dd/yy HH:mm, MM/dd/yyyy, MM/dd/yy, HH:mm:ss,HH:mm,mm
c9QLFilter Optional post processing of the results using Cloud9QL. Typically uncommon against SQL based datastores.
overrideVals This enables data storage strategies to be specified. If this is not defined, the results of the query is added to the existing dataset. To replace all data for this dataset within Knowi, specify {"replaceAll":true}. To upsert data specify "replaceValuesForKey":["fieldA","fieldB"]. This will replace all existing records in Knowi with the same fieldA and fieldB with the the current data and insert records where they are not present.

Examples

Datasource Example:

[
  {
    "name":"demoMySQL",
    "url":"localhost:3306/test",
    "datasource":"mysql",
    "userId":"a",
    "password":"b"
  }
]

Query Examples:

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

  }
]

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.

Advanced Example (multiple databases with wildcard database name matching):

The following example:

  • Connects to a set of MySQL databases using a wildcard database names.
  • Executes queries against all databases from that match group and combines the data.
  • Executes a Cloud9QL to further aggregate the data.
  • Connects and pulls data from a set of MySQL databases using a wildcard name match, to then combine and aggregate the data.
  • Resulting data from both MySQL and MySQL databases are stored into the same dataset.

Datasource:

[
  /* Wildcard token to connect to multiple databases with the same schema */
  {
    "name":"demoMySQLGroup",
    "url":"localhost:3306/app_${c9_wildcard}_somepostfix",
    "datasource":"mysql",
    "userId":"a",
    "password":"b"
  },
  {
    "name":"demoMongoGroup",
    "url":"dharma.mongohq.com:10071/cloud9${c9_wildcard}_acc",
    "datasource":"mongo",
    "userId":"x",
    "password":"y"
  }
]

Query:

[
  {
    "entityName":"Multiple Databases",
    "dsName":"demoMySQLGroup",
    /* Executes against multiple databases and combines the result */
    "queryStr":"select * from sometable",
    /* Optional c9QL that runs on the combined query results. */
    "c9QLFilter":"select count(*) as Total count, \"MySQL Counts\" as Type",
    "overrideVals":{
      "replaceValuesForKey":["Type"]
    }
  },
  {
    "entityName":"Multiple Databases",
    "dsName":"demoMongo",
    /* Runs a Mongo Query on all matched databases and combines them*/
    "queryStr":"db.pageviews.find({lastAccessTime: { $exists: true}})",
    /* Optional C9QL to Aggregate the data further*/
    "c9SQLFilter":"select count(*) as Total counts,\"Mongo Counts\" as Type",
    "overrideVals":{
      "replaceValuesForKey":["Type"]
    }
  }
]