Last update: 2025-12-17T09:59:55.000Z
Content:
---
title: "Connect Superset to Tinybird · Tinybird Docs"
theme-color: "#171612"
description: "This guide covers the steps to connect Apache Superset to Tinybird using the ClickHouse database driver, enabling modern data exploration and visualization."
inkeep:version: "forward"
---




# Connect Superset to Tinybird [¶](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-superset#connect-superset-to-tinybird)

Copy as MD Apache Superset can connect to Tinybird using the ClickHouse® database driver, taking advantage of Tinybird's ClickHouse® HTTP protocol compatibility. This enables you to create interactive dashboards, explore data, and build advanced visualizations with your Tinybird data.

The ClickHouse® connection to Tinybird is read-only. You can use it to visualize and analyze data from your Tinybird data sources, but you cannot modify data through this connection.

## Prerequisites [¶](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-superset#prerequisites)

- Apache Superset instance (self-hosted or cloud)
- ClickHouse® database driver installed ( `clickhouse-driver`   Python package)
- A Tinybird workspace with data sources
- A Tinybird Auth Token with scopes `WORKSPACE:READ_ALL`   and optionally `ORG_DATASOURCES:READ`   . See[  how to create it](../clickhouse-interface#auth-token-requirements)  .

## Add Tinybird as a database [¶](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-superset#add-tinybird-as-a-database)

1. **  Access Admin Interface**   : In Superset, click**  Settings**   >**  Database Connections**
2. **  Add Database**   : Click the**  + Database**   button
3. **  Select ClickHouse®**   : Choose**  ClickHouse®**   from the database type dropdown

### Connection configuration [¶](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-superset#connection-configuration)

Host: clickhouse.tinybird.co
Port: 443
Database Name: <WORKSPACE_NAME> 
Display Name: Tinybird prod # Choose a descriptive name See the list of [ClickHouse hosts](../clickhouse-interface#clickhouse-interface-hosts) to find the correct one for your region.

### Authentication settings [¶](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-superset#authentication-settings)

Username: <WORKSPACE_NAME>  # not used for auth, helps you identify the connection
Password: <TOKEN>   # Your Tinybird Auth Token
SSL: yes
1. **  Save the database**   : Click**  Finish**   to add the database to Superset



<-figure->
![Superset ClickHouse® connection configuration](/docs/_next/image?url=%2Fdocs%2Fimg%2Fsuperset-clickhouse-connection.png&w=3840&q=75)

<-figcaption->
Superset ClickHouse® connection configuration

</-figcaption->


</-figure->
#### Alternative SQLAlchemy URI format [¶](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-superset#alternative-sqlalchemy-uri-format)

clickhousedb://<WORKSPACE_NAME>:<TOKEN>@clickhouse.<REGION>.tinybird.co:443/<WORKSPACE_NAME>
## Test the connection [¶](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-superset#test-the-connection)

Once configured, test your connection by creating a simple query:

1. Click**  +**   to create new SQL query
2. Select your newly created database
3. Write a simple query to test the connection

If the connection is working, you should see the result.

## Learn more [¶](https://www.tinybird.co/docs/forward/work-with-data/publish-data/guides/connect-superset#learn-more)

- [  ClickHouse Interface overview](../clickhouse-interface)
- [  Tinybird Auth Token management](/docs/classic/administration/auth-tokens)


