> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> Astrato brings true Self-Service BI to Enterprises & Data Businesses by putting analytics in the hands of every user, enabling them to build their own dashboards, reports and data apps, enabling the answering of data questions without IT help. Astrato accelerates adoption, speeds up decision-making, and unifies analytics, embedded analytics, data input, and data apps in one platform. Astrato unites action and analytics in one, introduce live write-back, interact with ML models, accelerate your analytics with AI – go beyond dashboarding, thanks to pushdown SQL support in Astrato.
# Connecting Astrato to ClickHouse
export const CommunityMaintainedBadge = () => {
return ;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
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:
| Parameter(s) | Description |
| ------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `HOST` and `PORT` | Typically, the port is 8443 when using TLS or 8123 when not using TLS. |
| `DATABASE NAME` | Out of the box, there is a database named `default`, use the name of the database that you want to connect to. |
| `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 a service and click **Connect**:
Choose **HTTPS**. Connection details are displayed in an example `curl` command.
If you're 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](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.
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're 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 dimensions
4. Add measures
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](https://astrato.io/gallery)
