Connecting Astrato to ClickHouse

Astrato uses Pushdown SQL to query ClickHouse Cloud or on-premise deployments directly. This means you can access all of the data you need, powered by the industry-leading performance of ClickHouse.

Connection data required

When setting up your data connection, you'll need to know:

• Data connection: Hostname, Port

• Database Credentials: Username, Password

To connect to ClickHouse with HTTP(S) you need this information:

• The HOST and PORT: typically, the port is 8443 when using TLS or 8123 when not using TLS.

• The DATABASE NAME: out of the box, there is a database named default, use the name of the database that you want to connect to.

• The USERNAME and PASSWORD: out of the box, the username is default. Use the username appropriate for your use case.

The details for your ClickHouse Cloud service are available in the ClickHouse Cloud console. Select the service that you will connect to and click Connect:

Choose HTTPS, and the details are available in an example curl command.

If you are using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.

Creating the data connection to ClickHouse

• Select Data in the sidebar, and select the Data Connection tab (or, navigate to this link: https://app.astrato.io/data/sources) ​
• Click on the New Data Connection button in the top right side of the screen.

• Select ClickHouse.

  

• Complete the required fields in the connection dialogue box

• Click Test Connection. If the connection is successful, give the data connection a name and click Next.

• Set the user access to the data connection and click connect.
  ​

  

• A connection is created and a dataview is created.

Note

if a duplicate is created, a timestamp is added to the data source name.

Creating a semantic model / data view

In our Data View editor, you will see all of your Tables and Schemas in ClickHouse, select some to get started.

Now that you have your data selected, go to define the data view. Click define on the top right of the webpage.

In here, you are able to join data, as well as, create governed dimensions and measures - ideal for driving consistency in business logic across various teams.

Astrato intelligently suggests joins using your meta data, including leveraging the keys in ClickHouse. Our suggested joins make it easy for you to gets started, working from your well-governed ClickHouse data, without reinventing the wheel. We also show you join quality so that you have the option to review all suggestions, in detail, from Astrato.

Creating a dashboard

In just a few steps, you can build your first chart in Astrato.

1. Open visuals panel
2. Select a visual (lets start with Column Bar Chart)
3. Add dimension(s)
4. Add measure(s)

View generated SQL supporting each visualization

Transparency and accuracy are at the heart of Astrato. We ensure that every query generated is visible, letting you keep full control. All compute happens directly in ClickHouse, taking advantage of its speed while maintaining robust security and governance.

Example completed dashboard

A beautiful complete dashboard or data app isn't far away now. To see more of what we've built, head to our demo gallery on our website. https://astrato.io/gallery