Skip to main content

Clickhouse

ClickHouse is an open-source, high performance columnar OLAP (online analytical processing) database management system for real-time analytics using SQL. It's particularly well-suited for large-scale data warehousing and analytics tasks.

Timbr + ClickHouse Logo

Integrating ClickHouse with Timbr combines the strengths of both platforms. It allows you to use Timbr's semantic graph capabilities alongside ClickHouse's lightning-fast query processing and real-time analytics features. This integration enhances your ability to perform semantic querying, data virtualization, and integrated data management on large datasets, leading to deeper insights and more efficient data operations.

Getting Started with Clickhouse​

If you haven't yet formed a connection with a Clickhouse database, follow the steps provided in the links below to set up and connect to Clickhouse:

To connect Timbr to your ClickHouse datasource, you need to use the ClickHouse JDBC driver. For information on the ClickHouse JDBC driver and how to set it up, refer to the ClickHouse JDBC Driver documentation.

Connecting Timbr to ClickHouse in the Timbr Platform​

Once you've set up a ClickHouse database and have the JDBC driver ready, it's time to connect Timbr to ClickHouse. Follow the steps below for a detailed tutorial on connecting Timbr to ClickHouse:

  1. Navigate to Manage Datasources: From the Timbr interface, click on the Manage tab and select Datasources.

  2. Add New Datasource: On the top right, click the Add New Datasource button. Alternatively, you can click the big add button beneath the knowledge graphs and datasources tabs.

Add new datasource

  1. Fill in Connection Details: A pop-up window will appear where you need to provide the relevant connection details to connect ClickHouse to Timbr.

There are two options in Timbr to enter the connection information: Simple or JDBC Url.

On the top right of the pop-up window , the toggle can be switched from Simple to JDBC Url in order to connect the datasource using the relevant JDBC URL.

tabs

Simple Tab Connection Configuration​

  1. Select Simple Tab: Ensure the Simple tab is selected.

  2. Fill in the Following Details:

    • Database Type: Select ClickHouse.
    • Datasource Name: Enter a name for your datasource.
    • Description: Provide a description of the datasource (Optional).
    • Hostname / IP: Enter the hostname or IP address of the ClickHouse server.
    • Port: Default is 8123.
    • Username: Enter your ClickHouse username.
    • Password: Enter your ClickHouse password.
    • Additional Parameters: Add any additional connection parameters using & as separators.

JDBC URL Tab Configuration​

  1. Select JDBC URL Tab: Ensure the JDBC URL tab is selected.

  2. Fill in the Following Details:

    • Database Type: Select ClickHouse.
    • Datasource Name: Enter a name for your datasource.
    • Description: Provide a description of the datasource (Optional).
    • Username: Enter your ClickHouse username.
    • Password: Enter your ClickHouse password.
    • JDBC URL: Enter the JDBC connection URL (e.g., jdbc:ch://[host]:port).

jdbc tab

Save and Test Connection​

  1. After entering the details, click the Save button to save the information, connecting the ClickHouse datasource to the Timbr environment.
  2. Once saved, on the top right, click the Test connection button to verify the datasource’s connectivity, ensuring it is active and responsive.

For a comprehensive guide on connecting Timbr to various datasources, refer to the detailed documentation: