Skip to main content
ClickHouse is a fast, open-source column-oriented OLAP database designed for real-time analytical queries over large datasets. With BonData, you can connect directly to your ClickHouse database to read, enrich, and act on your data within Agent workflows.

Database Connection

BonData connects to ClickHouse over a secure interface. Both ClickHouse Cloud and self-hosted deployments are supported.

Step 1: Gather Your Connection Details

  1. Log in to the ClickHouse Cloud console
  2. Select your service and open Connect
  3. Copy the host (e.g., abc123.us-east-1.aws.clickhouse.cloud)
  4. Use port 8443 for the HTTPS interface (or 9440 for the native TLS interface)
For security, create a dedicated read-only user for BonData:

Step 3: Gather Connection Details

Collect the following information:
  • Host: Your ClickHouse server hostname
  • Port: 8443 (HTTPS) or 9440 (native TLS)
  • Database: The name of the database to connect to
  • User: The username created above
  • Password: The password for the user

Step 4: Connect in BonData

Enter your connection details in BonData to establish the connection.

Required Fields

BonData connects to ClickHouse over TLS. ClickHouse Cloud services require a secure connection; for self-hosted deployments, enable the HTTPS or native TLS port before connecting.

Available Data

Once connected, BonData can sync:
  • Tables - All tables the user has SELECT access to
  • Views - Standard views accessible to the user
  • Materialized Views - Materialized views accessible to the user
  • Custom Queries - Run custom SQL queries to extract specific data